|
Eclipse JDT 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A thread in a Java virtual machine.
Clients are not intended to implement this interface.
IThread
Field Summary | |
static int |
ERR_INCOMPATIBLE_THREAD_STATE
Status code indicating a request to perform a message send failed because a thread was not suspended by a step or breakpoint event. |
static int |
ERR_NESTED_METHOD_INVOCATION
Status code indicating a request to perform a message send failed because a thread was already performing a message send. |
static int |
ERR_THREAD_NOT_SUSPENDED
Status code indicating a request failed because a thread was not suspended. |
Method Summary | |
boolean |
canTerminateEvaluation()
Returns whether the currently executing IEvaluationRunnable
supports termination. |
IJavaVariable |
findVariable(String variableName)
Returns a variable with the given name, or null if
unable to resolve a variable with the name, or if this
thread is not currently suspended. |
IJavaObject |
getContendedMonitor()
Returns a Java object for the monitor for which this thread is currently waiting or null . |
IJavaObject[] |
getOwnedMonitors()
Returns the monitors owned by this thread or null
if this thread owns no monitors. |
String |
getThreadGroupName()
Returns the name of the thread group this thread belongs to, or null if none. |
boolean |
hasOwnedMonitors()
Returns whether this threads owns at least one monitor. |
boolean |
isOutOfSynch()
Returns whether any of the stack frames associated with this thread are running code in the VM that is out of synch with the code in the workspace. |
boolean |
isPerformingEvaluation()
Returns whether this thread is currently performing an evaluation. |
boolean |
isSystemThread()
Returns whether this thread is a system thread. |
boolean |
mayBeOutOfSynch()
Returns whether this thread may be running code in the VM that is out of synch with the code in the workspace. |
void |
queueRunnable(Runnable runnable)
Queues the given runnable with the list of runnables associated with this thread. |
void |
runEvaluation(IEvaluationRunnable evaluation,
IProgressMonitor monitor,
int evaluationDetail,
boolean hitBreakpoints)
Invokes the given evaluation with the specfied progress monitor. |
void |
terminateEvaluation()
Attempts to terminate the currently executing IEvaluationRunnable
in this thread, if any. |
Methods inherited from interface org.eclipse.debug.core.model.IThread |
getBreakpoints, getName, getPriority, getStackFrames, getTopStackFrame, hasStackFrames |
Methods inherited from interface org.eclipse.debug.core.model.IDebugElement |
getDebugTarget, getLaunch, getModelIdentifier |
Methods inherited from interface org.eclipse.core.runtime.IAdaptable |
getAdapter |
Methods inherited from interface org.eclipse.debug.core.model.ISuspendResume |
canResume, canSuspend, isSuspended, resume, suspend |
Methods inherited from interface org.eclipse.debug.core.model.IStep |
canStepInto, canStepOver, canStepReturn, isStepping, stepInto, stepOver, stepReturn |
Methods inherited from interface org.eclipse.debug.core.model.ITerminate |
canTerminate, isTerminated, terminate |
Methods inherited from interface org.eclipse.debug.core.model.IFilteredStep |
canStepWithFilters, stepWithFilters |
Field Detail |
public static final int ERR_THREAD_NOT_SUSPENDED
public static final int ERR_NESTED_METHOD_INVOCATION
IJavaObject.sendMessage(String, String, IJavaValue[], IJavaThread, boolean)
,
IJavaClassType.sendMessage(String, String, IJavaValue[], IJavaThread)
,
IJavaClassType.newInstance(String, IJavaValue[], IJavaThread)
public static final int ERR_INCOMPATIBLE_THREAD_STATE
suspend()
method, it is not able to perform
method invocations (this is a JDI limitation).IJavaObject.sendMessage(String, String, IJavaValue[], IJavaThread, boolean)
,
IJavaClassType.sendMessage(String, String, IJavaValue[], IJavaThread)
,
IJavaClassType.newInstance(String, IJavaValue[], IJavaThread)
Method Detail |
public boolean isSystemThread() throws DebugException
DebugException
- if this method fails. Reasons include:
public boolean isOutOfSynch() throws DebugException
DebugException
- if this method fails. Reasons include:
public boolean mayBeOutOfSynch() throws DebugException
DebugException
- if this method fails. Reasons include:
public boolean isPerformingEvaluation()
public String getThreadGroupName() throws DebugException
null
if none.null
if noneDebugException
- if this method fails. Reasons include:
public IJavaVariable findVariable(String variableName) throws DebugException
null
if
unable to resolve a variable with the name, or if this
thread is not currently suspended.
Variable lookup works only when a thread is suspended.
Lookup is performed in all stack frames, in a top-down
order, returning the first successful match, or null
if no match is found.
variableName
- the name of the variable to search fornull
if noneDebugException
- if this method fails. Reasons include:
public void runEvaluation(IEvaluationRunnable evaluation, IProgressMonitor monitor, int evaluationDetail, boolean hitBreakpoints) throws DebugException
evaluationDetail
(one of
DebugEvent.EVALUATION
or
DebugEvent.EVALUATION_IMPLICIT
).evaluation
- the evalation to performmonitor
- progress monitor (may be null
evaluationDetail
- one of DebugEvent.EVALUATION
or
DebugEvent.EVALUATION_IMPLICIT
hitBreakpoints
- whether or not breakpoints should be honored
in this thread during the evaluation. If false
, breakpoints
hit in this thread during the evaluation will be ignored.DebugException
- if an exception occurs performing
the evaluationpublic void queueRunnable(Runnable runnable)
runnable
- the runnable to execute.public void terminateEvaluation() throws DebugException
IEvaluationRunnable
in this thread, if any.
Evaluations may be composed of a series of instructions.
Terminating an evaluation means stopping the evaluation after
the current instruction completes. A single instruction (such as a method invocation)
cannot be interrupted.DebugException
- if an exception occurs while
terminating the evaluation.public boolean canTerminateEvaluation()
IEvaluationRunnable
supports termination. An IEvaluationRunnable supports termination
if it implements ITerminate
public IJavaObject getContendedMonitor() throws DebugException
null
.null
if this
thread is not waiting on a monitor.DebugException
- if an exception occurs while
retrieving the contended monitor.public IJavaObject[] getOwnedMonitors() throws DebugException
null
if this thread owns no monitors.DebugException
- if an exception occurs while retrieving
the owned monitors of this thread.public boolean hasOwnedMonitors() throws DebugException
DebugException
- if an exception occurs determining
if there are owned monitors.
|
Eclipse JDT 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |