Интерфейс ExceptionRequest

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

public interface ExceptionRequest
extends EventRequest

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

С момента:: 1.3
См. также:: ExceptionEvent, EventQueue, EventRequestManager

Поля

Поля, объявленные в интерфейсе 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