Модуль jdk.jdi

Определяет интерфейс Java Debug Interface.

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

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

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

JDI — это самый верхний уровень архитектуры отладчика Java Platform Debugger Architecture (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, если отражаемый тип был загружен.