Interface IThread

    • Method Detail

      • getStackFrames

        IStackFrame[] getStackFrames()
                              throws DebugException
        Returns the stack frames contained in this thread. An empty collection is returned if this thread contains no stack frames, or is not currently suspended. Stack frames are returned in top down order.
        Returns:
        a collection of stack frames
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
        Since:
        2.0
      • hasStackFrames

        boolean hasStackFrames()
                        throws DebugException
        Returns whether this thread currently contains any stack frames.
        Returns:
        whether this thread currently contains any stack frames
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the debug target. The DebugException's status code contains the underlying exception responsible for the failure.
        Since:
        2.0
      • getPriority

        int getPriority()
                 throws DebugException
        Returns the priority of this thread. The meaning of this number is operating-system dependent.
        Returns:
        thread priority
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
      • getTopStackFrame

        IStackFrame getTopStackFrame()
                              throws DebugException
        Returns the top stack frame or null if there is currently no top stack frame.
        Returns:
        the top stack frame, or null if none
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
      • getName

        String getName()
                throws DebugException
        Returns the name of this thread. Name format is debug model specific, and should be specified by a debug model.
        Returns:
        this thread's name
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
      • getBreakpoints

        IBreakpoint[] getBreakpoints()
        Returns the breakpoints that caused this thread to suspend, or an empty collection if this thread is not suspended or was not suspended by a breakpoint. Usually a single breakpoint will be returned, but this collection can contain more than one breakpoint if two breakpoints are at the same location in a program.
        Returns:
        the collection of breakpoints that caused this thread to suspend