com.sun.jdi.event
Interface EventSet

All Superinterfaces:

Collection, Mirror, Set

public interface EventSet

extends Mirror, Set

Several 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.

The event that are grouped in an EventSet are restricted in the following ways:

• Always singleton sets:
  • VMStartEvent
  • VMDeathEvent
  • VMDisconnectEvent
• Only with other ThreadStartEvents for the same thread:
  • ThreadStartEvent
• Only with other ThreadDeathEvents for the same thread:
  • ThreadDeathEvent
• Only with other ClassPrepareEvents for the same class:
  • ClassPrepareEvent
• Only with other ClassUnloadEvents for the same class:
  • ClassUnloadEvent
• Only with other AccessWatchpointEvents for the same field access:
  • AccessWatchpointEvent
• Only with other ModificationWatchpointEvents for the same field modification:
  • ModificationWatchpointEvent
• Only with other ExceptionEvents for the same exception occurrance:
  • ExceptionEvent
• Only with other members of this group, at the same location and in the same thread:
  • BreakpointEvent
  • StepEvent
  • MethodEntryEvent
  • MethodExitEvent

Since:

1.3

See Also:

Event, EventQueue

Method Summary

EventIterator	eventIterator() Return an iterator specific to Event objects.
void	resume()
int	suspendPolicy() Returns the policy used to suspend threads in the target VM for this event set.

Methods inherited from interface com.sun.jdi.Mirror

toString, virtualMachine

Methods inherited from interface java.util.Set

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Method Detail

suspendPolicy

public int suspendPolicy()

Returns the policy used to suspend threads in the target VM for this event set. This policy is selected from the suspend policies for each event's request. The one that suspends the most threads is chosen when the event occurs in the target VM and that policy is returned here. See 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.

Returns:

the integer suspendPolicy

eventIterator

public EventIterator eventIterator()

Return an iterator specific to Event objects.

resume

public void resume()