ThreadGroup

ThreadGroup

ThreadGroup (String name)

构造一个新的线程组。 这个新组的父节点是当前正在运行的线程的线程组。

父线程组的checkAccess方法不带任何参数调用; 这可能会导致安全异常。

ThreadGroup

ThreadGroup (ThreadGroup parent, 
                String name)

创建一个新的线程组。 这个新组的父节点是指定的线程组。

父线程组的checkAccess方法在不带参数的情况下调用; 这可能会导致安全异常。

activeCount

int activeCount ()

返回此线程组及其子组中活动线程数的估计值。 递归迭代此线程组中的所有子组。

返回的值仅为估计值，因为线程数可能会动态变化，而此方法会遍历内部数据结构，并可能受某些系统线程的影响。 此方法主要用于调试和监控目的。

activeGroupCount

int activeGroupCount ()

返回此线程组及其子组中活动组数量的估计值。 递归迭代此线程组中的所有子组。

返回的值只是一个估计值，因为在此方法遍历内部数据结构时，线程组的数量可能会动态变化。 此方法主要用于调试和监控目的。

allowThreadSuspension

boolean allowThreadSuspension (boolean b)

此方法在API级别1中已弃用。
此调用的定义取决于suspend() ，已弃用。 此外，此调用的行为从未被指定。

由VM用来控制lowmem隐式暂停。

checkAccess

void checkAccess ()

确定当前正在运行的线程是否有权修改此线程组。

如果有安全管理器， checkAccess该线程组为参数调用其checkAccess方法。 这可能会导致投掷SecurityException 。

destroy

void destroy ()

销毁此线程组及其所有子组。 该线程组必须为空，表示此线程组中已经停止的所有线程。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

enumerate

int enumerate (ThreadGroup[] list)

复制到指定数组引用此线程组及其子组中的每个活动子组。

此方法的调用的行为与调用完全相同

enumerate (list, true)

enumerate

int enumerate (ThreadGroup[] list, 
                boolean recurse)

复制到此线程组中每个活动子组的指定数组引用中。 如果recurse是true ，则此方法递归枚举此线程组的所有子组，并且还包括对这些子组中每个活动线程组的引用。

应用程序可能会使用activeGroupCount方法来估计数组的大小，但如果数组太短而无法容纳所有线程组，则会以无提示方式忽略额外的线程组。 如果获取此线程组中的每个活动子组都非常重要，则调用者应验证返回的int值严格小于list的长度。

由于这种方法固有的竞争条件，建议该方法仅用于调试和监控目的。

enumerate

int enumerate (Thread[] list)

将此线程组及其子组中的每个活动线程复制到指定数组中。

此方法的调用的行为与调用完全相同

enumerate (list, true)

enumerate

int enumerate (Thread[] list, 
                boolean recurse)

将此线程组中的每个活动线程复制到指定数组中。 如果recurse为true ，则此方法递归枚举此线程组的所有子组，并且还包括对这些子组中每个活动线程的引用。 如果数组太短而不能容纳所有的线程，则额外的线程将被静默地忽略。

应用程序可能会使用activeCount方法来估计数组应该有多大，但是如果数组太短而无法保存所有线程，则额外的线程将被忽略。 如果获得此线程组中的每个活动线程都非常重要，则调用方应验证返回的int值是否严格小于list的长度。

由于这种方法固有的竞争条件，建议该方法仅用于调试和监控目的。

getMaxPriority

int getMaxPriority ()

返回此线程组的最大优先级。 作为该组的一部分的线程不能具有比最大优先级更高的优先级。

getName

String getName ()

返回此线程组的名称。

getParent

ThreadGroup getParent ()

返回此线程组的父项。

首先，如果父项不是null ，则父线程组的checkAccess方法将不带参数调用; 这可能会导致安全异常。

interrupt

void interrupt ()

中断此线程组中的所有线程。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

然后，此方法在此线程组中的所有线程及其所有子组中调用 interrupt方法。

isDaemon

boolean isDaemon ()

测试此线程组是否为守护线程组。 守护进程线程组在最后一个线程停止或其最后一个线程组被销毁时自动销毁。

isDestroyed

boolean isDestroyed ()

测试该线程组是否已被销毁。

list

void list ()

将有关该线程组的信息打印到标准输出。 此方法仅用于调试。

parentOf

boolean parentOf (ThreadGroup g)

测试此线程组是线程组参数还是其祖先线程组之一。

resume

void resume ()

此方法在API级别1中已弃用。
此方法仅与Thread.suspend和ThreadGroup.suspend一起使用，两者都已被弃用，因为它们固有地容易出现死锁。 详情请参阅suspend() 。

恢复此线程组中的所有线程。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

然后该方法在该线程组中的所有线程及其所有子组中调用 resume方法。

setDaemon

void setDaemon (boolean daemon)

更改此线程组的守护程序状态。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

守护进程线程组在最后一个线程停止或其最后一个线程组被销毁时自动销毁。

setMaxPriority

void setMaxPriority (int pri)

设置组的最大优先级。 已经具有较高优先级的线程组中的线程不受影响。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

如果参数 pri小于 MIN_PRIORITY或大于 MAX_PRIORITY ，则它被限制为这些值。

否则，此ThreadGroup对象的优先级设置为指定的pri和此线程组的父级的最大允许优先级中的较小者。 （如果此线程组是系统线程组，但没有父系，则其最大优先级设置为pri ）然后，对于属于此线程组的每个线程组，以pri作为其参数递归地调用此方法。

stop

void stop ()

此方法在API级别1中已弃用。
这种方法本质上是不安全的。 详情请参阅stop() 。

停止此线程组中的所有线程。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

然后，此方法在该线程组中的所有线程及其所有子组中调用 stop方法。

suspend

void suspend ()

此方法在API级别1中已弃用。
这种方法本质上容易出现死锁。 有关详细信息，请参阅suspend() 。

暂停此线程组中的所有线程。

首先，这个线程组的checkAccess方法被调用时没有参数; 这可能会导致安全异常。

然后，此方法将在此线程组中的所有线程及其所有子组中调用 suspend方法。

toString

String toString ()

返回此线程组的字符串表示形式。

uncaughtException

void uncaughtException (Thread t, 
                Throwable e)

当此线程组中的线程由于未捕获的异常而停止且该线程没有安装特定的 Thread.UncaughtExceptionHandler时，由Java虚拟机调用。

该 uncaughtException的方法 ThreadGroup执行以下操作：

• If this thread group has a parent thread group, the uncaughtException method of that parent is called with the same two arguments.
• Otherwise, this method checks to see if there is a default uncaught exception handler installed, and if so, its uncaughtException method is called with the same two arguments.
• Otherwise, this method determines if the Throwable argument is an instance of ThreadDeath. If so, nothing special is done. Otherwise, a message containing the thread's name, as returned from the thread's getName method, and a stack backtrace, using the Throwable's printStackTrace method, is printed to the standard error stream.

应用程序可以在 ThreadGroup子类中重写此方法，以提供对未捕获异常的替代处理。