61  * Filters can dramatically improve debugger performance by reducing the
  62  * amount of event traffic sent from the target VM to the debugger VM.
  63  * <p>
  64  * Any method on <code>EventRequest</code> which
  65  * takes <code>EventRequest</code> as an parameter may throw
  66  * {@link com.sun.jdi.VMDisconnectedException} if the target VM is
  67  * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is
  68  * available to be read from the {@link com.sun.jdi.event.EventQueue}.
  69  * <p>
  70  * Any method on <code>EventRequest</code> which
  71  * takes <code>EventRequest</code> as an parameter may throw
  72  * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory.
  73  *
  74  * @see com.sun.jdi.event.BreakpointEvent
  75  * @see com.sun.jdi.event.EventQueue
  76  * @see EventRequestManager
  77  *
  78  * @author Robert Field
  79  * @since  1.3
  80  */

  81 public interface EventRequest extends Mirror {
  82 
  83     /**
  84      * Determines if this event request is currently enabled.
  85      *
  86      * @return <code>true</code> if enabled;
  87      * <code>false</code> otherwise.
  88      */
  89     boolean isEnabled();
  90 
  91     /**
  92      * Enables or disables this event request. While this event request is
  93      * disabled, the event request will be ignored and the target VM
  94      * will not be stopped if any of its threads reaches the
  95      * event request.  Disabled event requests still exist,
  96      * and are included in event request lists such as
  97      * {@link EventRequestManager#breakpointRequests()}.
  98      *
  99      * @param val <code>true</code> if the event request is to be enabled;
 100      * <code>false</code> otherwise.

  61  * Filters can dramatically improve debugger performance by reducing the
  62  * amount of event traffic sent from the target VM to the debugger VM.
  63  * <p>
  64  * Any method on <code>EventRequest</code> which
  65  * takes <code>EventRequest</code> as an parameter may throw
  66  * {@link com.sun.jdi.VMDisconnectedException} if the target VM is
  67  * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is
  68  * available to be read from the {@link com.sun.jdi.event.EventQueue}.
  69  * <p>
  70  * Any method on <code>EventRequest</code> which
  71  * takes <code>EventRequest</code> as an parameter may throw
  72  * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory.
  73  *
  74  * @see com.sun.jdi.event.BreakpointEvent
  75  * @see com.sun.jdi.event.EventQueue
  76  * @see EventRequestManager
  77  *
  78  * @author Robert Field
  79  * @since  1.3
  80  */
  81 @jdk.Supported
  82 public interface EventRequest extends Mirror {
  83 
  84     /**
  85      * Determines if this event request is currently enabled.
  86      *
  87      * @return <code>true</code> if enabled;
  88      * <code>false</code> otherwise.
  89      */
  90     boolean isEnabled();
  91 
  92     /**
  93      * Enables or disables this event request. While this event request is
  94      * disabled, the event request will be ignored and the target VM
  95      * will not be stopped if any of its threads reaches the
  96      * event request.  Disabled event requests still exist,
  97      * and are included in event request lists such as
  98      * {@link EventRequestManager#breakpointRequests()}.
  99      *
 100      * @param val <code>true</code> if the event request is to be enabled;
 101      * <code>false</code> otherwise.