|
" 2013 FRC Java API " |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.sun.squawk.debugger.EventRequest
public abstract class EventRequest
An EventRequest
instance is used register a request for notification
of a particular event on behalf of a debugger.
Events are requested by the debugger client, which also sends an event request ID. This ID is used to enable the
debugger to clear event requests.
Events can be be filtered on the VM so that only certian class load events, or method entry events (etc) are actually
sent to the debugger client. These filters are described as "modifiers" in the event request, and are modelled by
the Modifier
class.
Field Summary | |
---|---|
int |
id
Used by debugger to cancel requests. |
int |
kind
The JDWP.EventKind constant for the event being monitored. |
EventRequestModifier[] |
modifiers
List of modifiers that filter out certain events. |
int |
suspendPolicy
Should the current thread, all (isolate) threads, or no threads be suspended when the event occurs. |
Constructor Summary | |
---|---|
protected |
EventRequest(int kind,
int suspendPolicy)
Creates an EventRequest . |
protected |
EventRequest(int id,
PacketInputStream in,
int kind)
Creates an EventRequest based on the data read from a JDWP packet. |
Method Summary | |
---|---|
void |
cleared()
Does any event specific clearing after it has been de-registered from an event manager. |
static String |
getNameForJDWPEventKind(int eventKind)
Gets the name string corresponding to a given JDWP.EventKind constant. |
static String |
getNameForJDWPSuspendPolicy(int policy)
Gets the name string corresponding to a given JDWP.SuspendPolicy constant. |
boolean |
matchKind(int eventKind)
Determines if this request may match events of a given kind. |
boolean |
matchModifiers(EventRequestModifier.Matcher matcher,
Debugger.Event event)
Determines if all the modifiers of this request match a given event. |
protected EventRequestModifier |
readModifier(PacketInputStream in,
int kind)
Creates a EventRequestModifier from a given PacketInputStream . |
void |
registered()
Does any event specific setup after it has been registered with an event manager. |
String |
toString()
Returns a string representation of the object. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public final int kind
JDWP.EventKind
constant for the event being monitored.
public final int suspendPolicy
public final int id
public final EventRequestModifier[] modifiers
Constructor Detail |
---|
protected EventRequest(int kind, int suspendPolicy)
EventRequest
.
kind
- the JDWP.EventKind
to createsuspendPolicy
- the suspend policy to useprotected EventRequest(int id, PacketInputStream in, int kind) throws SDWPException, IOException
EventRequest
based on the data read from a JDWP packet.
in
- the PacketInputStream
to read the request details fromvm
- the VM being debuggedkind
- the JDWP.EventKind
to create
SDWPException
- if the request is invalid
IOException
- if there was an IO error reading the requestMethod Detail |
---|
public boolean matchKind(int eventKind)
eventKind
- the event kind to query
eventKind
eventspublic boolean matchModifiers(EventRequestModifier.Matcher matcher, Debugger.Event event)
event
- the details and thread context of the event
public void registered()
vm
- the VM being debuggedpublic void cleared()
vm
- the VM being debuggedprotected EventRequestModifier readModifier(PacketInputStream in, int kind) throws SDWPException, IOException
PacketInputStream
.
in
- the PacketInputStreamkind
- the kind of event request object that the modifier applies to
SDWPException
- if the data read from in
is invalid or not well formed
IOException
- if there is an IO error reading from in
public static String getNameForJDWPEventKind(int eventKind)
JDWP.EventKind
constant.
eventKind
- the constant to translate
public static String getNameForJDWPSuspendPolicy(int policy)
JDWP.SuspendPolicy
constant.
policy
- the JDWP.SuspendPolicy
to translate
public String toString()
toString
method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@
', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
toString
in class Object
|
" 2013 FRC Java API " |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |