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

public Interface BreakpointRequest

extends EventRequest, Locatable
Known Direct Implementers
com.sun.tools.jdi.EventRequestManagerImpl.BreakpointRequestImpl
Imports
com.sun.jdi.Locatable, .Location, .ObjectReference, .ThreadReference, .VirtualMachine, com.sun.jdi.event.BreakpointEvent, .EventQueue, .EventSet
Identifies a Location in the target VM at which execution should be stopped. When an enabled BreakpointRequest is satisfied, an event set containing an BreakpointEvent will be placed on the EventQueue and the application is interrupted. The collection of existing breakpoints is managed by the EventRequestManager
Author
Robert Field
Since
1.3
See Also
Location, BreakpointEvent, 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
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 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 Location

Returns:

the Location where this breakpoint has been set.
location()

Redeclares com.sun.jdi.Locatable.location.

Returns the location of the requested breakpoint.

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

Method Detail

addInstanceFilterback to summary
public void addInstanceFilter(ObjectReference instance)

Restricts the events generated by this request to those in which the currently executing instance 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
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.
locationback to summary
public Location location()

Redeclares com.sun.jdi.Locatable.location.

Returns the location of the requested breakpoint.

Returns:Location

the Location where this breakpoint has been set.