Класс ThreadGroup

public ThreadGroup(String name)

Создаёт новую группу потоков. Родительской группой для этой новой группы является группа потоков текущего выполняющегося потока.

Метод checkAccess родительской группы потоков вызывается без аргументов; это может привести к исключению безопасности.

public ThreadGroup(ThreadGroup parent, String name)

Создаёт новую группу потоков. Родительской группой для этой новой группы является указанная группа потоков.

Метод checkAccess родительской группы потоков вызывается без аргументов; это может привести к исключению безопасности.

public final String getName()

Возвращает имя этой группы потоков.

public final ThreadGroup getParent()

Возвращает родителя этой группы потоков.

Сначала, если родитель не null, метод checkAccess родительской группы потоков вызывается без аргументов; это может привести к исключению безопасности.

public final int getMaxPriority()

Возвращает максимальный приоритет этой группы потоков. Потоки, которые являются частью этой группы, не могут иметь приоритет выше максимального приоритета.

@Deprecated(since="16", forRemoval=true) public final boolean isDaemon()

Проверяет, является ли эта группа потоков демонической группой потоков. Демоническая группа потоков автоматически уничтожается, когда её последний поток остановлен или её последняя группа потоков уничтожена.

@Deprecated(since="16", forRemoval=true) public boolean isDestroyed()

Проверяет, была ли эта группа потоков уничтожена.

@Deprecated(since="16", forRemoval=true) public final void setDaemon(boolean daemon)

Изменяет состояние демона этой группы потоков.

Сначала метод checkAccess этой группы потоков вызывается без аргументов; это может привести к исключению безопасности.

Демоническая группа потоков автоматически уничтожается, когда её последний поток остановлен или её последняя группа потоков уничтожена.

public final void setMaxPriority(int pri)

Устанавливает максимальный приоритет группы. Потоки в группе потоков, которые уже имеют более высокий приоритет, не затрагиваются.

Сначала метод checkAccess этой группы потоков вызывается без аргументов; это может привести к исключению безопасности.

Если аргумент pri меньше Thread.MIN_PRIORITY или больше Thread.MAX_PRIORITY, максимальный приоритет группы остаётся неизменным.

В противном случае приоритет этого объекта ThreadGroup устанавливается в меньшее из указанного pri и максимального разрешённого приоритета родителя этой группы потоков. (Если эта группа потоков является системной группой потоков, у которой нет родителя, то её максимальный приоритет просто устанавливается в pri.) Затем этот метод вызывается рекурсивно, с pri в качестве аргумента, для каждой группы потоков, которая принадлежит этой группе потоков.

public final boolean parentOf(ThreadGroup g)

Проверяет, является ли эта группа потоков аргументом группы потоков или одной из её предковой группы потоков.

@Deprecated(since="17", forRemoval=true) public final void checkAccess()

Определяет, имеет ли текущий выполняемый поток разрешение на изменение этой группы потоков.

Если существует менеджер безопасности, его метод checkAccess вызывается с этой группой потоков в качестве аргумента. Это может привести к броску SecurityException.

public int activeCount()

Возвращает оценку количества активных потоков в этой группе потоков и её подгруппах. Рекурсивно перебирает все подгруппы в этой группе потоков.

Возвращаемое значение является только оценкой, потому что количество потоков может динамически изменяться во время прохождения этого метода по внутренним структурам данных и может зависеть от наличия определённых системных потоков. Этот метод предназначен в первую очередь для отладки и мониторинга.

public int enumerate(Thread[] list)

Копирует в указанный массив каждый активный поток в этой группе потоков и её подгруппах.

Вызов этого метода ведет себя точно так же, как вызов

перечислить(list, true)

public int enumerate(Thread[] list, boolean recurse)

Копирует в указанный массив каждый активный поток в этой группе потоков. Если recurse равно true, этот метод рекурсивно перечисляет все подгруппы этой группы потоков, и ссылки на каждый активный поток в этих подгруппах также включаются. Если массив слишком короткий, чтобы вместить все потоки, дополнительные потоки игнорируются.

Приложение может использовать метод activeCount, чтобы получить оценку того, какой длины должен быть массив, однако если массив слишком короткий, чтобы вместить все потоки, дополнительные потоки игнорируются. Если критически важно получить каждый активный поток в этой группе потоков, вызывающий метод должен проверить, что возвращаемое значение int строго меньше длины list.

Из-за внутренней гонки в этом методе рекомендуется использовать его только для отладки и мониторинга.

public int activeGroupCount()

Возвращает оценку количества активных групп в этой группе потоков и её подгруппах. Рекурсивно итерирует по всем подгруппам в этой группе потоков.

Возвращаемое значение является лишь оценкой, так как количество групп потоков может динамически меняться, пока этот метод обходит внутренние структуры данных. Этот метод предназначен в первую очередь для отладки и мониторинга.

public int enumerate(ThreadGroup[] list)

Копирует в указанный массив ссылки на каждую активную подгруппу в этой группе потоков и её подгруппах.

Вызов этого метода ведет себя точно так же, как вызов

перечислить(list, true)

public int enumerate(ThreadGroup[] list, boolean recurse)

Копирует в указанный массив ссылки на каждую активную подгруппу в этой группе потоков. Если recurse равно true, этот метод рекурсивно перечисляет все подгруппы этой группы потоков, и ссылки на каждую активную группу потоков в этих подгруппах также включаются.

Приложение может использовать метод activeGroupCount, чтобы получить оценку того, какой длины должен быть массив, однако если массив слишком короткий, чтобы вместить все группы потоков, дополнительные группы потоков игнорируются. Если критически важно получить каждую активную подгруппу в этой группе потоков, вызывающий метод должен проверить, что возвращаемое значение int строго меньше длины list.

Из-за внутренней гонки в этом методе рекомендуется использовать его только для отладки и мониторинга.

@Deprecated(since="1.2", forRemoval=true) public final void stop()

Останавливает все потоки в этой группе потоков.

Сначала вызывается метод checkAccess этой группы потоков без аргументов; это может привести к исключению безопасности.

Затем этот метод вызывает метод stop для всех потоков в этой группе потоков и всех её подгрупп.

public final void interrupt()

Прерывает все потоки в этой группе потоков.

Сначала вызывается метод checkAccess этой группы потоков без аргументов; это может привести к исключению безопасности.

Затем этот метод вызывает метод interrupt для всех потоков в этой группе потоков и всех её подгрупп.

@Deprecated(since="1.2", forRemoval=true) public final void suspend()

Приостанавливает все потоки в этой группе потоков.

Сначала вызывается метод checkAccess этой группы потоков без аргументов; это может привести к исключению безопасности.

Затем этот метод вызывает метод suspend для всех потоков в этой группе потоков и всех её подгрупп.

@Deprecated(since="1.2", forRemoval=true) public final void resume()

Возобновляет все потоки в этой группе потоков.

Сначала вызывается метод checkAccess этой группы потоков без аргументов; это может привести к исключению безопасности.

Затем этот метод вызывает метод resume для всех потоков в этой группе потоков и всех её подгрупп.

@Deprecated(since="16", forRemoval=true) public final void destroy()

Уничтожает эту группу потоков и все её подгруппы. Эта группа потоков должна быть пустой, указывая, что все потоки, которые находились в этой группе потоков, с тех пор остановились.

Сначала вызывается метод checkAccess этой группы потоков без аргументов; это может привести к исключению безопасности.

public void list()

Выводит информацию об этой группе потоков в стандартный вывод. Этот метод полезен только для отладки.

public void uncaughtException(Thread t, Throwable e)

Вызывается виртуальной машиной Java, когда поток в этой группе потоков завершается из-за необработанного исключения, и поток не имеет установленного специфического обработчика Thread.UncaughtExceptionHandler.

Метод uncaughtException группы ThreadGroup выполняет следующее:

• Если у этой группы потоков есть родительская группа потоков, вызывается метод uncaughtException этой родительской группы с теми же двумя аргументами.
• В противном случае, этот метод проверяет, установлен ли по умолчанию обработчик необработанных исключений, и если да, то вызывается его метод uncaughtException с теми же двумя аргументами.
• В противном случае, этот метод определяет, является ли аргумент Throwable экземпляром ThreadDeath. Если да, то ничего особенного не происходит. В противном случае, выводится сообщение, содержащее имя потока, полученное из метода потока getName, и стек-трейс, используя метод Throwable printStackTrace, в поток стандартных сообщений об ошибках.

Приложения могут переопределять этот метод в подклассах ThreadGroup для альтернативной обработки необработанных исключений.

@Deprecated(since="1.2", forRemoval=true) public boolean allowThreadSuspension(boolean b)

Используется ВМ для управления неявной приостановкой при низком объеме памяти.

public String toString()

Возвращает строковое представление этой группы потоков.