Интерфейс ExceptionRequest

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

public interface ExceptionRequest extends EventRequest

Запрос на уведомление о возникновении исключения в целевой виртуальной машине. Когда удовлетворяется условие активного ExceptionRequest, объект event set, содержащий ExceptionEvent, помещается в EventQueue. Коллекцией существующих ExceptionRequest управляет EventRequestManager

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

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)`	Ограничивает генерируемые этим запросом события событиями в указанном потоке.
`ReferenceType`	`exception()`	Возвращает тип исключения, для которого запрашиваются события исключений.
`boolean`	`notifyCaught()`	Возвращает значение, указывающее, будут ли перехваченные исключения запрошенного типа генерировать события при выбрасывании.
`boolean`	`notifyUncaught()`	Возвращает значение, указывающее, будут ли неперехваченные исключения запрошенного типа генерировать события при выбрасывании.

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

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

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

toString, virtualMachine

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

exception

ReferenceType exception()

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

Возвращает:: Исключение (и его подклассы), запрошенное с помощью EventRequestManager.createExceptionRequest(ReferenceType, boolean, boolean), или null, если, как и по умолчанию, запрошены все исключения.

notifyCaught

boolean notifyCaught()

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

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

Возвращает:: boolean: true, если перехваченные исключения будут сообщаться, иначе false.

notifyUncaught

boolean notifyUncaught()

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

Обратите внимание, что в момент выбрасывания исключения не всегда можно определить, останется ли оно действительно неперехваченным. Подробности см. в описании ExceptionEvent.catchLocation().

Возвращает:: boolean: true, если перехваченные исключения будут сообщаться, иначе false.

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/ExceptionRequest.html