Модуль jdk.jdi

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

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

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

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, если отражённый тип был выгружен.