oracle.jbo.script.debug.client.event
Class ExceptionEventSet

java.lang.Object
  java.util.EventObject
      oracle.jbo.script.debug.client.event.AbstractEventSet
          oracle.jbo.script.debug.client.event.LocatableEventSet
              oracle.jbo.script.debug.client.event.ExceptionEventSet

All Implemented Interfaces:

com.sun.jdi.event.EventSet, com.sun.jdi.Mirror, java.io.Serializable, java.lang.Iterable<com.sun.jdi.event.Event>, java.util.Collection<com.sun.jdi.event.Event>, java.util.Set<com.sun.jdi.event.Event>

public class ExceptionEventSet
extends LocatableEventSet

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Method Summary

com.sun.jdi.Location	getCatchLocation() Gets the location where the exception will be caught.
com.sun.jdi.ObjectReference	getException() Gets the thrown exception object.
void	notify(JDIListener listener)

Methods inherited from class oracle.jbo.script.debug.client.event.LocatableEventSet

getLocation, getThread

Methods inherited from class oracle.jbo.script.debug.client.event.AbstractEventSet

add, addAll, clear, contains, containsAll, eventIterator, getSuspendPolicy, getVirtualMachine, isEmpty, iterator, remove, removeAll, resume, retainAll, size, suspendedAll, suspendedEventThread, suspendedNone, suspendPolicy, toArray, toArray, toSpecificEventSet, virtualMachine

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.sun.jdi.Mirror

toString

Methods inherited from interface java.util.Set

equals, hashCode

Method Detail

getException

public com.sun.jdi.ObjectReference getException()

Gets the thrown exception object. The exception object is an instance of java.lang.Throwable or a subclass in the target VM.

Returns:

an ObjectReference which mirrors the thrown object in the target VM.

getCatchLocation

public com.sun.jdi.Location getCatchLocation()

Gets the location where the exception will be caught. An exception is considered to be caught if, at the point of the throw, the current location is dynamically enclosed in a try statement that handles the exception. (See the JVM specification for details). If there is such a try statement, the catch location is the first code index of the appropriate catch clause.

If there are native methods in the call stack at the time of the exception, there are important restrictions to note about the returned catch location. In such cases, it is not possible to predict whether an exception will be handled by some native method on the call stack. Thus, it is possible that exceptions considered uncaught here will, in fact, be handled by a native method and not cause termination of the target VM. Also, it cannot be assumed that the catch location returned here will ever be reached by the throwing thread. If there is a native frame between the current location and the catch location, the exception might be handled and cleared in that native method instead.

Returns:

the Location where the exception will be caught or null if the exception is uncaught.

notify

public void notify(JDIListener listener)

Specified by:

notify in class AbstractEventSet