|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.util.EventObject | +--org.eclipse.debug.core.DebugEvent
A debug event describes an event in a program being debugged or in a running process. Debug models and process implementations are required to generate debug events as specified by this class.
The following list defines the events generated for each debug
model element.
The getSource()
method of a debug event
returns the element associated with the event.
Creation events are guaranteed to occur in a top
down order - that is, parents are created before children.
Termination events are guaranteed to occur in a bottom up order -
that is, children before parents. However, termination events are not guaranteed
for all elements that are created. That is, terminate events can be coalesced - a
terminate event for a parent signals that all children have been terminated.
The generic CHANGE
event can be fired at any time by any element.
Generally, a client of a debug model, such as as a UI, can get sufficient
information to update by listening/responding to the other event kinds. However,
if a debug model needs to inform clients of a change that is not specified
by create/terminate/suspend/resume, the CHANGE
event may be used.
For example, generally, the only way a thread or any of its children can change
state between a suspend and resume operation, is if the thread or owning debug
target is terminated. However, if a debug model supports some other operation
that would allow a debug element to change state while suspended, the debug model
would fire a change event for that element. The valid detail codes for a
change event are:
STATE
- indicates the state of an element has changed, but its
children are not affected. A client would use a state change event to update
a label of the affected element, but would not update any children.CONTENT
- indicates that a debug element's value or contents have
changed in some way. For example, when the value of a variable is changed
explicitly, the variable should fire a content change event.IProcess
CREATE
- a process has been created and is executing.TERMINATE
- a process has terminated.IDebugTarget
CREATE
- a debug target has been created and is ready
to begin a debug session.TERMINATE
- a debug target has terminated and the debug
session has ended.SUSPEND
- a debug target has suspended. Event detail provides
the reason for the suspension:STEP_END
- a request to step has completedBREAKPOINT
- a breakpoint has been hitCLIENT_REQUEST
- a client request has caused the target to suspend
(i.e. an explicit call to suspend()
)UNSPECIFIED
- the reason for the suspend is not specifiedRESUME
- a debug target has resumed. Event detail provides
the reason for the resume:STEP_INTO
- a target is being resumed because of a request to step intoSTEP_OVER
- a target is being resumed because of a request to step overSTEP_RETURN
- a target is being resumed because of a request to step returnCLIENT_REQUEST
- a client request has caused the target to be resumed
(i.e. an explicit call to resume()
)UNSPECIFIED
- The reason for the resume is not specifiedIThread
CREATE
- a thread has been created in a debug target.TERMINATE
- a thread has terminated.SUSPEND
- a thread has suspended execution. Event detail provides
the reason for the suspension:STEP_END
- a request to step has completedBREAKPOINT
- a breakpoint has been hitCLIENT_REQUEST
- a client request has caused the thread to suspend
(i.e. an explicit call to suspend()
)EVALUATION
- an expression evaluation has ended that may
have had side effects in the debug target.EVALUATION_IMPLICIT
- an expression evaluation has ended that
had no side effects in the debug target.UNSPECIFIED
- the reason for the suspend is not specifiedRESUME
- a thread has resumed execution. Event detail provides
the reason for the resume:STEP_INTO
- a thread is being resumed because of a request to step intoSTEP_OVER
- a thread is being resumed because of a request to step overSTEP_RETURN
- a thread is being resumed because of a request to step returnCLIENT_REQUEST
- a client request has caused the thread to be resumed
(i.e. an explicit call to resume()
)EVALUATION
- an expression evaluation has started that may
have side effects in the debug target.EVALUATION_IMPLICIT
- an expression evaluation has started that
will have no side effects in the debug target.UNSPECIFIED
- The reason for the resume is not specifiedIStackFrame
- no events are specified for stack frames.
When a thread is suspended, it has stack frames. When a thread resumes,
stack frames are unavailable.
IVariable
- no events are specified for variables.
When a thread is suspended, stack frames have variables. When a thread resumes,
variables are unavailable.
IValue
- no events are specified for values.
Clients may instantiate this class. Clients are not intended to subclass this class.
Field Summary | |
static int |
BREAKPOINT
Breakpoint detail. |
static int |
CHANGE
Change event kind. |
static int |
CLIENT_REQUEST
Client request detail. |
static int |
CONTENT
Content change detail. |
static int |
CREATE
Create event kind. |
static int |
EVALUATION
Evaluation detail. |
static int |
EVALUATION_IMPLICIT
Evaluation detail. |
static int |
RESUME
Resume event kind. |
static int |
STATE
State change detail. |
static int |
STEP_END
Step end detail. |
static int |
STEP_INTO
Step start detail. |
static int |
STEP_OVER
Step start detail. |
static int |
STEP_RETURN
Step start detail. |
static int |
SUSPEND
Suspend event kind. |
static int |
TERMINATE
Terminate event kind. |
static int |
UNSPECIFIED
Constant indicating that the kind or detail of a debug event is unspecified. |
Fields inherited from class java.util.EventObject |
source |
Constructor Summary | |
DebugEvent(Object eventSource,
int kind)
Constructs a new debug event of the given kind with a detail code of UNSPECIFIED . |
|
DebugEvent(Object eventSource,
int kind,
int detail)
Constructs a new debug event of the given kind with the given detail. |
Method Summary | |
int |
getDetail()
Returns a constant describing extra detail about the event - one of the detail constants defined by this class, possibly UNSPECIFIED . |
int |
getKind()
Returns this event's kind - one of the kind constants defined by this class. |
boolean |
isEvaluation()
Returns whether this event's detail indicates an evaluation. |
boolean |
isStepStart()
Returns whether this event's detail indicates the beginning of a step event. |
String |
toString()
|
Methods inherited from class java.util.EventObject |
getSource |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final int RESUME
public static final int SUSPEND
public static final int CREATE
public static final int TERMINATE
public static final int CHANGE
public static final int STEP_INTO
public static final int STEP_OVER
public static final int STEP_RETURN
public static final int STEP_END
public static final int BREAKPOINT
public static final int CLIENT_REQUEST
public static final int EVALUATION
public static final int EVALUATION_IMPLICIT
public static final int STATE
CHANGE
events.
public static final int CONTENT
CHANGE
events.
public static final int UNSPECIFIED
Constructor Detail |
public DebugEvent(Object eventSource, int kind)
UNSPECIFIED
.
eventSource
- the object associated with the eventkind
- the kind of debug event (one of the
kind constants defined by this class)public DebugEvent(Object eventSource, int kind, int detail)
eventSource
- the object associated with the eventkind
- the kind of debug event (one of the
kind constants defined by this class)detail
- extra information about the event (one of the
detail constants defined by this class)Method Detail |
public int getDetail()
UNSPECIFIED
.
public int getKind()
public boolean isStepStart()
STEP_INTO
, STEP_OVER
, or
STEP_RETURN
.
public boolean isEvaluation()
EVALUATION
, or EVALUATION_IMPLICIT
.
public String toString()
toString
in class EventObject
Object.toString()
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |