ThreadGroup (Платформа Java SE 7)

java.lang. Объект
- java.lang. ThreadGroup

Все Реализованные Интерфейсы:

Поток. UncaughtExceptionHandler
```
public class ThreadGroup
extends Object
implements Thread.UncaughtExceptionHandler
```
Группа потока представляет ряд потоков. Кроме того, группа потока может также включать другие группы потока. Группы потока формируют дерево, в котором у каждой группы потока кроме начальной группы потока есть родитель.
Потоку позволяют получить доступ к информации о ее собственной группе потока, но не к информации о доступе о ее групповой родительской группе потока потока или любых других группах потока.

С тех пор:

JDK1.0

Сводка конструктора

Конструкторы
Конструктор и Описание
`ThreadGroup(String name)` Создает группу нового потока.
`ThreadGroup(ThreadGroup parent, String name)` Создает группу нового потока.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`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()` Возвращает максимальный приоритет этой группы потока.
`Строка`	`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()` для деталей.
`Строка`	`toString()` Возвращает строковое представление этой группы Потока.
`void`	`uncaughtException(Thread t, Throwable e)` Вызванный виртуальной машиной Java, когда у потока в этой группе потока остановки из-за непойманного исключения, и поток нет определенного `Thread.UncaughtExceptionHandler` установленный.

Методы java.lang унаследованный от класса. Объект
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()
```
    Тесты, если эта группа потока была уничтожена.
    
    Возвраты:
    истина, если этот объект уничтожается
    С тех пор:
    
    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 - новый приоритет группы потока.
    
    Броски:
    
    SecurityException - если текущий поток не может изменить эту группу потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    getMaxPriority(), SecurityException, checkAccess()
  - parentOf
```
public final boolean parentOf(ThreadGroup g)
```
    Тесты, если эта группа потока является или групповым параметром потока или одной из его групп потока предка.
    
    Параметры:
    g - группа потока.
    
    Возвраты:
    true если эта группа потока является групповым параметром потока или одной из его групп потока предка; false иначе.
    С тех пор:
    
    JDK1.0
  - checkAccess
```
public final void checkAccess()
```
    Определяет, есть ли у в настоящий момент рабочего потока разрешение, чтобы изменить эту группу потока.
    Если есть менеджер безопасности, checkAccess метод вызывают с этой группой потока как ее параметр. Это может привести к броску a SecurityException.
    
    Броски:
    
    SecurityException - если текущему потоку не позволяют получить доступ к этой группе потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    SecurityManager.checkAccess(java.lang.ThreadGroup)
  - activeCount
```
public int activeCount()
```
    Возвращает оценку числа активных потоков в этой группе потока и ее подгруппах. Рекурсивно выполняет итерации по всем подгруппам в этой группе потока.
    Возвращенное значение является только оценкой, потому что число потоков может измениться динамически, в то время как этот метод пересекает внутренние структуры данных, и мог бы влияться присутствием определенных системных потоков. Этот метод предназначается прежде всего для отладки и контроля целей.
    
    Возвраты:
    оценка числа активных потоков в этой группе потока и в любой другой группе потока, у которой есть эта группа потока как предок
    С тех пор:
    
    JDK1.0
  - перечислить
```
public int enumerate(Thread[] list)
```
    Копии в указанный массив каждый активный поток в этой группе потока и ее подгруппах.
    Вызов этого метода ведет себя точно таким же образом как вызов
    перечислить(list, true)
    
    Параметры:
    list - массив, в который можно поместить список потоков
    
    Возвраты:
    число потоков помещается в массив
    
    Броски:
    
    SecurityException - если checkAccess решает, что текущий поток не может получить доступ к этой группе потока
    С тех пор:
    
    JDK1.0
  - перечислить
```
public int enumerate(Thread[] list,
            boolean recurse)
```
    Копии в указанный массив каждый активный поток в этой группе потока. Если recurse true, этот метод рекурсивно перечисляет все подгруппы этой группы потока, и ссылки на каждый активный поток в этих подгруппах также включаются. Если массив слишком короток, чтобы содержать все потоки, дополнительные потоки тихо игнорируются.
    Приложение могло бы использовать activeCount метод, чтобы получить оценку того, насколько большой массив должен быть, однако если массив слишком короток, чтобы содержать все потоки, дополнительные потоки тихо игнорируются. Если является критическим получить каждый активный поток в этой группе потока, вызывающая сторона должна проверить, что возвращенное международное значение является строго меньше чем длина list.
    Из-за свойственного условия гонки в этом методе, рекомендуется, чтобы метод только использовался для отладки и контроля целей.
    
    Параметры:
    list - массив, в который можно поместить список потоков
    recurse - если true, рекурсивно перечислите все подгруппы этой группы потока
    
    Возвраты:
    число потоков помещается в массив
    
    Броски:
    
    SecurityException - если checkAccess решает, что текущий поток не может получить доступ к этой группе потока
    С тех пор:
    
    JDK1.0
  - activeGroupCount
```
public int activeGroupCount()
```
    Возвращает оценку числа активных групп в этой группе потока и ее подгруппах. Рекурсивно выполняет итерации по всем подгруппам в этой группе потока.
    Возвращенное значение является только оценкой, потому что число групп потока может измениться динамически, в то время как этот метод пересекает внутренние структуры данных. Этот метод предназначается прежде всего для отладки и контроля целей.
    
    Возвраты:
    число активных групп потока с этой группой потока как предок
    С тех пор:
    
    JDK1.0
  - перечислить
```
public int enumerate(ThreadGroup[] list)
```
    Копии в указанные ссылки массива на каждую активную подгруппу в этой группе потока и ее подгруппы.
    Вызов этого метода ведет себя точно таким же образом как вызов
    перечислить(list, true)
    
    Параметры:
    list - массив, в который можно поместить список групп потока
    
    Возвраты:
    число групп потока помещается в массив
    
    Броски:
    
    SecurityException - если checkAccess решает, что текущий поток не может получить доступ к этой группе потока
    С тех пор:
    
    JDK1.0
  - перечислить
```
public int enumerate(ThreadGroup[] list,
            boolean recurse)
```
    Копии в указанные ссылки массива на каждую активную подгруппу в этой группе потока. Если recurse true, этот метод рекурсивно перечисляет все подгруппы этой группы потока, и ссылки на каждую активную группу потока в этих подгруппах также включаются.
    Приложение могло бы использовать activeGroupCount метод, чтобы получить оценку того, насколько большой массив должен быть, однако если массив слишком короток, чтобы содержать все группы потока, дополнительные группы потока тихо игнорируются. Если является критическим получить каждую активную подгруппу в этой группе потока, вызывающая сторона должна проверить, что возвращенное международное значение является строго меньше чем длина list.
    Из-за свойственного условия гонки в этом методе, рекомендуется, чтобы метод только использовался для отладки и контроля целей.
    
    Параметры:
    list - массив, в который можно поместить список групп потока
    recurse - если true, рекурсивно перечислите все подгруппы
    
    Возвраты:
    число групп потока помещается в массив
    
    Броски:
    
    SecurityException - если checkAccess решает, что текущий поток не может получить доступ к этой группе потока
    С тех пор:
    
    JDK1.0
  - остановиться
```
@Deprecated
public final void stop()
```
    Осуждаемый. Этот метод по сути опасен. См. Thread.stop() для деталей.
    
    Остановки все потоки в этой группе потока.
    Во-первых, checkAccess метод этой группы потока вызывают без параметров; это может привести к исключению безопасности.
    Этот метод тогда вызывает stop метод на всех потоках в этой группе потока и во всех ее подгруппах.
    
    Броски:
    
    SecurityException - если текущему потоку не позволяют получить доступ к этой группе потока или какому-либо из потоков в группе потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    SecurityException, Thread.stop(), checkAccess()
  - прерывание
```
public final void interrupt()
```
    Прерывания все потоки в этой группе потока.
    Во-первых, checkAccess метод этой группы потока вызывают без параметров; это может привести к исключению безопасности.
    Этот метод тогда вызывает interrupt метод на всех потоках в этой группе потока и во всех ее подгруппах.
    
    Броски:
    
    SecurityException - если текущему потоку не позволяют получить доступ к этой группе потока или какому-либо из потоков в группе потока.
    С тех пор:
    
    1.2
    
    См. Также:
    Thread.interrupt(), SecurityException, checkAccess()
  - приостановить
```
@Deprecated
public final void suspend()
```
    Осуждаемый. Этот метод является по сути склонным к мертвой блокировке. См. Thread.suspend() для деталей.
    
    Приостанавливает все потоки в этой группе потока.
    Во-первых, checkAccess метод этой группы потока вызывают без параметров; это может привести к исключению безопасности.
    Этот метод тогда вызывает suspend метод на всех потоках в этой группе потока и во всех ее подгруппах.
    
    Броски:
    
    SecurityException - если текущему потоку не позволяют получить доступ к этой группе потока или какому-либо из потоков в группе потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    Thread.suspend(), SecurityException, checkAccess()
  - резюме
```
@Deprecated
public final void resume()
```
    Осуждаемый. Этот метод используется исключительно в соединении с Thread.suspend и ThreadGroup.suspend, оба из которых были осуждены, поскольку они являются по сути склонными к мертвой блокировке. См. Thread.suspend() для деталей.
    
    Резюме все потоки в этой группе потока.
    Во-первых, checkAccess метод этой группы потока вызывают без параметров; это может привести к исключению безопасности.
    Этот метод тогда вызывает resume метод на всех потоках в этой группе потока и во всех ее sub группах.
    
    Броски:
    
    SecurityException - если текущему потоку не позволяют получить доступ к этой группе потока или какому-либо из потоков в группе потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    SecurityException, Thread.resume(), checkAccess()
  - уничтожить
```
public final void destroy()
```
    Уничтожает эту группу потока и все ее подгруппы. Эта группа потока должна быть пустой, указывая, что все потоки, которые были в этой группе потока, с тех пор остановились.
    Во-первых, checkAccess метод этой группы потока вызывают без параметров; это может привести к исключению безопасности.
    
    Броски:
    
    IllegalThreadStateException - если группа потока не пуста или если группа потока была уже уничтожена.
    
    SecurityException - если текущий поток не может изменить эту группу потока.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    checkAccess()
  - список
```
public void list()
```
    Информация о печатных изданиях об этой группе потока к стандартному выводу. Этот метод полезен только для отладки.
    
    С тех пор:
    
    JDK1.0
  - uncaughtException
```
public void uncaughtException(Thread t,
                     Throwable e)
```
    Вызванный виртуальной машиной Java, когда у потока в этой группе потока остановки из-за непойманного исключения, и поток нет определенного Thread.UncaughtExceptionHandler установленный.
    uncaughtException метод ThreadGroup делает следующее:
    - Если у этой группы потока есть родительская группа потока, uncaughtException метод того родителя вызывают с теми же самыми двумя параметрами.
    - Иначе, этот метод проверки, чтобы видеть, есть ли непойманный обработчик исключений по умолчанию, установленный, и если так, uncaughtException метод вызывают с теми же самыми двумя параметрами.
    - Иначе, этот метод определяет если Throwable параметром является экземпляр ThreadDeath. Если так, ничто специальное не делается. Иначе, сообщение, содержащее имя потока, как возвращено из потока getName метод, и след стека, используя Throwable's printStackTrace метод, печатается к стандартному потоку сообщений об ошибках.
    Приложения могут переопределить этот метод в подклассах ThreadGroup обеспечить альтернативную обработку непойманных исключений.
    Определенный:
    
    uncaughtException в интерфейсе Thread.UncaughtExceptionHandler
    
    Параметры:
    t - поток, который собирается выйти.
    e - непойманное исключение.
    С тех пор:
    
    JDK1.0
  - allowThreadSuspension
```
@Deprecated
public boolean allowThreadSuspension(boolean b)
```
    Осуждаемый. Определение этого вызова зависит от suspend(), который осуждается. Далее, поведение этого вызова никогда не определялось.
    
    Используемый VM, чтобы управлять lowmem неявной приостановкой.
    
    Параметры:
    b - булевская переменная, чтобы позволить или отвергнуть приостановку
    
    Возвраты:
    истина на успехе
    С тех пор:
    
    JDK1.1
  - toString
```
public String toString()
```
    Возвращает строковое представление этой группы Потока.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление этой группы потока.
    С тех пор:
    
    JDK1.0

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ThreadGroup

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

ThreadGroup

ThreadGroup

Деталь метода

getName

getParent

getMaxPriority

isDaemon

isDestroyed

setDaemon

setMaxPriority

parentOf

checkAccess

activeCount

перечислить

перечислить

activeGroupCount

перечислить

перечислить

остановиться

прерывание

приостановить

резюме

уничтожить

список

uncaughtException

allowThreadSuspension

toString