com.sun.jdi.request (Java Debug Interface )
Keywords: com.sun.jdi.request package
Date: 2015-11-19

@Exported

# Package com.sun.jdi.request

This package is used to request that a JDI event be sent under specified conditions.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  AccessWatchpointRequest | Request for notification when the contents of a field are accessed in the target VM.
  BreakpointRequest | Identifies a `Location` in the target VM at which execution should be stopped.
  ClassPrepareRequest | Request for notification when a class is prepared in the target VM.
  ClassUnloadRequest | Request for notification when a class is unloaded in the target VM.
  EventRequest | Represents a request for notification of an event.
  EventRequestManager | Manages the creation and deletion of `EventRequest`s.
  ExceptionRequest | Request for notification when an exception occurs in the target VM.
  MethodEntryRequest | Request for notification when a method is invoked in the target VM.
  MethodExitRequest | Request for notification when a method returns in the target VM.
  ModificationWatchpointRequest | Request for notification when a field is set.
  MonitorContendedEnteredRequest | Request for notification of a thread in the target VM entering a monitor after waiting for it to be released by another thread.
  MonitorContendedEnterRequest | Request for notification of a thread in the target VM attempting to enter a monitor already acquired by another thread.
  MonitorWaitedRequest | Request for notification when a thread in the target VM has finished waiting on a monitor object.
  MonitorWaitRequest | Request for notification when a thread in the target VM is about to wait on a monitor object.
  StepRequest | Request for notification when a step occurs in the target VM.
  ThreadDeathRequest | Request for notification when a thread terminates in the target VM.
  ThreadStartRequest | Request for notification when a thread starts execution in the target VM.
  VMDeathRequest | Request for notification when the target VM terminates.
  WatchpointRequest | Identifies a `Field` in the target VM being watched.

- Exception Summary
  Exception | Description
  --- | ---
  DuplicateRequestException | Thrown to indicate a duplicate event request.
  InvalidRequestStateException | Thrown to indicate that the requested event cannot be modified because it is enabled.

## Package 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 `EventRequest` for each kind of `Event` - for example, `BreakpointRequest` is used to request a `BreakpointEvent`. Event requests are created by the `EventRequestManager`. Events and event processing are defined in the `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.

Copyright © 1999, 2015, Oracle and/or its affiliates. All rights reserved.