Интерфейс ExceptionRequest

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

public interface ExceptionRequest extends EventRequest

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

С момента:

1.3

См. также:

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

Поля, объявленные в интерфейсе com.sun.jdi.request.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()`	Возвращает, будут ли незахваченные исключения запрошенного типа генерировать события при их возникновении.

Методы, объявленные в интерфейсе com.sun.jdi.request.EventRequest

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

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

toString, virtualMachine

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

exception

ReferenceType exception()

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

Возвращает:: Исключение (и его подклассы), запрошенное с помощью EventRequestManager.createExceptionRequest(com.sun.jdi.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, 2023, 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/21/docs/api/jdk.jdi/com/sun/jdi/request/ExceptionRequest.html