Интерфейс WatchpointRequest

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

Все известные подинтерфейсы:: AccessWatchpointRequest, ModificationWatchpointRequest

public interface WatchpointRequest extends EventRequest

Идентифицирует Field в целевой виртуальной машине, за которым ведётся наблюдение.

Начиная с версии:

1.3

См. также:

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

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

SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE

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

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

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

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

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

toString, virtualMachine

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

field

Field field()

Возвращает поле, за которым наблюдает этот WatchpointRequest.

Возвращает:: Field, за которым наблюдает этот Watchpoint.

addThreadFilter

void addThreadFilter(ThreadReference thread)

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.jdi/com/sun/jdi/request/WatchpointRequest.html