Java Debug Interface

com.sun.jdi
インタフェース ThreadGroupReference

すべてのスーパーインタフェース:
Mirror, ObjectReference, Value

public interface ThreadGroupReference
extends ObjectReference

ターゲット VM のスレッドグループオブジェクトです。ThreadGroupReference は、ターゲット VM のスレッドグループ固有の情報に追加アクセスできる ObjectReference です。

導入されたバージョン:
1.3

フィールドの概要
 
インタフェース com.sun.jdi.ObjectReference から継承されたフィールド
INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED
 
メソッドの概要
 String name()
          このスレッドグループの名前を返します。
 ThreadGroupReference parent()
          このスレッドグループの親を返します。
 void resume()
          このスレッドグループ内のすべてのスレッドを再開します。
 void suspend()
          このスレッドグループ内のすべてのスレッドを中断します。
 List<ThreadGroupReference> threadGroups()
          このスレッドグループ内のすべてのアクティブな ThreadGroupReference の List を返します。
 List<ThreadReference> threads()
          このスレッドグループ内の各ライブスレッドに対して、ThreadReference を含む List を返します。
 
インタフェース com.sun.jdi.ObjectReference から継承されたメソッド
disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, setValue, uniqueID, waitingThreads
 
インタフェース com.sun.jdi.Value から継承されたメソッド
type
 
インタフェース com.sun.jdi.Mirror から継承されたメソッド
toString, virtualMachine
 

メソッドの詳細

name

String name()
このスレッドグループの名前を返します。

戻り値:
スレッドグループ名を含む文字列

parent

ThreadGroupReference parent()
このスレッドグループの親を返します。

戻り値:
ターゲット VM 内のこのスレッドグループの親をミラー化する ThreadGroupReference。これが最上位のスレッドグループである場合は null

suspend

void suspend()
このスレッドグループ内のすべてのスレッドを中断します。このグループ内の各スレッドおよびそのすべてのサブグループは、ThreadReference.suspend() で記述されている方法で中断されます。この操作の不可分性は保証されていません。このメソッドが呼び出されるときにターゲット VM で割り込みが発生しなかった場合は、スレッドが列挙されてからすべてのスレッドが中断されるまでに、新しいスレッドが作成される可能性があります。

例外:
VMCannotBeModifiedException - 仮想マシンが読み取り専用の場合は、VirtualMachine.canBeModified() を参照

resume

void resume()
このスレッドグループ内のすべてのスレッドを再開します。このグループ内の各スレッドおよびそのすべてのサブグループは、ThreadReference.resume() で記述されている方法で再開されます。

例外:
VMCannotBeModifiedException - 仮想マシンが読み取り専用の場合は、VirtualMachine.canBeModified() を参照

threads

List<ThreadReference> threads()
このスレッドグループ内の各ライブスレッドに対して、ThreadReference を含む List を返します。このスレッドグループの直下のライブスレッドだけを返し、サブグループは返しません。スレッドは開始されると、停止されるまで、活動状態にあります。

戻り値:
ターゲット VM 内のこのスレッドグループのライブスレッドをミラー化する ThreadReference オブジェクトの List

threadGroups

List<ThreadGroupReference> threadGroups()
このスレッドグループ内のすべてのアクティブな ThreadGroupReference の List を返します。このスレッドグループの直下のアクティブなスレッドグループだけを返し、サブグループは返しません。アクティブな ThreadGroup の詳細は、「java.lang.ThreadGroup」を参照してください。

戻り値:
ターゲット VM 内のこのスレッドグループのアクティブなスレッドグループをミラー化する ThreadGroupReference の List

Java Debug Interface