OpenJDK 1.22 · com.sun.jdi.request.ExceptionRequest

Method Summary

Modifier and Type	Method and Description
public void	addClassExclusionFilter(String the pattern String to filter against. 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.
public void	addClassFilter(ReferenceType the reference type to filter on. refType) Restricts the events generated by this request to those whose location is in the given reference type or any of its subtypes.
public void	addClassFilter(String the pattern String to filter for. classPattern) Restricts the events generated by this request to those whose location is in a class whose name matches a restricted regular expression.
public void	addInstanceFilter(ObjectReference the object which must be the current instance in order to pass this filter. instance) Restricts the events generated by this request to those in which the currently executing instance ("this") is the object specified.
public void	addThreadFilter(ThreadReference the thread to filter on. thread) Restricts the events generated by this request to those in the given thread.
public ReferenceType	Returns: The exception (and its subclasses) requested with `EventRequestManager#createExceptionRequest`, or null if, as by default, all exceptions are requested. exception() Returns exception type for which exception events are requested.
public boolean	Returns: boolean true if caught exceptions will be reported, false otherwise. notifyCaught() Returns whether caught exceptions of the requested type will generate events when they are thrown.
public boolean	Returns: boolean true if caught exceptions will be reported, false otherwise. notifyUncaught() Returns whether uncaught exceptions of the requested type will generate events when they are thrown.

Inherited from com.sun.jdi.request.EventRequest:: addCountFilter disable enable getProperty isEnabled putProperty setEnabled setSuspendPolicy suspendPolicy

Method Detail

addClassExclusionFilter	back to summary
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.". Parameters classPattern:String the pattern String to filter against. Exceptions InvalidRequestStateException: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addClassExclusionFilter

back to summary

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.*".

Parameters

classPattern:String: the pattern String to filter against.

Exceptions

InvalidRequestStateException:: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addClassFilter	back to summary
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. Parameters refType:ReferenceType the reference type to filter on. Exceptions InvalidRequestStateException: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addClassFilter

back to summary

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.

Parameters

refType:ReferenceType: the reference type to filter on.

Exceptions

InvalidRequestStateException:: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addClassFilter	back to summary
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.". Parameters classPattern:String the pattern String to filter for. Exceptions InvalidRequestStateException: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addClassFilter

back to summary

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.*".

Parameters

classPattern:String: the pattern String to filter for.

Exceptions

InvalidRequestStateException:: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addInstanceFilter back to summary

addInstanceFilter	back to summary
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. Parameters instance:ObjectReference the object which must be the current instance in order to pass this filter. Exceptions 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. Since 1.4

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.

Parameters

instance:ObjectReference: the object which must be the current instance in order to pass this filter.

Exceptions

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.

Since

1.4

addThreadFilter	back to summary
public void addThreadFilter(ThreadReference thread) Restricts the events generated by this request to those in the given thread. Parameters thread:ThreadReference the thread to filter on. Exceptions InvalidRequestStateException: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

addThreadFilter

back to summary

public void addThreadFilter(ThreadReference thread)

Restricts the events generated by this request to those in the given thread.

Parameters

thread:ThreadReference: the thread to filter on.

Exceptions

InvalidRequestStateException:: if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

exception back to summary

exception	back to summary
public ReferenceType exception() Returns exception type for which exception events are requested. Returns:ReferenceType The exception (and its subclasses) requested with `EventRequestManager#createExceptionRequest`, or null if, as by default, all exceptions are requested.

public ReferenceType exception()

Returns exception type for which exception events are requested.

Returns:ReferenceType: The exception (and its subclasses) requested with EventRequestManager#createExceptionRequest, or null if, as by default, all exceptions are requested.

notifyCaught back to summary

notifyCaught	back to summary
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 `ExceptionEvent#catchLocation` for details. Returns:boolean boolean true if caught exceptions will be reported, false otherwise.

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 ExceptionEvent#catchLocation for details.

Returns:boolean: boolean true if caught exceptions will be reported, false otherwise.

notifyUncaught back to summary

notifyUncaught	back to summary
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 `ExceptionEvent#catchLocation` for details. Returns:boolean boolean true if caught exceptions will be reported, false otherwise.

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 ExceptionEvent#catchLocation for details.

Returns:boolean: boolean true if caught exceptions will be reported, false otherwise.

public Interface ExceptionRequest

Field Summary

Method Summary

Method Detail