Spec-Zone.ru › OpenJDK 17

Интерфейс ExceptionEvent

Все суперинтерфейсы:
Event, Locatable, LocatableEvent, Mirror
public interface ExceptionEvent extends LocatableEvent
Уведомление об исключении в целевой виртуальной машине. Когда возникает исключение, которое удовлетворяет текуще включённому exception request, в очередь событий виртуальной машины будет добавлен event set, содержащий экземпляр этого класса. Если исключение возникает из не-родного метода, событие исключения генерируется в месте, где исключение возникает. Если исключение возникает из родного метода, событие исключения генерируется в первой не-родной позиции, достигнутой после возникновения исключения.
С:
1.3

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

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

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

request

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

location

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

thread

Методы, объявленные в интерфейсе com.sun.jdi.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, 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/event/ExceptionEvent.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API