- All Superinterfaces:
public interface EventQueue extends MirrorManager 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
Some events cause the suspension of the target VM - event requests (
com.sun.jdi.request) with a
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
VMDisconnectEventis read. Unless
resumeis being handled in another way, each EventSet should invoke
EventSet remove() throws InterruptedExceptionWaits forever for the next available event.
EventSet remove(long timeout) throws InterruptedExceptionWaits a specified time for the next available event.
timeout- Time in milliseconds to wait for the next event
- the next
EventSet, or null if there is a timeout.
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
IllegalArgumentException- if the timeout argument contains an illegal value.