Интерфейс 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() или JVM_Sleep()

static final int THREAD_STATUS_MONITOR

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

static final int THREAD_STATUS_WAIT

Поток ожидает - был вызван Object.wait() или JVM_MonitorWait()

static final int THREAD_STATUS_NOT_STARTED

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

String name()

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

void suspend()

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

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

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

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

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

Вынудить метод вернуть значение до достижения инструкции возврата.

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

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

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

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

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

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

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

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