Интерфейс StepRequest

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

public interface StepRequest extends EventRequest

Запрос на уведомление о выполнении шага в целевой виртуальной машине. Когда удовлетворяется условие включённого StepRequest, event set, содержащий StepEvent, помещается в EventQueue. Коллекцией существующих StepRequest управляет EventRequestManager

Начиная с:

1.3

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`STEP_INTO`	Войти во все вновь добавленные кадры
`static final int`	`STEP_LINE`	Выполнить шаг до следующего местоположения в другой строке
`static final int`	`STEP_MIN`	Выполнить шаг до следующего доступного местоположения
`static final int`	`STEP_OUT`	Выйти из текущего кадра
`static final int`	`STEP_OVER`	Перешагнуть через все вновь добавленные кадры

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

SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE

Модификатор и тип	Поле	Описание
`static final int`	`SUSPEND_ALL`	При возникновении события приостановить все потоки
`static final int`	`SUSPEND_EVENT_THREAD`	При возникновении события приостановить только поток, вызвавший это событие
`static final int`	`SUSPEND_NONE`	При возникновении события не приостанавливать потоки

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

Модификатор и тип	Метод	Описание
`void`	`addClassExclusionFilter(String classPattern)`	Ограничивает события, создаваемые этим запросом, только теми, местоположение которых находится в классе, имя которого не соответствует заданному регулярному выражению.
`void`	`addClassFilter(ReferenceType refType)`	Ограничивает события, создаваемые этим запросом, только теми, местоположение которых находится в указанном ссылочном типе или любом из его подтипов.
`void`	`addClassFilter(String classPattern)`	Ограничивает события, создаваемые этим запросом, только теми, местоположение которых находится в классе, имя которого соответствует заданному регулярному выражению.
`void`	`addInstanceFilter(ObjectReference instance)`	Ограничивает события, создаваемые этим запросом, только теми, в которых текущий исполняемый экземпляр («this») является указанным объектом.
`int`	`depth()`
`int`	`size()`
`ThreadReference`	`thread()`

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

addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy

Модификатор и тип	Метод	Описание
`void`	`addCountFilter(int count)`	Ограничивает число сообщений о запрошенном событии одним после заданного количества его возникновений.
`void`	`disable()`	То же, что и `setEnabled(false)`.
`void`	`enable()`	То же, что и `setEnabled(true)`.
`Object`	`getProperty(Object key)`	Возвращает значение свойства с указанным ключом.
`boolean`	`isEnabled()`	Определяет, включён ли в данный момент этот запрос события.
`void`	`putProperty(Object key, Object value)`	Добавляет к этому запросу произвольное свойство «ключ/значение».
`void`	`setEnabled(boolean val)`	Включает или отключает этот запрос события.
`void`	`setSuspendPolicy(int policy)`	Определяет, какие потоки приостановить при возникновении запрошенного события в целевой виртуальной машине.
`int`	`suspendPolicy()`	Возвращает значение, указывающее, какие потоки приостановить при возникновении запрошенного события в целевой виртуальной машине.

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

toString, virtualMachine

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

Подробное описание полей

STEP_INTO

static final int STEP_INTO

Войти во все вновь добавленные кадры

См. также:

STEP_OVER

static final int STEP_OVER

Перешагнуть через все вновь добавленные кадры

См. также:

STEP_OUT

static final int STEP_OUT

Выйти из текущего кадра

См. также:

STEP_MIN

static final int STEP_MIN

Выполнить шаг до следующего доступного местоположения

См. также:

STEP_LINE

static final int STEP_LINE

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

См. также:

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

thread

ThreadReference thread()

Возвращает:: поток, для которого запрашивается событие пошагового выполнения.

size

int size()

Возвращает:: размер шага

depth

int depth()

Возвращает:: глубину шага

addClassFilter

void addClassFilter(ReferenceType refType)

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

Параметры:: refType — ссылочный тип, по которому выполняется фильтрация.
Исключения:: InvalidRequestStateException — если этот запрос в данный момент включён или был удалён. Фильтры можно добавлять только к отключённым запросам.

addClassFilter

void addClassFilter(String classPattern)

Ограничивает события, создаваемые этим запросом, только теми, местоположение которых находится в классе, имя которого соответствует заданному регулярному выражению. Регулярные выражения могут содержать только точные совпадения и шаблоны, начинающиеся с «*» или заканчивающиеся на «*»; например, "*.Foo" или "java.*".

Параметры:: classPattern — строка шаблона для фильтрации.
Исключения:: InvalidRequestStateException — если этот запрос в данный момент включён или был удалён. Фильтры можно добавлять только к отключённым запросам.

addClassExclusionFilter

void addClassExclusionFilter(String classPattern)

Ограничивает события, создаваемые этим запросом, только теми, местоположение которых находится в классе, имя которого не соответствует заданному регулярному выражению. Регулярные выражения могут содержать только точные совпадения и шаблоны, начинающиеся с «*» или заканчивающиеся на «*»; например, "*.Foo" или "java.*".

Параметры:: classPattern — строка шаблона, по которой выполняется фильтрация.
Исключения:: InvalidRequestStateException — если этот запрос в данный момент включён или был удалён. Фильтры можно добавлять только к отключённым запросам.

addInstanceFilter

void addInstanceFilter(ObjectReference instance)

Ограничивает события, создаваемые этим запросом, только теми, в которых текущий исполняемый экземпляр («this») является указанным объектом.

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

Параметры:: instance — объект, который должен быть текущим экземпляром, чтобы пройти этот фильтр.
Исключения:: UnsupportedOperationException — если целевая виртуальная машина не поддерживает эту операцию.; InvalidRequestStateException — если этот запрос в данный момент включён или был удалён. Фильтры можно добавлять только к отключённым запросам.
Начиная с:: 1.4

© 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.