jde.debugger.command
Class GetThreads

java.lang.Object
  |
  +--jde.debugger.command.DebugCommand
        |
        +--jde.debugger.command.DebugProcessCommand
              |
              +--jde.debugger.command.GetThreads

All Implemented Interfaces:

java.lang.Cloneable, Protocol

public class GetThreads

extends DebugProcessCommand

List all threads. 'get_threads' command.

Syntax:

 get_threads
 

Returns:

 (jde-dbo-command-result cmd_id thread-info)
 

Comments:

• There are a couple of quirks regarding the reporting of thread state:
  • Quirk 1: Due to a bug in ThreadReference.isAtBreakpoint(), a thread will report a breakpoint at a location even if a threadFilter has been applied for the thread. ie, if test.Test.java:41 is your breakpoint, and you've applied a threadfilter saying you DON'T want an event if the thread == Thread-A, and you somehow suspend Thread-A at exactly that line, and do a 'get_threads'; Thread-A will report to be suspended on a breakpoint, although ordinarily it would have skipped it.
  • Quirk 2: There seems to be no way of reporting the status if the user does a Thread.suspend(). Well, it's deprecated anyways... *shrug*.

Version:

$Revision: 1.2 $

Author:

Paul Kinnucan

Fields inherited from class jde.debugger.command.DebugProcessCommand

m_debugger

Fields inherited from interface jde.debugger.Protocol

APP_IO, ATTACH_SHMEM, ATTACH_SOCKET, BR, BREAK, CANCEL_TRACE_CLASSES, CANCEL_TRACE_METHODS, CANCEL_TRACE_THREADS, CLEAR, CMD_NOK, CMD_OK, COMMAND_ERROR, COMMAND_RESULT, COMMANDS, CONNECTED_TO_VM, DEBUG, ERROR, EVALUATE, EVENT_BREAKPOINT_HIT, EVENT_CLASS_PREPARE, EVENT_CLASS_UNLOAD, EVENT_EXCEPTION, EVENT_METHOD_ENTRY, EVENT_METHOD_EXIT, EVENT_OTHER, EVENT_STEP_COMPLETED, EVENT_THREAD_DEATH, EVENT_THREAD_START, EVENT_VM_DEATH, EVENT_VM_DISCONNECT, EVENT_VM_START, EVENT_WATCHPOINT_HIT, EVENTS, EVENTSET, EXCEPTION, EXIT, FINISH, FRAMEWORK, GET_ARRAY, GET_LOADED_CLASSES, GET_LOCALS, GET_OBJECT, GET_OBJECT_MONITORS, GET_PATH_INFORMATION, GET_STRING, GET_THREAD, GET_THREADS, GUI, INTERRUPT, INVALID, JDE_BUG, JDE_INIT_DEBUG_SESSION, JDE_PIPE, KILL_THREAD, LAUNCH, LISTEN_SHMEM, LISTEN_SOCKET, MESSAGE, NONE, NOQUOTE, QUIT, QUOTE, REPORT_IDS_IN_USE, RESUME, RUN, SPEC_RESOLVED, STEP, SUSPEND, TRACE_CLASSES, TRACE_EXCEPTIONS, TRACE_METHODS, TRACE_THREADS, WARNING, WATCH

Constructor Summary

GetThreads()

Method Summary

java.lang.Object	clone()
void	doCommand() Returns a representation of all the threads and threadgroups in the VM.

Methods inherited from class jde.debugger.command.DebugProcessCommand

getDebugger, init, setDebugger

Methods inherited from class jde.debugger.command.DebugCommand

equals, getID, toString

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GetThreads

public GetThreads()

Method Detail

doCommand

public void doCommand()
               throws JDEException

Returns a representation of all the threads and threadgroups in the VM. For example:

              ThreadGroup-1
                  +- ThreadGroup-2
                  |        +- ThreadGroup-3
                  |        |        \- Thread-1
                  |        +- ThreadGroup-4
                  |        |        +- Thread-2
                  |        |        \- Thread-3
                  |        \- Thread-4
                  \- Thread-5
              ThreadGroup-5
                  +- Thread-6


          (list
            (list "ThreadGroup"  "ThreadGroup-1"
              (list 
                (list "Thread"  "Thread-5" ...))
              (list 
                (list "ThreadGroup"  "ThreadGroup-2"
                  (list 
                    (list "Thread"  "Thread-4"))
                  (list 
                    (list "ThreadGroup"  "ThreadGroup-3"
                      (list)
                      (list 
                        (list "Thread"  "Thread-1" ...)))
                    (list "ThreadGroup"  "ThreadGroup-4"
                      (list)
                        (list
                          (list "Thread"  "Thread-2" ...)
                          (list "Thread"  "Thread-3" ...)))))))
          (list "ThreadGroup"  "ThreadGroup-5"
            (list)
              (list
                (list "Thread"  "Thread-6" ...))))
 

Syntax:

 (list [top-level thread group]*)
 

Overrides:

doCommand in class DebugCommand

Throws:

JDEException -

clone

public java.lang.Object clone()

Overrides:

clone in class DebugCommand