28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Request for notification of a thread in the target VM
  32  * attempting to enter a monitor already acquired by another thread.
  33  * When an enabled MonitorContededEnterRequest is satisfied, an
  34  * {@link com.sun.jdi.event.EventSet event set} containing a
  35  * {@link com.sun.jdi.event.MonitorContendedEnterEvent MonitorContendedEnterEvent}
  36  * will be placed on the
  37  * {@link com.sun.jdi.event.EventQueue EventQueue}.
  38  * The collection of existing MonitorContendedEnterEvents is
  39  * managed by the {@link EventRequestManager}
  40  *
  41  * @see com.sun.jdi.event.MonitorContendedEnterEvent
  42  * @see com.sun.jdi.event.EventQueue
  43  * @see EventRequestManager
  44  *
  45  * @author Swamy Venkataramanappa
  46  * @since  1.6
  47  */

  48 public interface MonitorContendedEnterRequest extends EventRequest {
  49 
  50     /**
  51      * Restricts the events generated by this request to those in
  52      * the given thread.
  53      * @param thread the thread to filter on.
  54      * @throws InvalidRequestStateException if this request is currently
  55      * enabled or has been deleted.
  56      * Filters may be added only to disabled requests.
  57      */
  58     void addThreadFilter(ThreadReference thread);
  59 
  60     /**
  61      * Restricts the events generated by this request to those whose
  62      * method is in the given reference type or any of its subtypes.
  63      * An event will be generated for any location in a reference type
  64      * that can be safely cast to the given reference type.
  65      *
  66      * @param refType the reference type to filter on.
  67      * @throws InvalidRequestStateException if this request is currently

  28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Request for notification of a thread in the target VM
  32  * attempting to enter a monitor already acquired by another thread.
  33  * When an enabled MonitorContededEnterRequest is satisfied, an
  34  * {@link com.sun.jdi.event.EventSet event set} containing a
  35  * {@link com.sun.jdi.event.MonitorContendedEnterEvent MonitorContendedEnterEvent}
  36  * will be placed on the
  37  * {@link com.sun.jdi.event.EventQueue EventQueue}.
  38  * The collection of existing MonitorContendedEnterEvents is
  39  * managed by the {@link EventRequestManager}
  40  *
  41  * @see com.sun.jdi.event.MonitorContendedEnterEvent
  42  * @see com.sun.jdi.event.EventQueue
  43  * @see EventRequestManager
  44  *
  45  * @author Swamy Venkataramanappa
  46  * @since  1.6
  47  */
  48 @jdk.Supported
  49 public interface MonitorContendedEnterRequest extends EventRequest {
  50 
  51     /**
  52      * Restricts the events generated by this request to those in
  53      * the given thread.
  54      * @param thread the thread to filter on.
  55      * @throws InvalidRequestStateException if this request is currently
  56      * enabled or has been deleted.
  57      * Filters may be added only to disabled requests.
  58      */
  59     void addThreadFilter(ThreadReference thread);
  60 
  61     /**
  62      * Restricts the events generated by this request to those whose
  63      * method is in the given reference type or any of its subtypes.
  64      * An event will be generated for any location in a reference type
  65      * that can be safely cast to the given reference type.
  66      *
  67      * @param refType the reference type to filter on.
  68      * @throws InvalidRequestStateException if this request is currently