public interface

EventQueue

implements Mirror
com.sun.jdi.event.EventQueue
Known Indirect Subclasses

Class Overview

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 resume().

See Also

Summary

Public Methods
abstract EventSet remove()
Waits forever for the next available event.
abstract EventSet remove(long timeout)
Waits a specified time for the next available event.
[Expand]
Inherited Methods
From interface com.sun.jdi.Mirror

Public Methods

public abstract EventSet remove ()

Waits forever for the next available event.

Returns
Throws
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 abstract EventSet remove (long timeout)

Waits a specified time for the next available event.

Parameters
timeout Time in milliseconds to wait for the next event
Returns
  • the next EventSet, or null if there is a timeout.
Throws
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.