JPDAThread (JPDA Debugger API)

public interface JPDAThread

Represents one Java thread in debugged process.

 Since JDI interfaces evolve from one version to another, it's strongly recommended
 not to implement this interface in client code. New methods can be added to
 this interface at any time to keep up with the JDI functionality.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`PROP_BREAKPOINT` Property name constant.
`static String`	`PROP_CALLSTACK` Property name constant.
`static String`	`PROP_SUSPENDED` Suspended property of the thread.
`static String`	`PROP_VARIABLES` Property name constant.
`static int`	`STATE_MONITOR` Thread state constant.
`static int`	`STATE_NOT_STARTED` Thread state constant.
`static int`	`STATE_RUNNING` Thread state constant.
`static int`	`STATE_SLEEPING` Thread state constant.
`static int`	`STATE_UNKNOWN` Thread state constant.
`static int`	`STATE_WAIT` Thread state constant.
`static int`	`STATE_ZOMBIE` Thread state constant.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`CallStackFrame[]`	`getCallStack()` Returns call stack for this thread.
`CallStackFrame[]`	`getCallStack(int from, int to)` Returns call stack for this thread on the given indexes.
`String`	`getClassName()` If this thread is suspended returns class name this thread is stopped in.
`ObjectVariable`	`getContendedMonitor()` Returns monitor this thread is waiting on.
`MonitorInfo`	`getContendedMonitorAndOwner()` Returns monitor this thread is waiting on, with the information about the owner of the monitor.
`JPDABreakpoint`	`getCurrentBreakpoint()` Returns the current breakpoint hit by this thread.
`EditorContext.Operation`	`getCurrentOperation()` Returns the operation that is being currently executed on this thread.
`List<EditorContext.Operation>`	`getLastOperations()` Returns the list of the last operations, that were performed on this thread.
`int`	`getLineNumber(String stratum)` Returns line number of the location this thread stopped at.
`String`	`getMethodName()` If this thread is suspended returns method name this thread is stopped in.
`String`	`getName()` Getter for the name of thread property.
`ObjectVariable[]`	`getOwnedMonitors()` Returns monitors owned by this thread.
`List<MonitorInfo>`	`getOwnedMonitorsAndFrames()` Get the list of monitors with stack frame info owned by this thread.
`JPDAThreadGroup`	`getParentThreadGroup()` Returns parent thread group.
`Lock`	`getReadAccessLock()` Getter for the "read" lock under which it's guaranteed that the thread does not change it's suspended state.
`String`	`getSourceName(String stratum)` Returns file name this frame is stopped in or null.
`String`	`getSourcePath(String stratum)` Returns source path of file this frame is stopped in or null.
`int`	`getStackDepth()` Returns length of current call stack.
`int`	`getState()` Returns current state of this thread.
`void`	`interrupt()` Interrupts this thread unless the thread has been suspended.
`boolean`	`isSuspended()` Returns true if this thread is suspended by debugger.
`void`	`makeCurrent()` Sets this thread current.
`void`	`resume()` Unsuspends thread.
`void`	`suspend()` Suspends thread.

- Field Detail
  - STATE_UNKNOWN
```
static final int STATE_UNKNOWN
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_MONITOR
```
static final int STATE_MONITOR
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_NOT_STARTED
```
static final int STATE_NOT_STARTED
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_RUNNING
```
static final int STATE_RUNNING
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_SLEEPING
```
static final int STATE_SLEEPING
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_WAIT
```
static final int STATE_WAIT
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - STATE_ZOMBIE
```
static final int STATE_ZOMBIE
```
    Thread state constant.
    
    See Also:
    
    Constant Field Values
  - PROP_SUSPENDED
```
static final String PROP_SUSPENDED
```
    Suspended property of the thread. Fired when isSuspended() changes.
    
    Since:
    
    2.16
    
    See Also:
    
    Constant Field Values
  - PROP_CALLSTACK
```
static final String PROP_CALLSTACK
```
    Property name constant.
    
    See Also:
    
    Constant Field Values
  - PROP_VARIABLES
```
static final String PROP_VARIABLES
```
    Property name constant.
    
    See Also:
    
    Constant Field Values
  - PROP_BREAKPOINT
```
static final String PROP_BREAKPOINT
```
    Property name constant.
    
    Since:
    
    2.16
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getReadAccessLock
```
Lock getReadAccessLock()
```
    Getter for the "read" lock under which it's guaranteed that the thread does not change it's suspended state. Multiple threads can acquire this "read" lock at the same time. But the thread state can be changed only under an internal "write" lock. Clients can use this lock while retrieving data to assure that the thread is not resumed in the mean time.
    
    Returns:
    
    The read access lock.
    
    Since:
    
    2.18
  - getName
```
String getName()
```
    Getter for the name of thread property.
    
    Returns:
    
    name of thread
  - getParentThreadGroup
```
JPDAThreadGroup getParentThreadGroup()
```
    Returns parent thread group.
    
    Returns:
    
    parent thread group
  - getLineNumber
```
int getLineNumber(String stratum)
```
    Returns line number of the location this thread stopped at. The thread should be suspended at the moment this method is called.
    
    Returns:
    
    line number of the current location if the thread is suspended, contains at least one frame and the topmost frame does not represent a native method invocation; -1 otherwise
    
    See Also:
    
    CallStackFrame
  - getCurrentOperation
```
EditorContext.Operation getCurrentOperation()
```
    Returns the operation that is being currently executed on this thread.
    
    Returns:
    
    The current operation, or null.
    
    See Also:
    
    CallStackFrame#getCurrentOperation}
  - getCurrentBreakpoint
```
JPDABreakpoint getCurrentBreakpoint()
```
    Returns the current breakpoint hit by this thread.
    
    Returns:
    
    The current breakpoint, or null.
    
    Since:
    
    2.16
  - getLastOperations
```
List<EditorContext.Operation> getLastOperations()
```
    Returns the list of the last operations, that were performed on this thread. Typically just operations from the current expression are stored. The thread should be suspended at the moment this method is called.
    
    Returns:
    
    The list of last operations if available, the thread is suspended, contains at least one frame and the topmost frame does not represent a native method invocation; null otherwise
    
    See Also:
    
    CallStackFrame
  - getState
```
int getState()
```
    Returns current state of this thread.
    
    Returns:
    
    current state of this thread
  - isSuspended
```
boolean isSuspended()
```
    Returns true if this thread is suspended by debugger.
    
    Returns:
    
    true if this thread is suspended by debugger
  - getClassName
```
String getClassName()
```
    If this thread is suspended returns class name this thread is stopped in.
    
    Returns:
    
    class name this thread is stopped in
  - getMethodName
```
String getMethodName()
```
    If this thread is suspended returns method name this thread is stopped in.
    
    Returns:
    
    method name this thread is stopped in
  - suspend
```
void suspend()
```
    Suspends thread.
  - resume
```
void resume()
```
    Unsuspends thread.
  - interrupt
```
void interrupt()
```
    Interrupts this thread unless the thread has been suspended.
    
    Since:
    
    2.1
  - getSourceName
```
String getSourceName(String stratum)
              throws com.sun.jdi.AbsentInformationException
```
    Returns file name this frame is stopped in or null.
    
    Returns:
    
    file name this frame is stopped in
    
    Throws:
    
    com.sun.jdi.AbsentInformationException
  - getSourcePath
```
String getSourcePath(String stratum)
              throws com.sun.jdi.AbsentInformationException
```
    Returns source path of file this frame is stopped in or null.
    
    Returns:
    
    source path of file this frame is stopped in or null
    
    Throws:
    
    com.sun.jdi.AbsentInformationException
  - getCallStack
```
CallStackFrame[] getCallStack()
                       throws com.sun.jdi.AbsentInformationException
```
    Returns call stack for this thread.
    
    Returns:
    
    call stack
    
    Throws:
    
    com.sun.jdi.AbsentInformationException - if the thread is running or not able to return callstack. If the thread is in an incompatible state (e.g. running), the AbsentInformationException has IncompatibleThreadStateException as a cause.
  - getCallStack
```
CallStackFrame[] getCallStack(int from,
                              int to)
                       throws com.sun.jdi.AbsentInformationException
```
    Returns call stack for this thread on the given indexes.
    
    Parameters:
    
    from - a from index, inclusive
    
    to - a to index, exclusive
    
    Returns:
    
    call stack
    
    Throws:
    
    com.sun.jdi.AbsentInformationException - if the thread is running or not able to return callstack. If the thread is in an incompatible state (e.g. running), the AbsentInformationException has IncompatibleThreadStateException as a cause.
  - getStackDepth
```
int getStackDepth()
```
    Returns length of current call stack.
    
    Returns:
    
    length of current call stack
  - makeCurrent
```
void makeCurrent()
```
    Sets this thread current.
    
    See Also:
    
    JPDADebugger.getCurrentThread()
  - getContendedMonitor
```
ObjectVariable getContendedMonitor()
```
    Returns monitor this thread is waiting on.
    
    Returns:
    
    monitor this thread is waiting on
  - getContendedMonitorAndOwner
```
MonitorInfo getContendedMonitorAndOwner()
```
    Returns monitor this thread is waiting on, with the information about the owner of the monitor.
    
    Returns:
    
    monitor this thread is waiting on, with the owner.
    
    Since:
    
    2.16
  - getOwnedMonitors
```
ObjectVariable[] getOwnedMonitors()
```
    Returns monitors owned by this thread.
    
    Returns:
    
    monitors owned by this thread
  - getOwnedMonitorsAndFrames
```
List<MonitorInfo> getOwnedMonitorsAndFrames()
```
    Get the list of monitors with stack frame info owned by this thread.
    
    Returns:
    
    the list of monitors with stack frame info
    
    Since:
    
    2.16

Interface JPDAThread

Field Summary

Method Summary

Field Detail

STATE_UNKNOWN

STATE_MONITOR

STATE_NOT_STARTED

STATE_RUNNING

STATE_SLEEPING

STATE_WAIT

STATE_ZOMBIE

PROP_SUSPENDED

PROP_CALLSTACK

PROP_VARIABLES

PROP_BREAKPOINT

Method Detail

getReadAccessLock

getName

getParentThreadGroup

getLineNumber

getCurrentOperation

getCurrentBreakpoint

getLastOperations

getState

isSuspended

getClassName

getMethodName

suspend

resume

interrupt

getSourceName

getSourcePath

getCallStack

getCallStack

getStackDepth

makeCurrent

getContendedMonitor

getContendedMonitorAndOwner

getOwnedMonitors

getOwnedMonitorsAndFrames