OpenJDK 1.22 · com.sun.jdi.event.EventQueue · APIdia, the JavaDoc alternative

Manager of incoming debugger events for a target VM. Events are always grouped in EventSets. EventSets generated by the debugger back end can be read here. There is one instance of EventQueue assigned to a particular VirtualMachine.

Some events cause the suspension of the target VM - event requests (com.sun.jdi.request) with a suspend policy of SUSPEND_ALL or SUSPEND_EVENT_THREAD and sometimes VMStartEvent. If these suspensions are not resumed the target VM will hang. Thus, it is always good policy to remove() every EventSet from the event queue until an EventSet containing a VMDisconnectEvent is read. Unless resume is being handled in another way, each EventSet should invoke EventSet#resume().

Method Summary

Modifier and Type	Method and Description
public EventSet	Returns: the next `EventSet`. remove() Waits forever for the next available event.
public EventSet	Returns: the next `EventSet`, or null if there is a timeout. remove(long Time in milliseconds to wait for the next event timeout) Waits a specified time for the next available event.

Inherited from com.sun.jdi.Mirror:: toString virtualMachine

Method Detail

remove back to summary

remove	back to summary
public EventSet remove() throws InterruptedException Waits forever for the next available event. Returns:EventSet the next `EventSet`. Exceptions InterruptedException: if any thread has interrupted this thread. VMDisconnectedException: if the connection to the target VM is no longer available. Note this will always be preceded by a `VMDisconnectEvent`.

public EventSet remove() throws InterruptedException

Waits forever for the next available event.

Returns:EventSet

the next EventSet.

Exceptions

InterruptedException:: if any thread has interrupted this thread.
VMDisconnectedException:: if the connection to the target VM is no longer available. Note this will always be preceded by a VMDisconnectEvent.

remove back to summary

remove	back to summary
public EventSet remove(long timeout) throws InterruptedException Waits a specified time for the next available event. Parameters timeout:long Time in milliseconds to wait for the next event Returns:EventSet the next `EventSet`, or null if there is a timeout. Exceptions InterruptedException: if any thread has interrupted this thread. VMDisconnectedException: if the connection to the target VM is no longer available. Note this will always be preceded by a `VMDisconnectEvent`. IllegalArgumentException: if the timeout argument contains an illegal value.

public EventSet remove(long timeout) throws InterruptedException

Waits a specified time for the next available event.

Parameters

timeout:long: Time in milliseconds to wait for the next event

Returns:EventSet

the next EventSet, or null if there is a timeout.

Exceptions

InterruptedException:: if any thread has interrupted this thread.
VMDisconnectedException:: if the connection to the target VM is no longer available. Note this will always be preceded by a VMDisconnectEvent.
IllegalArgumentException:: if the timeout argument contains an illegal value.

public Interface EventQueue

Method Summary

Method Detail