APIdia Launch Partner
Top Description Fields Methods
com.sun.jdi.request

public Interface MonitorWaitRequest

extends EventRequest
Known Direct Implementers
com.sun.tools.jdi.EventRequestManagerImpl.MonitorWaitRequestImpl
Imports
com.sun.jdi.ObjectReference, .ReferenceType, .ThreadReference, .VirtualMachine, com.sun.jdi.event.EventQueue, .EventSet, .MonitorWaitEvent
Request for notification when a thread in the target VM is about to wait on a monitor object. That is, a thread is entering Object.wait(). When an enabled MonitorWaitRequest is satisfied, an event set containing a MonitorWaitEvent will be placed on the EventQueue. The collection of existing MonitorWaitEvents is managed by the EventRequestManager
Author
Swamy Venkataramanappa
Since
1.6
See Also
MonitorWaitEvent, EventQueue, EventRequestManager

Field Summary

Inherited from com.sun.jdi.request.EventRequest:
SUSPEND_ALLSUSPEND_EVENT_THREADSUSPEND_NONE

Method Summary

Modifier and TypeMethod and Description
public void
addClassExclusionFilter(String
the pattern String to filter against.
classPattern)

Restricts the events generated by this request to those in which the name of the class of the monitor object does notmatch this restricted regular expression, e.g. "java.*" or "*.Foo".

public void
addClassFilter(ReferenceType
the reference type to filter on.
refType)

Restricts the events generated by this request to those whose monitor object is of 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 in which the name of the class of the monitor object matches this 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.

Inherited from com.sun.jdi.request.EventRequest:
addCountFilterdisableenablegetPropertyisEnabledputPropertysetEnabledsetSuspendPolicysuspendPolicy

Method Detail

addClassExclusionFilterback to summary
public void addClassExclusionFilter(String classPattern)

Restricts the events generated by this request to those in which the name of the class of the monitor object does notmatch this restricted regular expression, e.g. "java.*" or "*.Foo".

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.
addClassFilterback to summary
public void addClassFilter(ReferenceType refType)

Restricts the events generated by this request to those whose monitor object is of the given reference type or any of its subtypes.

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.
addClassFilterback to summary
public void addClassFilter(String classPattern)

Restricts the events generated by this request to those in which the name of the class of the monitor object matches this 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.
addInstanceFilterback 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.
addThreadFilterback 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.