Интерфейс ThreadReference

static final int THREAD_STATUS_UNKNOWN

Статус потока неизвестен

static final int THREAD_STATUS_ZOMBIE

Поток завершил выполнение

static final int THREAD_STATUS_RUNNING

Поток готов к выполнению

static final int THREAD_STATUS_SLEEPING

Поток спит - Thread.sleep(long).

static final int THREAD_STATUS_MONITOR

Поток ожидает монитора Java

static final int THREAD_STATUS_WAIT

Поток ожидает - Object.wait() или LockSupport.park(). Виртуальный поток, находящийся в режиме ожидания в Thread.sleep(long), может иметь этот статус потока вместо THREAD_STATUS_SLEEPING.

static final int THREAD_STATUS_NOT_STARTED

Поток еще не запущен

String name()

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

void suspend()

Приостанавливает этот поток. Поток можно возобновить через resume() или возобновить с другими потоками через VirtualMachine.resume().

Приостановки как виртуальной машины, так и отдельных потоков считаются. Перед тем, как поток сможет запуститься снова, его необходимо возобновить (через resume() или VirtualMachine.resume()) столько же раз, сколько он был приостановлен.

Приостановка отдельных потоков с помощью этого метода потенциально может привести к тупиковой ситуации. Если приостановленный поток удерживает монитор, необходимый другому работающему потоку, в целевой виртуальной машине может возникнуть тупик (по крайней мере, до тех пор, пока приостановленный поток не будет возобновлен снова).

Приостановленный поток гарантированно останется приостановленным до его возобновления с помощью одного из методов возобновления JDI, упомянутых выше.

void resume()

Возобновляет этот поток. Если этот поток ранее не был приостановлен с помощью suspend() или через VirtualMachine.suspend(), или из-за события SUSPEND_ALL или SUSPEND_EVENT_THREAD, вызов этого метода не оказывает никакого эффекта. В противном случае количество ожидаемых приостановок для этого потока уменьшается. Если оно уменьшается до 0, поток продолжит выполнение. Примечание: стандартный способ возобновления из приостановки, связанной с событием, — EventSet.resume().

int suspendCount()

Возвращает количество ожидаемых приостановок для этого потока. См. suspend() для объяснения подсчета приостановок.

void stop(ObjectReference throwable) throws InvalidTypeException

Останавливает этот поток с асинхронным исключением. Поток отладчика в целевой виртуальной машине остановит этот поток с заданным объектом Throwable.

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

void interrupt()

Прерывает этот поток, если он не приостановлен дебаггером.

int status()

Возвращает статус потока. Если поток не приостановлен, возвращается текущий статус потока. Если поток приостановлен, возвращается статус потока до приостановки (или THREAD_STATUS_UNKNOWN, если эта информация недоступна. isSuspended() может использоваться для определения, был ли поток приостановлен).

boolean isSuspended()

Определяет, был ли поток приостановлен отладчиком.

boolean isAtBreakpoint()

Определяет, приостановлен ли поток на точке останова.

ThreadGroupReference threadGroup()

Возвращает группу потоков этого потока.

int frameCount() throws IncompatibleThreadStateException

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

List<StackFrame> frames() throws IncompatibleThreadStateException

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

StackFrame frame(int index) throws IncompatibleThreadStateException

Возвращает StackFrame по заданному индексу в текущей стеке вызовов потока. Индекс 0 возвращает текущую рамку; более высокие индексы возвращают кадры вызывающих функций. Поток должен быть приостановлен (обычно через прерывание виртуальной машины), чтобы получить эту информацию, и она действительна только до возобновления потока.

List<StackFrame> frames(int start, int length) throws IncompatibleThreadStateException

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

List<ObjectReference> ownedMonitors() throws IncompatibleThreadStateException

Возвращает список, содержащий ObjectReference для каждого монитора, принадлежащего потоку. Монитор принадлежит потоку, если он был введён (через оператор synchronized или вход в синхронизированный метод) и не был освобожден через Object.wait().

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canGetOwnedMonitorInfo(), чтобы определить, поддерживается ли операция.

List<MonitorInfo> ownedMonitorsAndFrames() throws IncompatibleThreadStateException

Возвращает список, содержащий объект MonitorInfo для каждого монитора, принадлежащего потоку. Монитор принадлежит потоку, если он был введён (через оператор synchronized или вход в синхронизированный метод) и не был освобожден через Object.wait().

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canGetMonitorFrameInfo(), чтобы определить, поддерживается ли операция.

ObjectReference currentContendedMonitor() throws IncompatibleThreadStateException

Возвращает ObjectReference для монитора, если таковой имеется, в ожидании которого находится данный поток. Поток может ожидать монитора, войдя в синхронизированный метод, оператор synchronized или вызов Object.wait(). Метод status() можно использовать для различения первых двух случаев и третьего.

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canGetCurrentContendedMonitor(), чтобы определить, поддерживается ли операция.

void popFrames(StackFrame frame) throws IncompatibleThreadStateException

Выталкивает кадры стека.

Все кадры до и включая указанный frame удаляются из стека. Кадр, предшествующий параметру frame , становится текущим кадром.

После этой операции этот поток будет приостановлен в инструкции вызова целевого метода, который создал frame. Метод frame может быть повторно вошёл с шагом в инструкцию.

Стек операндов восстанавливается, однако любые изменения аргументов, произошедшие в вызываемом методе, сохраняются. Например, если метод foo:

    void foo(int x) {
        System.out.println("Foo: " + x);
        x = 4;
        System.out.println("pop here");
    }
 

был вызван с foo(7) и foo выталкивается во втором println и возобновляется, будет выведено: Foo: 4.

Блокировки, полученные вытолкнутым кадром, освобождаются при его выталкивании. Это относится к синхронизированным методам, которые выталкиваются, и к любым синхронизированным блокам в них.

Блоки finally не выполняются.

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

Этот поток должен быть приостановлен.

Все StackFrame объекты для этого потока делают недействительными.

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

События этим методом не генерируются.

Ни один из кадров до и включая кадр вызывающего frame не может быть нативным.

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canPopFrames(), чтобы определить, поддерживается ли операция.

void forceEarlyReturn(Value value) throws InvalidTypeException, ClassNotLoadedException, IncompatibleThreadStateException

Принудительно завершить метод до достижения инструкции return.

Метод, который будет завершен досрочно, называется вызываемым методом. Вызываемый метод — это текущий метод (как определено в разделе "Frames" спецификации Java Virtual Machine) для указанного потока в момент вызова этого метода.

Поток должен быть приостановлен. Возврат происходит при возобновлении выполнения кода языка программирования Java в этом потоке. Состояние стека между вызовом этого метода и возобновлением выполнения потока не определено.

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

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

Блокировка, полученная вызовом вызываемого метода (если это синхронизированный метод), и блокировки, полученные при входе в синхронизированные блоки внутри вызываемого метода, будут освобождены. Примечание: это не относится к нативным блокировкам или блокировкам java.util.concurrent.locks.

События, такие как MethodExit, генерируются так же, как и при обычном возврате.

Вызываемый метод должен быть не-нативным методом языка программирования Java. Принудительный возврат в потоке с одной рамкой стека приводит к завершению потока при возобновлении.

Аргумент value — это значение, которое метод должен вернуть. Если тип возврата метода void, то значение должно быть объектом типа VoidValue. Объектные значения должны быть совместимы с типом возврата метода (Это подразумевает, что тип возврата метода должен быть загружен через загрузчик классов содержащего класса). Примитивные значения должны быть либо совместимы с типом возврата метода, либо должны быть конвертированы в тип переменной без потери информации. См. раздел JLS 5.2 для получения дополнительной информации о совместимости присваивания.

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canForceEarlyReturn() для определения поддержки операции.

default boolean isVirtual()

Возвращает true значение, если поток является виртуальным потоком.