Module jdk.jdi

软件包 com.sun.jdi

Interface ThreadGroupReference

All Superinterfaces:

Mirror ， ObjectReference ， Value

public interface ThreadGroupReference
extends ObjectReference

来自目标VM的线程组对象。 ThreadGroupReference是一个ObjectReference，具有来自目标VM的线程组特定信息的附加访问权限。

从以下版本开始：

1.3

Field Summary

Fields inherited from interface com.sun.jdi.ObjectReference

INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED

方法摘要

Modifier and Type	方法	描述
String	name()	返回此线程组的名称。
ThreadGroupReference	parent()	返回此线程组的父级。
void	resume()	恢复此线程组中的所有线程。
void	suspend()	暂停此线程组中的所有线程。
List<ThreadGroupReference>	threadGroups()	返回一个包含此线程组中每个活动ThreadGroupReference的列表。
List<ThreadReference>	threads()	返回一个列表，该列表包含此线程组中每个活动线程的一个ThreadReference 。

Methods inherited from interface com.sun.jdi.Mirror

toString, virtualMachine

Methods inherited from interface com.sun.jdi.ObjectReference

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

Methods inherited from interface com.sun.jdi.Value

type

方法详细信息

name

String name()

返回此线程组的名称。

结果

该字符串包含线程组名称。

parent

ThreadGroupReference parent()

返回此线程组的父级。

结果

一个ThreadGroupReference镜像目标VM中此线程组的父级，如果这是顶级线程组，则为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 。 只返回此直接线程组（而不是其子组）中的实时线程。 如果线程已经启动并且还没有被停止，则线程是活着的。

结果

一个ThreadReference对象的列表， 用于从目标VM中的此线程组镜像活动线程。

threadGroups

List<ThreadGroupReference> threadGroups()

返回一个包含此线程组中每个活动ThreadGroupReference的列表。 只返回此直接线程组（而不是其子组）中的活动线程组。 有关“活动”ThreadGroups的信息，请参阅ThreadGroup 。

结果

一个ThreadGroupReference对象的列表， 用于从目标VM中的此线程组镜像活动线程组。