27 
  28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Request for notification when a method is invoked in the target VM.
  32  * When an enabled MethodEntryRequest is satisfied, an
  33  * {@link com.sun.jdi.event.EventSet event set} containing a
  34  * {@link com.sun.jdi.event.MethodEntryEvent MethodEntryEvent}
  35  * will be placed on the
  36  * {@link com.sun.jdi.event.EventQueue EventQueue}.
  37  * The collection of existing MethodEntryRequests is
  38  * managed by the {@link EventRequestManager}
  39  *
  40  * @see com.sun.jdi.event.MethodEntryEvent
  41  * @see com.sun.jdi.event.EventQueue
  42  * @see EventRequestManager
  43  *
  44  * @author Robert Field
  45  * @since  1.3
  46  */

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

  27 
  28 import com.sun.jdi.*;
  29 
  30 /**
  31  * Request for notification when a method is invoked in the target VM.
  32  * When an enabled MethodEntryRequest is satisfied, an
  33  * {@link com.sun.jdi.event.EventSet event set} containing a
  34  * {@link com.sun.jdi.event.MethodEntryEvent MethodEntryEvent}
  35  * will be placed on the
  36  * {@link com.sun.jdi.event.EventQueue EventQueue}.
  37  * The collection of existing MethodEntryRequests is
  38  * managed by the {@link EventRequestManager}
  39  *
  40  * @see com.sun.jdi.event.MethodEntryEvent
  41  * @see com.sun.jdi.event.EventQueue
  42  * @see EventRequestManager
  43  *
  44  * @author Robert Field
  45  * @since  1.3
  46  */
  47 @jdk.Supported
  48 public interface MethodEntryRequest 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