EventSet

Class Overview

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.

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:

• Always singleton sets:
  • VMStartEvent
  • VMDisconnectEvent
• Only with other VMDeathEvents:
  • VMDeathEvent
• 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 MethodExitEvents for the same method exit:
  • MethodExitEvent
• Only with other Monitor contended enter events for the same monitor object:
  • Monitor Contended Enter Event
• Only with other Monitor contended entered events for the same monitor object:
  • Monitor Contended Entered Event
• Only with other Monitor wait events for the same monitor object:
  • Monitor Wait Event
• Only with other Monitor waited events for the same monitor object:
  • Monitor Waited Event
• Only with other members of this group, at the same location and in the same thread:
  • BreakpointEvent
  • StepEvent
  • MethodEntryEvent

Summary

[Expand] Inherited Methods
From interface com.sun.jdi.Mirror abstract String toString() Returns a String describing this mirror abstract VirtualMachine virtualMachine() Gets the VirtualMachine to which this Mirror belongs.
From interface java.lang.Iterable abstract Iterator<T> iterator() Returns an iterator over a set of elements of type T.
From interface java.util.Collection abstract boolean add(E e) Ensures that this collection contains the specified element (optional operation). abstract boolean addAll(Collection<? extends E> c) Adds all of the elements in the specified collection to this collection (optional operation). abstract void clear() Removes all of the elements from this collection (optional operation). abstract boolean contains(Object o) Returns true if this collection contains the specified element. abstract boolean containsAll(Collection<?> c) Returns true if this collection contains all of the elements in the specified collection. abstract boolean equals(Object o) Compares the specified object with this collection for equality. abstract int hashCode() Returns the hash code value for this collection. abstract boolean isEmpty() Returns true if this collection contains no elements. abstract Iterator<E> iterator() Returns an iterator over the elements in this collection. abstract boolean remove(Object o) Removes a single instance of the specified element from this collection, if it is present (optional operation). abstract boolean removeAll(Collection<?> c) Removes all of this collection's elements that are also contained in the specified collection (optional operation). abstract boolean retainAll(Collection<?> c) Retains only the elements in this collection that are contained in the specified collection (optional operation). abstract int size() Returns the number of elements in this collection. abstract <T> T[] toArray(T[] a) Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array. abstract Object[] toArray() Returns an array containing all of the elements in this collection.
From interface java.util.Set abstract boolean add(E e) Adds the specified element to this set if it is not already present (optional operation). abstract boolean addAll(Collection<? extends E> c) Adds all of the elements in the specified collection to this set if they're not already present (optional operation). abstract void clear() Removes all of the elements from this set (optional operation). abstract boolean contains(Object o) Returns true if this set contains the specified element. abstract boolean containsAll(Collection<?> c) Returns true if this set contains all of the elements of the specified collection. abstract boolean equals(Object o) Compares the specified object with this set for equality. abstract int hashCode() Returns the hash code value for this set. abstract boolean isEmpty() Returns true if this set contains no elements. abstract Iterator<E> iterator() Returns an iterator over the elements in this set. abstract boolean remove(Object o) Removes the specified element from this set if it is present (optional operation). abstract boolean removeAll(Collection<?> c) Removes from this set all of its elements that are contained in the specified collection (optional operation). abstract boolean retainAll(Collection<?> c) Retains only the elements in this set that are contained in the specified collection (optional operation). abstract int size() Returns the number of elements in this set (its cardinality). abstract <T> T[] toArray(T[] a) Returns an array containing all of the elements in this set; the runtime type of the returned array is that of the specified array. abstract Object[] toArray() Returns an array containing all of the elements in this set.