| org.eclipse.jdt.debug.core.IJavaThread
All known Subclasses: org.eclipse.jdt.internal.debug.core.model.JDIThread,
| IJavaThread | | public interface IJavaThread extends IThread,IFilteredStep(Code) | | A thread in a Java virtual machine.
Clients are not intended to implement this interface.
See Also: org.eclipse.debug.core.model.IThread |
| Field Summary | |
| final public 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. | | final public 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. | | final public static int | ERR_THREAD_NOT_SUSPENDED
Status code indicating a request failed because a thread
was not suspended. |
| Method Summary | |
| public 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.
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.
Parameters:
variableName - the name of the variable to search for a variable, or null if none
exception:
DebugException - if this method fails. | | public IJavaObject | getContendedMonitor()
Returns a Java object for the monitor for
which this thread is currently waiting or null. | | public int | getFrameCount()
Returns the number of frames in this thread. | | public IJavaObject[] | getOwnedMonitors()
Returns the monitors owned by this thread or null
if this thread owns no monitors. | | public IJavaThreadGroup | getThreadGroup()
Returns the thread group this thread belongs to or null if none. | | String | getThreadGroupName()
Returns the name of the thread group this thread belongs to,
or null if none.
thread group name, or null if none
exception:
DebugException - if this method fails. | | public boolean | hasOwnedMonitors()
Returns whether this threads owns at least one monitor. | | public boolean | isDaemon()
Returns whether this thread is a daemon thread. | | 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.
whether this thread is out of synch with the workspace.
exception:
DebugException - if this method fails. | | boolean | isPerformingEvaluation()
Returns whether this thread is currently performing
an evaluation. | | boolean | isSystemThread()
Returns whether this thread is a system thread.
whether this thread is a system thread
exception:
DebugException - if this method fails. | | boolean | mayBeOutOfSynch()
Returns whether this thread may be running code in the VM that
is out of synch with the code in the workspace.
whether this thread may be out of synch with the workspace.
exception:
DebugException - if this method fails. | | public void | queueRunnable(Runnable runnable)
Queues the given runnable with the list of runnables associated with this thread.
Runnables are executed asynchronously in a separate thread. | | public void | runEvaluation(IEvaluationRunnable evaluation, IProgressMonitor monitor, int evaluationDetail, boolean hitBreakpoints)
Invokes the given evaluation with the specified progress
monitor. | | public void | stop(IJavaObject exception)
Request to stops this thread with the given exception.
The result will be the same as calling java.lang.Thread#stop(java.lang.Throwable).
If the thread is suspended when the method is called, the thread must be
resumed to complete the action.
exception must represent an exception. | | public void | terminateEvaluation()
Attempts to terminate the currently executing IEvaluationRunnable
in this thread, if any. |
| ERR_THREAD_NOT_SUSPENDED | | final public static int ERR_THREAD_NOT_SUSPENDED(Code) | | Status code indicating a request failed because a thread
was not suspended.
|
| canTerminateEvaluation | | public boolean canTerminateEvaluation()(Code) | | Returns whether the currently executing IEvaluationRunnable
supports termination. An IEvaluationRunnable supports termination
if it implements ITerminate
whether the current evaluation supports termination
since:
2.1 |
| findVariable | | IJavaVariable findVariable(String variableName) throws DebugException(Code) | | 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.
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.
Parameters:
variableName - the name of the variable to search for a variable, or null if none
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
|
| getContendedMonitor | | public IJavaObject getContendedMonitor() throws DebugException(Code) | | Returns a Java object for the monitor for
which this thread is currently waiting or null.
IJavaObject the contended monitor object or null if thisthread is not waiting on a monitor.
exception:
DebugException - if an exception occurs while retrieving the contended monitor.
since:
2.1 |
| getFrameCount | | public int getFrameCount() throws DebugException(Code) | | Returns the number of frames in this thread.
number of stack frames
throws:
DebugException - if an exception occurs while retrieving the count
since:
3.3 |
| getOwnedMonitors | | public IJavaObject[] getOwnedMonitors() throws DebugException(Code) | | Returns the monitors owned by this thread or null
if this thread owns no monitors.
the owned monitors
exception:
DebugException - if an exception occurs while retrievingthe owned monitors of this thread.
since:
2.1 |
| getThreadGroup | | public IJavaThreadGroup getThreadGroup() throws DebugException(Code) | | Returns the thread group this thread belongs to or null if none.
thread group or null
throws:
DebugException -
since:
3.2 |
| getThreadGroupName | | String getThreadGroupName() throws DebugException(Code) | | Returns the name of the thread group this thread belongs to,
or null if none.
thread group name, or null if none
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
|
| hasOwnedMonitors | | public boolean hasOwnedMonitors() throws DebugException(Code) | | Returns whether this threads owns at least one monitor.
boolean whether this thread owns a monitor
exception:
DebugException - if an exception occurs determiningif there are owned monitors.
since:
2.1 |
| isDaemon | | public boolean isDaemon() throws DebugException(Code) | | Returns whether this thread is a daemon thread.
whether this thread is a daemon thread
throws:
DebugException - if an exception occurs while determining status
since:
3.3 |
| isOutOfSynch | | boolean isOutOfSynch() throws DebugException(Code) | | 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.
whether this thread is out of synch with the workspace.
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
since:
2.0
|
| isPerformingEvaluation | | boolean isPerformingEvaluation()(Code) | | Returns whether this thread is currently performing
an evaluation.
whether this thread is currently performingan evaluation
since:
2.0 |
| isSystemThread | | boolean isSystemThread() throws DebugException(Code) | | Returns whether this thread is a system thread.
whether this thread is a system thread
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
|
| mayBeOutOfSynch | | boolean mayBeOutOfSynch() throws DebugException(Code) | | Returns whether this thread may be running code in the VM that
is out of synch with the code in the workspace.
whether this thread may be out of synch with the workspace.
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
since:
2.0
|
| queueRunnable | | public void queueRunnable(Runnable runnable)(Code) | | Queues the given runnable with the list of runnables associated with this thread.
Runnables are executed asynchronously in a separate thread. This method should be
used to execute any code which performs an operation like a method invocation.
Parameters:
runnable - the runnable to execute.
since:
2.1 |
| runEvaluation | | public void runEvaluation(IEvaluationRunnable evaluation, IProgressMonitor monitor, int evaluationDetail, boolean hitBreakpoints) throws DebugException(Code) | | Invokes the given evaluation with the specified progress
monitor. This thread fires a resume event
when the evaluation begins, and a suspend event when the evaluation
completes or throws an exception. The events are given a detail
as specified by evaluationDetail (one of
DebugEvent.EVALUATION or
DebugEvent.EVALUATION_IMPLICIT).
Parameters:
evaluation - the evaluation to perform
Parameters:
monitor - progress monitor (may be null
Parameters:
evaluationDetail - one of DebugEvent.EVALUATION orDebugEvent.EVALUATION_IMPLICIT
Parameters:
hitBreakpoints - whether or not breakpoints should be honoredin this thread during the evaluation. If false, breakpointshit in this thread during the evaluation will be ignored.
exception:
DebugException - if an exception occurs performingthe evaluation
since:
2.0 |
| stop | | public void stop(IJavaObject exception) throws DebugException(Code) | | Request to stops this thread with the given exception.
The result will be the same as calling java.lang.Thread#stop(java.lang.Throwable).
If the thread is suspended when the method is called, the thread must be
resumed to complete the action.
exception must represent an exception.
Parameters:
exception - the exception to throw.
exception:
DebugException -
since:
3.0
See Also: java.lang.Thread.stop(java.lang.Throwable) |
| terminateEvaluation | | public void terminateEvaluation() throws DebugException(Code) | | Attempts to terminate the currently executing 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.
exception:
DebugException - if an exception occurs whileterminating the evaluation.
since:
2.1 |
|
|