ThreadGroup (Java Platform SE 8 )

java.lang.Object
- java.lang.ThreadGroup

All Implemented Interfaces:

Thread.UncaughtExceptionHandler
```
public class ThreadGroup
extends Object
implements Thread.UncaughtExceptionHandler
```
一个线程组表示一组线程。此外，一个线程组还可以包括其他线程组。线程组形成一个树，其中每一个线程组除了初始线程组有一个父。
允许一个线程访问它自己的线程组的信息，但不允许访问它的线程组的父线程组或其他任何线程组的信息。

从以下版本开始：

JDK1.0

构造方法摘要

构造方法
Constructor and Description
`ThreadGroup(String name)` 构建一个新的线程组。
`ThreadGroup(ThreadGroup parent, String name)` 创建一个新的线程组。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`int`	`activeCount()` 返回这个线程组和它的子组中活动线程数的估计值。
`int`	`activeGroupCount()` 返回这个线程组和它的子组中的活动组数的估计值。
`boolean`	`allowThreadSuspension(boolean b)` 过时的。这个调用的定义取决于`suspend()`，这是过时的。此外，这个调用的行为从来没有被指定。
`void`	`checkAccess()` 确定当前正在运行的线程是否有修改这个线程组的权限。
`void`	`destroy()` 破坏这个线程组和它所有的子组。
`int`	`enumerate(Thread[] list)` 在这个线程组及其子组中的每一个活动线程中拷贝到指定的数组中。
`int`	`enumerate(Thread[] list, boolean recurse)` 在这个线程组中的每一个活动线程中复制到指定的数组中。
`int`	`enumerate(ThreadGroup[] list)` 在这个线程组及其子组中的每一个活动子组中的指定数组引用。
`int`	`enumerate(ThreadGroup[] list, boolean recurse)` 在这个线程组中的每一个活动分组中的指定数组引用。
`int`	`getMaxPriority()` 返回此线程组的最大优先级。
`String`	`getName()` 返回这个线程组的名称。
`ThreadGroup`	`getParent()` 返回这个线程组的父。
`void`	`interrupt()` 中断这个线程组中的所有线程。
`boolean`	`isDaemon()` 判断该线程组是否是守护线程组。
`boolean`	`isDestroyed()` 测试这个线程组是否已被销毁。
`void`	`list()` 将此线程组的信息打印到标准输出。
`boolean`	`parentOf(ThreadGroup g)` 测试这个线程组是否是线程组参数或它的一个祖先线程组的一个。
`void`	`resume()` 过时的。此方法仅用于与`Thread.suspend`和`ThreadGroup.suspend`一起，都被否决，因为他们天生就容易导致死锁。看到`Thread.suspend()`详情。
`void`	`setDaemon(boolean daemon)` 改变该线程组的守护状态。
`void`	`setMaxPriority(int pri)` 设置组的最大优先级。
`void`	`stop()` 过时的。这种方法本质上是不安全的。看到`Thread.stop()`详情。
`void`	`suspend()` 过时的。这种方法本质上是容易发生死锁的。看到`Thread.suspend()`详情。
`String`	`toString()` 返回这个线程组的字符串表示形式。
`void`	`uncaughtException(Thread t, Throwable e)` 由java虚拟机时，一个线程，该线程组中的停止，因为未捕获的异常，和线程没有特定的 `Thread.UncaughtExceptionHandler`安装。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - ThreadGroup
```
public ThreadGroup(String name)
```
    构建一个新的线程组。这个新组的父是当前正在运行的线程的线程组。
    的父线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    参数
    
    name -新的线程组名称。
    
    异常
    
    SecurityException -如果当前线程不能创建指定的线程组的线程。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    checkAccess()
  - ThreadGroup
```
public ThreadGroup(ThreadGroup parent,
                   String name)
```
    创建一个新的线程组。这个新组的父是指定的线程组。
    的父线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    参数
    
    parent -父线程组。
    
    name -新的线程组名称。
    
    异常
    
    NullPointerException如果线程组的说法是 null。
    
    SecurityException -如果当前线程不能创建指定的线程组的线程。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    SecurityException， checkAccess()
- 方法详细信息
  - getName
```
public final String getName()
```
    返回这个线程组的名称。
    
    结果
    
    这个线程组的名称。
    
    从以下版本开始：
    
    JDK1.0
  - getParent
```
public final ThreadGroup getParent()
```
    返回这个线程组的父。
    首先，如果家长不null，的父线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    结果
    
    这个线程组的父。顶层线程组是唯一的线程组的父是 null。
    
    异常
    
    SecurityException -如果当前线程不能修改该线程组。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    checkAccess()， SecurityException， RuntimePermission
  - getMaxPriority
```
public final int getMaxPriority()
```
    返回此线程组的最大优先级。线程，是本组的一部分不能有一个更高的优先级比最大优先级。
    
    结果
    
    线程组中的一个线程的最大优先级。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    setMaxPriority(int)
  - isDaemon
```
public final boolean isDaemon()
```
    判断该线程组是否是守护线程组。守护线程组时自动撤销其最后一个线程停止或最后一个线程组被破坏。
    
    结果
    
    true该线程组是否是守护线程组； false否则。
    
    从以下版本开始：
    
    JDK1.0
  - isDestroyed
```
public boolean isDestroyed()
```
    测试这个线程组是否已被销毁。
    
    结果
    
    如果此对象被销毁，则为
    
    从以下版本开始：
    
    JDK1.1
  - setDaemon
```
public final void setDaemon(boolean daemon)
```
    改变该线程组的守护状态。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    守护线程组时自动撤销其最后一个线程停止或最后一个线程组被破坏。
    
    参数
    
    daemon -如果 true，标志着该线程组为守护线程组；否则，标志着该线程组为正常。
    
    异常
    
    SecurityException -如果当前线程不能修改该线程组。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    SecurityException， checkAccess()
  - setMaxPriority
```
public final void setMaxPriority(int pri)
```
    设置组的最大优先级。已经有一个更高优先级的线程组中的线程没有受到影响。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    如果pri参数小于或大于Thread.MAX_PRIORITY Thread.MIN_PRIORITY，该组的最高优先级保持不变。
    
    否则，这个ThreadGroup对象优先级设置为指定pri较小和最大允许该线程组的父优先。（如果该线程组的系统线程组，没有父母，那么其最高优先权仅仅是开始pri。）将这一方法称为递归，与pri作为它的参数，为每一个线程组属于该线程组。
    
    参数
    
    pri -线程组的优先级。
    
    异常
    
    SecurityException -如果当前线程不能修改该线程组。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    getMaxPriority()， SecurityException， checkAccess()
  - parentOf
```
public final boolean parentOf(ThreadGroup g)
```
    测试这个线程组是否是线程组参数或它的一个祖先线程组的一个。
    
    参数
    
    g -一个线程组。
    
    结果
    
    true如果该线程组的线程组的论点或其祖先 false否则线程组。
    
    从以下版本开始：
    
    JDK1.0
  - checkAccess
```
public final void checkAccess()
```
    确定当前正在运行的线程是否有修改这个线程组的权限。
    如果存在安全管理器，它的checkAccess方法调用这个线程组作为其参数。这可能会导致在扔一个SecurityException。
    
    异常
    
    SecurityException -如果当前线程不允许访问该线程组。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    SecurityManager.checkAccess(java.lang.ThreadGroup)
  - activeCount
```
public int activeCount()
```
    返回这个线程组和它的子组中活动线程数的估计值。递归遍历该线程组中的所有子群。
    返回的值只是一个估计值，因为线程的数量可以动态变化，而这一方法遍历的内部数据结构，可能与某些系统线程的存在影响。此方法主要用于调试和监控的目的。
    
    结果
    
    这个线程组中有这个线程组作为祖先的任何其他线程组中的活动线程数量的估计
    
    从以下版本开始：
    
    JDK1.0
  - enumerate
```
public int enumerate(Thread[] list)
```
    在这个线程组及其子组中的每一个活动线程中拷贝到指定的数组中。
    此方法的调用与调用的方式完全相同的行为
    
    enumerate (list, true)
    
    参数
    
    list -成一个阵列将线程的列表
    
    结果
    
    数组的线程数
    
    异常
    
    SecurityException -如果 checkAccess确定当前线程不能访问该线程组
    
    从以下版本开始：
    
    JDK1.0
  - enumerate
```
public int enumerate(Thread[] list,
                     boolean recurse)
```
    在这个线程组中的每一个活动线程中复制到指定的数组中。如果 recurse是 true，此方法递归枚举所有子群该线程组和引用这些分组中的所有活动线程也包括在内。如果数组太短，不保留所有的线程，额外的线程将被忽略。
    一个应用程序可能使用activeCount方法得到的估计有多大的数组是应该的，但是空如果数组太短，不保留所有的线程，额外的线程将被忽略。如果是该线程组中的每一个活动线程获得关键，调用者应该验证返回int值严格小于list长度。
    
    由于在这种方法中的固有的比赛条件，它是建议，该方法只用于调试和监控的目的。
    
    参数
    
    list -成一个阵列将线程的列表
    
    recurse -如果 true，递归枚举所有子线程组
    
    结果
    
    数组的线程数
    
    异常
    
    SecurityException -如果 checkAccess确定当前线程不能访问该线程组
    
    从以下版本开始：
    
    JDK1.0
  - activeGroupCount
```
public int activeGroupCount()
```
    返回这个线程组和它的子组中的活动组数的估计值。递归遍历该线程组中的所有子群。
    返回的值只是一个估计值，因为线程组的数量可以动态变化，而这种方法遍历内部数据结构。此方法主要用于调试和监控的目的。
    
    结果
    
    这个线程组作为一个祖先的活动线程组的数目
    
    从以下版本开始：
    
    JDK1.0
  - enumerate
```
public int enumerate(ThreadGroup[] list)
```
    在这个线程组及其子组中的每一个活动子组中的指定数组引用。
    此方法的调用与调用的方式完全相同的行为
    
    enumerate (list, true)
    
    参数
    
    list -成一个阵列将线程组的列表
    
    结果
    
    数组中的线程组的数目
    
    异常
    
    SecurityException -如果 checkAccess确定当前线程不能访问该线程组
    
    从以下版本开始：
    
    JDK1.0
  - enumerate
```
public int enumerate(ThreadGroup[] list,
                     boolean recurse)
```
    在这个线程组中的每一个活动分组中的指定数组引用。如果 recurse是 true，此方法递归枚举所有子群该线程组和引用这些分组中的所有活动线程组也包括在内。
    一个应用程序可能使用activeGroupCount方法得到的估计有多大的数组是应该的，但是空如果数组太短，不保留所有的线程组，则额外的线程组将被忽略。如果是该线程组中的每一个活动小组获得的关键，调用者应该验证返回int值严格小于list长度。
    
    由于在这种方法中的固有的比赛条件，它是建议，该方法只用于调试和监控的目的。
    
    参数
    
    list -成一个阵列将线程组的列表
    
    recurse -如果 true，递归枚举所有子群
    
    结果
    
    数组中的线程组的数目
    
    异常
    
    SecurityException -如果 checkAccess确定当前线程不能访问该线程组
    
    从以下版本开始：
    
    JDK1.0
  - stop
```
@Deprecated
public final void stop()
```
    过时的。这种方法本质上是不安全的。看到Thread.stop()详情。
    
    停止该线程组中的所有线程。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    这个方法然后调用该线程组中，在其所有亚组的所有线程的stop方法。
    
    异常
    
    SecurityException -如果当前线程不允许在线程组线程组或任何线程访问。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    SecurityException， Thread.stop()， checkAccess()
  - interrupt
```
public final void interrupt()
```
    中断这个线程组中的所有线程。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    这个方法然后调用该线程组中，在其所有亚组的所有线程的interrupt方法。
    
    异常
    
    SecurityException -如果当前线程不允许在线程组线程组或任何线程访问。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Thread.interrupt()， SecurityException， checkAccess()
  - suspend
```
@Deprecated
public final void suspend()
```
    过时的。这种方法本质上是容易发生死锁的。看到Thread.suspend()详情。
    
    停止该线程组中的所有线程。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    这个方法然后调用该线程组中，在其所有亚组的所有线程的suspend方法。
    
    异常
    
    SecurityException -如果当前线程不允许在线程组线程组或任何线程访问。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    Thread.suspend()， SecurityException， checkAccess()
  - resume
```
@Deprecated
public final void resume()
```
    过时的。此方法仅用于与Thread.suspend和ThreadGroup.suspend一起，都被否决，因为他们天生就容易导致死锁。看到Thread.suspend()详情。
    
    恢复这个线程组中的所有线程。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    这个方法然后调用该线程组中，在其所有子组的所有线程的resume方法。
    
    异常
    
    SecurityException -如果当前线程不允许在线程组线程组或任何线程访问。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    SecurityException， Thread.resume()， checkAccess()
  - destroy
```
public final void destroy()
```
    破坏这个线程组和它所有的子组。这个线程组必须是空的，这表明已经在这个线程组中的所有线程已经停止了。
    首先，该线程组的checkAccess方法不带参数调用；这可能导致安全异常。
    
    异常
    
    IllegalThreadStateException -如果线程组不为空或者线程组已经被销毁。
    
    SecurityException -如果当前线程不能修改该线程组。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    checkAccess()
  - list
```
public void list()
```
    将此线程组的信息打印到标准输出。此方法只用于调试。
    
    从以下版本开始：
    
    JDK1.0
  - uncaughtException
```
public void uncaughtException(Thread t,
                              Throwable e)
```
    由java虚拟机时，一个线程，该线程组中的停止，因为未捕获的异常，和线程没有特定的 Thread.UncaughtExceptionHandler安装。
    对ThreadGroup的uncaughtException方法如下：
    - 如果线程组的父线程组，那个家长uncaughtException方法调用相同的两参数。
    - 否则，该方法检查是否安装了default uncaught exception handler，如果是的话，它的uncaughtException方法称为具有相同的两个参数。
    - 否则，该方法确定Throwable争论是ThreadDeath实例。如果是这样，没有什么特别的事。否则，包含线程的名称信息，如从线程的getName方法返回，和堆栈回溯的方法，使用Throwable printStackTrace，打印到standard error stream。
    应用程序可以重写此方法在子类ThreadGroup提供替代处理未捕获的异常。
    Specified by:
    
    uncaughtException 接口 Thread.UncaughtExceptionHandler
    
    参数
    
    t，即将退出线程。
    
    e -未捕获的异常。
    
    从以下版本开始：
    
    JDK1.0
  - allowThreadSuspension
```
@Deprecated
public boolean allowThreadSuspension(boolean b)
```
    过时的。这个调用的定义取决于suspend()，这是过时的。此外，这个调用的行为从来没有被指定。
    
    用虚拟机来控制lowmem隐式悬架。
    
    参数
    
    b -布尔允许或不允许悬挂
    
    结果
    
    真正的成功
    
    从以下版本开始：
    
    JDK1.1
  - toString
```
public String toString()
```
    返回这个线程组的字符串表示形式。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    这个线程组的字符串表示形式。
    
    从以下版本开始：
    
    JDK1.0

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ThreadGroup

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

ThreadGroup

ThreadGroup

方法详细信息

getName

getParent

getMaxPriority

isDaemon

isDestroyed

setDaemon

setMaxPriority

parentOf

checkAccess

activeCount

enumerate

enumerate

activeGroupCount

enumerate

enumerate

stop

interrupt

suspend

resume

destroy

list

uncaughtException

allowThreadSuspension

toString