Home » openjdk-7 » com.sun » jdi » request » [javadoc | source]
com.sun.jdi.request
public interface: ExceptionRequest [javadoc | source]

All Implemented Interfaces:
    EventRequest

All Known Implementing Classes:
    ExceptionRequestImpl

Request for notification when an exception occurs in the target VM. When an enabled ExceptionRequest is satisfied, an event set containing an ExceptionEvent will be placed on the EventQueue . The collection of existing ExceptionRequests is managed by the EventRequestManager
Method from com.sun.jdi.request.ExceptionRequest Summary:
addClassExclusionFilter,   addClassFilter,   addClassFilter,   addInstanceFilter,   addThreadFilter,   exception,   notifyCaught,   notifyUncaught
Method from com.sun.jdi.request.ExceptionRequest Detail:
 public  void addClassExclusionFilter(String classPattern)
    Restricts the events generated by this request to those
whose location is in a class whose name does not match a
restricted regular expression. Regular expressions are limited
to exact matches and patterns that begin with '*' or end with '*';
for example, "*.Foo" or "java.*".
 public  void addClassFilter(ReferenceType refType)
    Restricts the events generated by this request to those whose
location is in the given reference type or any of its subtypes.
An event will be generated for any location in a reference type
that can be safely cast to the given reference type.
 public  void addClassFilter(String classPattern)
    Restricts the events generated by this request to those
whose location is in a class whose name matches a restricted
regular expression. Regular expressions are limited
to exact matches and patterns that begin with '*' or end with '*';
for example, "*.Foo" or "java.*".
 public  void addInstanceFilter(ObjectReference instance)
    Restricts the events generated by this request to those in
which the currently executing instance ("this") is the object
specified.

    
Not all targets support this operation.
Use VirtualMachine#canUseInstanceFilters() 
to determine if the operation is supported.
 public  void addThreadFilter(ThreadReference thread)
    Restricts the events generated by this request to those in
the given thread.
 public ReferenceType exception()
    Returns exception type for which exception events are requested.
 public boolean notifyCaught()
    Returns whether caught exceptions of the requested type
will generate events when they are thrown.

    
Note that at the time an exception is thrown, it is not always
possible to determine whether it is truly caught. See
com.sun.jdi.event.ExceptionEvent#catchLocation  for
details.
 public boolean notifyUncaught()
    Returns whether uncaught exceptions of the requested type
will generate events when they are thrown.

    
Note that at the time an exception is thrown, it is not always
possible to determine whether it is truly uncaught. See
com.sun.jdi.event.ExceptionEvent#catchLocation  for
details.