インタフェースThreadGroupReference

すべてのスーパー・インタフェース:

Mirror, ObjectReference, Value

public interface ThreadGroupReference extends ObjectReference

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

導入されたバージョン:

1.3

フィールドのサマリー

インタフェースで宣言されたフィールド ObjectReference

INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED

修飾子と型	フィールド	説明
static final int	INVOKE_NONVIRTUAL	非仮想メソッドの呼出しを実行します。
static final int	INVOKE_SINGLE_THREADED	呼出し側のスレッドだけを再開してメソッドの呼出しを実行します。

メソッドのサマリー

修飾子と型	メソッド	説明
String	name()	このスレッド・グループの名前を返します。
ThreadGroupReference	parent()	このスレッド・グループの親を返します。
void	resume()	このスレッド・グループ内のすべてのスレッドを再開します。
void	suspend()	このスレッド・グループ内のすべてのスレッドを停止します。
List<ThreadGroupReference>	threadGroups()	各サブグループのThreadGroupReferenceを含むListを返します。
List<ThreadReference>	threads()	このスレッド・グループのライブ・プラットフォーム・スレッドごとにThreadReferenceを含むリストを返します。

インタフェースMirrorで宣言されたメソッド

toString, virtualMachine

修飾子と型	メソッド	説明
String	toString()	このミラーについて説明する文字列を返します。
VirtualMachine	virtualMachine()	このミラーが属するVirtualMachineを取得します。

インタフェースで宣言されたメソッド ObjectReference

disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, referringObjects, setValue, uniqueID, waitingThreads

修飾子と型	メソッド	説明
void	disableCollection()	このオブジェクトに対するガベージ・コレクションを回避します。
void	enableCollection()	このオブジェクトのガベージ・コレクションを許可します。
int	entryCount()	所有スレッドがプラットフォーム・スレッドである場合に、このオブジェクトのモニターが現在の所有スレッドによって入力された回数を返します。プラットフォーム・スレッドによって所有されていない場合は0を返します。
boolean	equals(Object obj)	指定されたObjectがこのObjectReferenceと等しいかどうか比較します。
Value	getValue(Field sig)	このオブジェクトの指定されたインスタンスまたはstaticフィールドの値を取得します。
Map<Field,Value>	getValues(List<? extends Field> fields)	このオブジェクトの複数のインスタンスまたはstaticフィールド、あるいはその両方の値を取得します。
int	hashCode()	このObjectReferenceのハッシュ・コード値を返します。
Value	invokeMethod(ThreadReference thread, Method method, List<? extends Value> arguments, int options)	ターゲットVM内のこのオブジェクトで指定されたMethodを呼び出します。
boolean	isCollected()	ターゲットVMでこのオブジェクトがガベージ・コレクトされているかどうかを判定します。
ThreadReference	owningThread()	現在このオブジェクトのモニターを所有しているプラットフォーム・スレッド(存在する場合)のThreadReferenceを返します。
ReferenceType	referenceType()	このオブジェクトの型をミラー化するReferenceTypeを取得します。
List<ObjectReference>	referringObjects(long maxReferrers)	このオブジェクトを直接参照するオブジェクトを返します。
void	setValue(Field field, Value value)	このオブジェクトのインスタンス・フィールドまたはstaticフィールドの値を設定します。
long	uniqueID()	このObjectReferenceの一意の識別子を返します。
List<ThreadReference>	waitingThreads()	現在このオブジェクトのモニターを待機している各プラットフォーム・スレッドのThreadReferenceを含むリストを返します。

インタフェースValueで宣言されたメソッド

type

修飾子と型	メソッド	説明
Type	type()	この値の実行時の型を返します。

メソッドの詳細

name

String name()

このスレッド・グループの名前を返します。

戻り値:

スレッド・グループ名を含む文字列。

parent

ThreadGroupReference parent()

このスレッド・グループの親を返します。

戻り値:

ターゲットVM内のこのスレッド・グループの親をミラー化するThreadGroupReference。これがトップ・レベルのスレッド・グループである場合はnull。

suspend

void suspend()

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

スロー:

VMCannotBeModifiedException - VirtualMachineが読取り専用の場合(VirtualMachine.canBeModified()を参照)。

resume

void resume()

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

スロー:

VMCannotBeModifiedException - VirtualMachineが読取り専用の場合(VirtualMachine.canBeModified()を参照)。

threads

List<ThreadReference> threads()

このスレッド・グループのライブ・プラットフォーム・スレッドごとにThreadReferenceを含むリストを返します。 仮想スレッドは含まれません。 この即時スレッド・グループ(サブグループ以外)のライブ・プラットフォーム・スレッドのみが返されます。 スレッドが開始され、終了していない場合、スレッドは存続しています。

戻り値:

ターゲットVMのこのスレッド・グループのライブ・プラットフォーム・スレッドをミラー化するThreadReferenceオブジェクトのリスト。

threadGroups

List<ThreadGroupReference> threadGroups()

各サブグループのThreadGroupReferenceを含むListを返します。 この即時スレッド・グループ(サブグループ以外)のスレッド・グループのみが返されます。

戻り値:

ターゲットVMのこのスレッド・グループからのスレッド・グループをミラー化するThreadGroupReferenceオブジェクトのリスト。