com.sun.jdi.request (Java SE 13 & JDK 13 )
Description: declaration: module: jdk.jdi, package: com.sun.jdi.request
Keywords: com.sun.jdi.request package

Module jdk.jdi

# Package com.sun.jdi.request

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.

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