Модуль jdk.jdi

Определяет интерфейс отладки Java.

Интерфейс отладки Java (JDI) — это высокоуровневый API Java, предоставляющий информацию, полезную отладчикам и аналогичным системам, которым необходим доступ к состоянию работающей (обычно удалённой) виртуальной машины.

JDI предоставляет интроспективный доступ к состоянию работающей виртуальной машины, классам, массивам, интерфейсам и примитивным типам, а также экземплярам этих типов.

JDI также предоставляет явное управление выполнением виртуальной машины: возможность приостанавливать и возобновлять потоки, устанавливать точки останова, точки наблюдения и т. д.; получать уведомления об исключениях, загрузке классов, создании потоков и т. д.; проверять состояние приостановленного потока, локальные переменные, трассировку стека и т. д.

JDI — это самый высокий уровень архитектуры отладки платформы Java (JPDA).

Этот модуль включает простую отладочную программу командной строки jdb.

Глобальные исключения

В этом разделе описаны исключения, применимые ко всему API и поэтому не описанные для отдельных методов.

VMMismatchException

Любой метод интерфейса Mirror, принимающий Mirror в качестве параметра напрямую или косвенно (например, как элемент в List), выбросит VMMismatchException, если зеркала относятся к разным виртуальным машинам.

NullPointerException

Любой метод, принимающий Object в качестве параметра, выбросит NullPointerException, если напрямую или косвенно передано значение null, — кроме случаев, когда null явно указан как допустимый параметр.

ПРИМЕЧАНИЕ. Перечисленные ниже исключения могут быть выброшены при выполнении указанных условий, однако гарантия их выбрасывания существует только тогда, когда невозможно вернуть допустимый результат.

VMDisconnectedException

Любой метод интерфейсов ObjectReference, ReferenceType, EventRequest, StackFrame или VirtualMachine, а также любой метод, принимающий один из этих типов напрямую или косвенно в качестве параметра, может выбросить VMDisconnectedException, если целевая виртуальная машина отключена, а событие VMDisconnectEvent уже было или может быть получено из EventQueue.

VMOutOfMemoryException

Любой метод интерфейсов ObjectReference, ReferenceType, EventRequest, StackFrame или VirtualMachine, а также любой метод, принимающий один из этих типов напрямую или косвенно в качестве параметра, может выбросить VMOutOfMemoryException, если в целевой виртуальной машине закончилась память.

ObjectCollectedException

Любой метод интерфейса ObjectReference или любой метод, принимающий ObjectReference в качестве параметра напрямую или косвенно, может выбросить ObjectCollectedException, если зеркальный объект был удалён сборщиком мусора.

Любой метод интерфейса ReferenceType или любой метод, принимающий ReferenceType в качестве параметра напрямую или косвенно, может выбросить ObjectCollectedException, если зеркальный тип был выгружен.