| com.sun.jdi.request |
|
com.sun.jdi.request description
This package is used to request that a JDI
event be sent under specified conditions.
With the exception of termination events, which are
always sent, there is one kind of
{@link com.sun.jdi.request.EventRequest} for each kind of
{@link com.sun.jdi.event.Event Event} - for example,
{@link com.sun.jdi.request.BreakpointRequest} is used to request a
{@link com.sun.jdi.event.BreakpointEvent BreakpointEvent}.
Event requests are created by the
{@link com.sun.jdi.request.EventRequestManager}.
Events and event processing are defined in the
{@link com.sun.jdi.event} package.
Methods may be added to the interfaces in the JDI packages in future
releases. Existing packages may be renamed if the JDI becomes a standard
extension.
|
| Java Source File Name | Type | Comment |
| AccessWatchpointRequest.java | Interface | Request for notification when the contents of a field are accessed
in the target VM.
This event will be triggered when the specified field is accessed
by JavaTM programming
language code or by a
Java Native Interface (JNI) get function (Get<Type>Field,
GetStatic<Type>Field).
Access by JDI does not trigger this event.
When an enabled AccessWatchpointRequest is satisfied, an
com.sun.jdi.event.EventSet event set containing an
com.sun.jdi.event.AccessWatchpointEvent AccessWatchpointEvent will be placed
on the
com.sun.jdi.event.EventQueue EventQueue .
The collection of existing ExceptionRequests is
managed by the
EventRequestManager The collection of existing
watchpoints is
managed by the
EventRequestManager . |
| BreakpointRequest.java | Interface | Identifies a
Location in the target VM at which
execution should be stopped. |
| ClassPrepareRequest.java | Interface | Request for notification when a class is prepared in the target VM. |
| ClassUnloadRequest.java | Interface | Request for notification when a class is unloaded in the target VM.
When an enabled ClassUnloadRequest is satisfied, a
com.sun.jdi.event.EventSet event set containing an
com.sun.jdi.event.ClassUnloadEvent ClassUnloadEvent will
be placed on the
com.sun.jdi.event.EventQueue EventQueue .
The collection of existing ClassUnloadRequests is
managed by the
EventRequestManager
Refer to the Java Virtual Machine Specification for more information
on class unloading. |
| DuplicateRequestException.java | Class | Thrown to indicate a duplicate event request. |
| EventRequest.java | Interface | Represents a request for notification of an event. |
| EventRequestManager.java | Interface | Manages the creation and deletion of
EventRequest s. |
| ExceptionRequest.java | Interface | Request for notification when an exception occurs in the target VM. |
| InvalidRequestStateException.java | Class | Thrown to indicate that the requested event cannot be modified
because it is enabled. |
| MethodEntryRequest.java | Interface | Request for notification when a method is invoked in the target VM. |
| MethodExitRequest.java | Interface | Request for notification when a method returns in the target VM. |
| ModificationWatchpointRequest.java | Interface | Request for notification when a field is set.
This event will be triggered when a value is assigned to the specified
field with a JavaTM programming
language statement (assignment, increment, etc) or by a
Java Native Interface (JNI) set function (Set<Type>Field,
SetStatic<Type>Field).
Setting a field to a value which is the same as the previous value
still triggers this event.
Modification by JDI does not trigger this event.
When an enabled
ModificationWatchpointRequest is satisfied, an
com.sun.jdi.event.EventSet event set containing a
com.sun.jdi.event.ModificationWatchpointEvent ModificationWatchpointEvent will be placed on
the
com.sun.jdi.event.EventQueue EventQueue .
The collection of existing
watchpoints is
managed by the
EventRequestManager . |
| MonitorContendedEnteredRequest.java | Interface | Request for notification of a thread in the target VM entering a monitor
after waiting for it to be released by another thread. |
| MonitorContendedEnterRequest.java | Interface | Request for notification of a thread in the target VM
attempting to enter a monitor already acquired by another thread. |
| MonitorWaitedRequest.java | Interface | Request for notification when a thread in the target VM has finished waiting on
a monitor object. |
| MonitorWaitRequest.java | Interface | Request for notification when a thread in the target VM is about to
wait on a monitor object. |
| StepRequest.java | Interface | Request for notification when a step occurs in the target VM. |
| ThreadDeathRequest.java | Interface | Request for notification when a thread terminates in the target VM. |
| ThreadStartRequest.java | Interface | Request for notification when a thread starts execution in the target VM. |
| VMDeathRequest.java | Interface | Request for notification when the target VM terminates.
When an enabled VMDeathRequest is satisfied, an
com.sun.jdi.event.EventSet event set containing a
com.sun.jdi.event.VMDeathEvent VMDeathEvent will be placed on the
com.sun.jdi.event.EventQueue EventQueue .
The collection of existing VMDeathRequests is
managed by the
EventRequestManager
Even without creating a VMDeathRequest, a single
unsolicited VMDeathEvent will be sent with a
EventRequest.suspendPolicy suspend policy
of
EventRequest.SUSPEND_NONE SUSPEND_NONE .
This request would typically be created so that a
VMDeathEvent with a suspend policy of
EventRequest.SUSPEND_ALL SUSPEND_ALL will be sent. |
| WatchpointRequest.java | Interface | Identifies a
Field in the target VM being watched. |