Модуль jdk.jdi

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

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

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

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