27 
  28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Notification of an exception in the target VM. When an exception
  32  * is thrown which satisfies a currently enabled
  33  * {@link com.sun.jdi.request.ExceptionRequest exception request},
  34  * an {@link EventSet event set}
  35  * containing an instance of this class will be added
  36  * to the VM's event queue.
  37  * If the exception is thrown from a non-native method,
  38  * the exception event is generated at the location where the
  39  * exception is thrown.
  40  * If the exception is thrown from a native method, the exception event
  41  * is generated at the first non-native location reached after the exception
  42  * is thrown.
  43  *
  44  * @author Robert Field
  45  * @since  1.3
  46  */

  47 public interface ExceptionEvent extends LocatableEvent {
  48 
  49     /**
  50      * Gets the thrown exception object. The exception object is
  51      * an instance of {@link java.lang.Throwable} or a subclass in the
  52      * target VM.
  53      *
  54      * @return an {@link ObjectReference} which mirrors the thrown object in
  55      * the target VM.
  56      */
  57     public ObjectReference exception();
  58 
  59     /**
  60      * Gets the location where the exception will be caught. An exception
  61      * is considered to be caught if, at the point of the throw, the
  62      * current location is dynamically enclosed in a try statement that
  63      * handles the exception. (See the JVM specification for details).
  64      * If there is such a try statement, the catch location is the
  65      * first code index of the appropriate catch clause.
  66      * <p>

  27 
  28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Notification of an exception in the target VM. When an exception
  32  * is thrown which satisfies a currently enabled
  33  * {@link com.sun.jdi.request.ExceptionRequest exception request},
  34  * an {@link EventSet event set}
  35  * containing an instance of this class will be added
  36  * to the VM's event queue.
  37  * If the exception is thrown from a non-native method,
  38  * the exception event is generated at the location where the
  39  * exception is thrown.
  40  * If the exception is thrown from a native method, the exception event
  41  * is generated at the first non-native location reached after the exception
  42  * is thrown.
  43  *
  44  * @author Robert Field
  45  * @since  1.3
  46  */
  47 @jdk.Supported
  48 public interface ExceptionEvent extends LocatableEvent {
  49 
  50     /**
  51      * Gets the thrown exception object. The exception object is
  52      * an instance of {@link java.lang.Throwable} or a subclass in the
  53      * target VM.
  54      *
  55      * @return an {@link ObjectReference} which mirrors the thrown object in
  56      * the target VM.
  57      */
  58     public ObjectReference exception();
  59 
  60     /**
  61      * Gets the location where the exception will be caught. An exception
  62      * is considered to be caught if, at the point of the throw, the
  63      * current location is dynamically enclosed in a try statement that
  64      * handles the exception. (See the JVM specification for details).
  65      * If there is such a try statement, the catch location is the
  66      * first code index of the appropriate catch clause.
  67      * <p>