public interface EventSet extends Mirror, Set<Event>
Event
objects may be created at a given time by
the target VirtualMachine
. For example, there may be
more than one BreakpointRequest
for a given Location
or you might single step to the same location as a
BreakpointRequest. These Event
objects are delivered
together as an EventSet. For uniformity, an EventSet is always used
to deliver Event
objects. EventSets are delivered by
the EventQueue
.
EventSets are unmodifiable.
Associated with the issuance of an event set, suspensions may
have occurred in the target VM. These suspensions correspond
with the suspend policy
.
To assure matching resumes occur, it is recommended,
where possible,
to complete the processing of an event set with
EventSet.resume()
.
The events that are grouped in an EventSet are restricted in the following ways:
Event
,
EventQueue
Modifier and Type | Method and Description |
---|---|
EventIterator |
eventIterator()
Return an iterator specific to
Event objects. |
void |
resume()
Resumes threads suspended by this event set.
|
int |
suspendPolicy()
Returns the policy used to suspend threads in the target VM
for this event set.
|
toString, virtualMachine
int suspendPolicy()
EventRequest
for the possible
policy values.
In rare cases, the suspend policy may differ from the requested
value if a ClassPrepareEvent
has occurred in a
debugger system thread. See ClassPrepareEvent.thread()
for details.
SUSPEND_ALL
,
SUSPEND_EVENT_THREAD
or
SUSPEND_NONE
.EventIterator eventIterator()
Event
objects.void resume()
suspendPolicy()
is EventRequest.SUSPEND_ALL
, a call
to this method is equivalent to
VirtualMachine.resume()
. If the
suspend policy is
EventRequest.SUSPEND_EVENT_THREAD
,
a call to this method is equivalent to
ThreadReference.resume()
for the event thread.
Otherwise, a call to this method is a no-op.
Copyright © 1999, 2020, Oracle and/or its affiliates. All rights reserved.