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()` 返回此Thread组的字符串表示形式。
`void`	`uncaughtException(Thread t, Throwable e)` 当此线程组中的线程因为一个未捕获的异常由Java Virtual Machine调用，而线程不具有特定`Thread.UncaughtExceptionHandler`安装。

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

- 构造方法详细信息
  - 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()
```
    测试此线程组是否已被破坏。
    
    结果
    
    如果此对象被销毁，则为true
    
    从以下版本开始：
    
    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.MIN_PRIORITY或大于Thread.MAX_PRIORITY ，组的最大优先级保持不变。
    
    否则，此ThreadGroup对象的优先级设置为指定的pri中的较小pri以及此线程组的父级的最大允许优先级。（如果该线程组是没有父级的系统线程组，则其最大优先级简单地设置为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 - 如果当前线程不允许访问此线程组或线程组中的任何线程。
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    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 Virtual Machine调用，而线程不具有特定Thread.UncaughtExceptionHandler安装。
    uncaughtException方法ThreadGroup以下操作：
    - 如果此线程组具有父线程组， uncaughtException使用相同的两个参数调用该父进程的uncaughtException方法。
    - 否则，此方法检查是否安装了 default uncaught exception handler，如果是，则使用相同的两个参数调用其uncaughtException方法。
    - 否则，该方法确定是否Throwable参数是的一个实例ThreadDeath 。如果是这样，没有什么特别之处。否则，包含该线程的名称的消息，如从线程的返回getName方法，以及在堆栈中，使用Throwable的printStackTrace方法，打印到standard error stream 。
    应用程序可以在ThreadGroup的ThreadGroup类中覆盖此方法，以提供未捕获异常的替代处理。
    Specified by:
    
    uncaughtException在界面 Thread.UncaughtExceptionHandler
    
    参数
    
    t - 即将退出的线程。
    
    e - 未捕获的异常。
    
    从以下版本开始：
    
    JDK1.0
  - allowThreadSuspension
```
@Deprecated
public boolean allowThreadSuspension(boolean b)
```
    已弃用此呼叫的定义取决于不推荐使用的suspend()。此外，从未指定此调用的行为。
    
    由VM用于控制lowmem隐式暂停。
    
    参数
    
    b - 布尔允许或不允许暂停
    
    结果
    
    真正的成功
    
    从以下版本开始：
    
    JDK1.1
  - toString
```
public String toString()
```
    返回此Thread组的字符串表示形式。
    
    重写：
    
    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

构造方法详细信息

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