Интерфейс ThreadGroupReference

Все суперинтерфейсы:: Mirror, ObjectReference, Value

public interface ThreadGroupReference extends ObjectReference

Объект группы потоков из целевой виртуальной машины. ThreadGroupReference — это ObjectReference с дополнительным доступом к информации о группах потоков в целевой виртуальной машине.

Появился в версии:: 1.3

Краткое описание полей

Поля, объявленные в интерфейсе ObjectReference

INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED

Модификатор и тип	Поле	Описание
`static final int`	`INVOKE_NONVIRTUAL`	Выполняет вызов невиртуального метода
`static final int`	`INVOKE_SINGLE_THREADED`	Выполняет вызов метода, возобновляя выполнение только вызывающего потока

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`name()`	Возвращает имя этой группы потоков.
`ThreadGroupReference`	`parent()`	Возвращает родительскую группу этой группы потоков.
`void`	`resume()`	Возобновляет выполнение всех потоков в этой группе потоков.
`void`	`suspend()`	Приостанавливает выполнение всех потоков в этой группе потоков.
`List<ThreadGroupReference>`	`threadGroups()`	Возвращает список, содержащий `ThreadGroupReference` для каждой подгруппы.
`List<ThreadReference>`	`threads()`	Возвращает список, содержащий `ThreadReference` для каждого работающего платформенного потока в этой группе потоков.

Методы, объявленные в интерфейсе Mirror

toString, virtualMachine

Модификатор и тип	Метод	Описание
`String`	`toString()`	Возвращает строку с описанием этого зеркала
`VirtualMachine`	`virtualMachine()`	Возвращает VirtualMachine, которой принадлежит это зеркало.

Методы, объявленные в интерфейсе ObjectReference

disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, referringObjects, setValue, uniqueID, waitingThreads

Модификатор и тип	Метод	Описание
`void`	`disableCollection()`	Предотвращает сборку мусора для этого объекта.
`void`	`enableCollection()`	Разрешает сборку мусора для этого объекта.
`int`	`entryCount()`	Возвращает количество раз, которое монитор этого объекта был захвачен текущим владеющим потоком, если владеющий поток является платформенным; возвращает 0, если объект не принадлежит платформенному потоку.
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим ObjectReference на равенство.
`Value`	`getValue(Field sig)`	Получает значение заданного нестатического или статического поля этого объекта.
`Map<Field,Value>`	`getValues(List<? extends Field> fields)`	Получает значения нескольких нестатических и/или статических полей этого объекта.
`int`	`hashCode()`	Возвращает хеш-код этого ObjectReference.
`Value`	`invokeMethod(ThreadReference thread, Method method, List<? extends Value> arguments, int options)`	Вызывает указанный `Method` для этого объекта в целевой виртуальной машине.
`boolean`	`isCollected()`	Определяет, был ли этот объект удалён сборщиком мусора в целевой виртуальной машине.
`ThreadReference`	`owningThread()`	Возвращает `ThreadReference` платформенного потока, если таковой имеется, который в данный момент владеет монитором этого объекта.
`ReferenceType`	`referenceType()`	Возвращает `ReferenceType`, представляющий тип этого объекта.
`List<ObjectReference>`	`referringObjects(long maxReferrers)`	Возвращает объекты, которые непосредственно ссылаются на этот объект.
`void`	`setValue(Field field, Value value)`	Задаёт значение указанного нестатического или статического поля этого объекта.
`long`	`uniqueID()`	Возвращает уникальный идентификатор этого ObjectReference.
`List<ThreadReference>`	`waitingThreads()`	Возвращает список, содержащий `ThreadReference` для каждого платформенного потока, ожидающего в данный момент освобождения монитора этого объекта.

Методы, объявленные в интерфейсе Value

type

Модификатор и тип	Метод	Описание
`Type`	`type()`	Возвращает тип этого значения во время выполнения.

Подробное описание методов

name

String name()

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

Возвращает:: строку, содержащую имя группы потоков.

parent

ThreadGroupReference parent()

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

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

suspend

void suspend()

Приостанавливает выполнение всех потоков в этой группе потоков. Выполнение каждого потока в этой группе и во всех её подгруппах будет приостановлено, как описано в ThreadReference.suspend(). Атомарность этой операции не гарантируется; если целевая виртуальная машина не прервана в момент вызова этого метода, между перечислением потоков и приостановкой выполнения всех из них могут быть созданы новые потоки.

Выбрасывает:: VMCannotBeModifiedException — если виртуальная машина доступна только для чтения — см. VirtualMachine.canBeModified().

resume

void resume()

Возобновляет выполнение всех потоков в этой группе потоков. Выполнение каждого потока в этой группе и во всех её подгруппах будет возобновлено, как описано в ThreadReference.resume().

Выбрасывает:: VMCannotBeModifiedException — если виртуальная машина доступна только для чтения — см. VirtualMachine.canBeModified().

threads

List<ThreadReference> threads()

Возвращает список, содержащий ThreadReference для каждого работающего платформенного потока в этой группе потоков. Виртуальные потоки не включаются. Возвращаются только работающие платформенные потоки из этой непосредственной группы потоков (но не из её подгрупп). Поток считается работающим, если он был запущен и не завершился.

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

threadGroups

List<ThreadGroupReference> threadGroups()

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

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.