Интерфейс ExceptionEvent

Все суперинтерфейсы:: Event, Locatable, LocatableEvent, Mirror

public interface ExceptionEvent extends LocatableEvent

Уведомление об исключении в целевой ВМ. Когда возникает исключение, удовлетворяющее действующему в данный момент exception request, в очередь событий ВМ будет добавлен event set, содержащий экземпляр этого класса. Если исключение возникает в нестандартном методе, событие исключения создаётся в месте возникновения исключения. Если исключение возникает в нативном методе, событие исключения создаётся в первой достигнутой после возникновения исключения ненативной точке.

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

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

Модификатор и тип	Метод	Описание
`Location`	`catchLocation()`	Возвращает местоположение, в котором будет перехвачено исключение.
`ObjectReference`	`exception()`	Возвращает объект возникшего исключения.

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

request

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

location

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

thread

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

toString, virtualMachine

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

exception

ObjectReference exception()

Возвращает объект возникшего исключения. Объект исключения является экземпляром Throwable или его подкласса в целевой ВМ.

Возвращает:: ObjectReference, представляющий возникший объект в целевой ВМ.

catchLocation

Location catchLocation()

Возвращает местоположение, в котором будет перехвачено исключение. Исключение считается перехваченным, если в момент его возникновения текущее местоположение динамически находится внутри оператора try, обрабатывающего это исключение. (Подробности см. в спецификации JVM.) Если такой оператор try существует, местоположением перехвата является первый индекс кода соответствующего блока catch.

Если в стеке вызовов на момент возникновения исключения имеются нативные методы, следует учитывать важные ограничения, касающиеся возвращаемого местоположения перехвата. В таких случаях невозможно предсказать, будет ли исключение обработано каким-либо нативным методом в стеке вызовов. Поэтому исключения, считающиеся здесь неперехваченными, на самом деле могут быть обработаны нативным методом и не привести к завершению целевой ВМ. Кроме того, нельзя считать, что возвращённое здесь местоположение перехвата когда-либо будет достигнуто потоком, вызвавшим исключение. Если между текущим местоположением и местоположением перехвата находится нативный кадр, исключение может быть обработано и сброшено непосредственно в этом нативном методе.

Обратите внимание, что в некоторых случаях компилятор может генерировать блоки try-catch, явно не указанные в исходном коде; например, код, сгенерированный для блоков synchronized и finally, может содержать неявные блоки try-catch. Если такой неявно сгенерированный блок try-catch присутствует в стеке вызовов в момент возникновения исключения, оно будет считаться перехваченным, даже если при изучении исходного кода кажется, что оно не перехватывается.

Возвращает:: Location, указывающее местоположение, в котором будет перехвачено исключение, или null, если исключение не перехвачено.

© 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/event/ExceptionEvent.html