public interface ExceptionRequest extends EventRequest
event set
containing an
ExceptionEvent
will be placed
on the EventQueue
.
The collection of existing ExceptionRequests is
managed by the EventRequestManager
ExceptionEvent
,
EventQueue
,
EventRequestManager
SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE
Modifier and Type | Method and Description |
---|---|
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.
|
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.
|
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.
|
void |
addInstanceFilter(ObjectReference instance)
Restricts the events generated by this request to those in
which the currently executing instance ("this") is the object
specified.
|
void |
addThreadFilter(ThreadReference thread)
Restricts the events generated by this request to those in
the given thread.
|
ReferenceType |
exception()
Returns exception type for which exception events are requested.
|
boolean |
notifyCaught()
Returns whether caught exceptions of the requested type
will generate events when they are thrown.
|
boolean |
notifyUncaught()
Returns whether uncaught exceptions of the requested type
will generate events when they are thrown.
|
addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy
toString, virtualMachine
ReferenceType exception()
EventRequestManager.createExceptionRequest(com.sun.jdi.ReferenceType, boolean, boolean)
, or
null if, as by default, all exceptions are requested.boolean notifyCaught()
Note that at the time an exception is thrown, it is not always
possible to determine whether it is truly caught. See
ExceptionEvent.catchLocation()
for
details.
boolean notifyUncaught()
Note that at the time an exception is thrown, it is not always
possible to determine whether it is truly uncaught. See
ExceptionEvent.catchLocation()
for
details.
void addThreadFilter(ThreadReference thread)
thread
- the thread to filter on.InvalidRequestStateException
- if this request is currently
enabled or has been deleted.
Filters may be added only to disabled requests.void addClassFilter(ReferenceType refType)
refType
- the reference type to filter on.InvalidRequestStateException
- if this request is currently
enabled or has been deleted.
Filters may be added only to disabled requests.void addClassFilter(String classPattern)
classPattern
- the pattern String to filter for.InvalidRequestStateException
- if this request is currently
enabled or has been deleted.
Filters may be added only to disabled requests.void addClassExclusionFilter(String classPattern)
classPattern
- the pattern String to filter against.InvalidRequestStateException
- if this request is currently
enabled or has been deleted.
Filters may be added only to disabled requests.void addInstanceFilter(ObjectReference instance)
Not all targets support this operation.
Use VirtualMachine.canUseInstanceFilters()
to determine if the operation is supported.
instance
- the object which must be the current instance
in order to pass this filter.UnsupportedOperationException
- if
the target virtual machine does not support this
operation.InvalidRequestStateException
- if this request is currently
enabled or has been deleted.
Filters may be added only to disabled requests.
Copyright © 1999, 2020, Oracle and/or its affiliates. All rights reserved.