モジュール jdk.jdi

Javaデバッグ・インタフェースを定義します。

Java™Debug Interface (JDI)は、デバッガや(通常はリモートの)仮想マシンの実行状態にアクセスする必要がある類似のシステムに役立つ情報を提供する、高レベルのJava APIです。

JDIは、実行中の仮想マシンの状態、クラス、配列、インタフェース、プリミティブ型、およびそれらの型のインスタンスへのイントロスペクティブ・アクセスを提供します。

JDIでは、仮想マシンの実行を明示的に制御することもできます。 スレッドを一時停止および再開し、ブレークポイント、ウォッチポイントなどを設定する機能。例外、クラス・ロード、スレッド作成などの通知中断されたスレッドの状態、ローカル変数、スタック・バックトレースなどを検査する機能。

JDIは、Java Platform Debugger Architecture (JPDA)の最上位レイヤーです。

このモジュールには、単純なコマンドライン・デバッガjdbが含まれています。

グローバル例外

このセクションでは、API全体に適用されるため、個々のメソッドでは説明していない例外について説明します。

VMMismatchException

List内の要素として使う場合など、Mirrorを直接的または間接的にパラメータとして取るMirrorの任意のメソッドは、別の仮想マシンによって作成されたミラーが存在する場合にVMMismatchExceptionをスローします。

NullPointerException

パラメータとしてObjectをとるメソッドは、nullが有効なパラメータとして明示的に説明されていないかぎり、nullが直接または間接的に渡された場合に、NullPointerExceptionをスローします。

ノート: 下記の例外は、指定した条件を満たす場合にスローされることがありますが、それらがスローされるのは、有効な結果を返すことができない場合に限られます。

VMDisconnectedException

ObjectReference、ReferenceType、EventRequest、StackFrame、またはVirtualMachineのすべてのメソッドまたは、これらのいずれかをパラメータとして直接または間接的にとるメソッドは、ターゲットのVMが切断されVMDisconnectEventがEventQueueから読み取られているか、読取りに使用できる場合に、VMDisconnectedExceptionをスローすることがあります。

VMOutOfMemoryException

ObjectReference、ReferenceType、EventRequest、StackFrame、またはVirtualMachineのすべてのメソッドまたは、これらのいずれかをパラメータとして直接または間接的にとるメソッドは、ターゲットのVMのメモリーが不足した場合に、VMOutOfMemoryExceptionをスローすることがあります。

ObjectCollectedException

ObjectReferenceのすべてのメソッドまたはObjectReferenceをパラメータとして直接的または間接的にとるメソッドは、ミラー・オブジェクトがガベージ・コレクトされた場合にObjectCollectedExceptionをスローすることがあります。

ReferenceTypeのすべてのメソッドまたはReferenceTypeをパラメータとして直接的または間接的にとるメソッドは、ミラーされた型がアンロードされた場合にObjectCollectedExceptionをスローすることがあります。

ツールガイド:
jdb

モジュール・グラフ:
jdk.jdiのモジュール・グラフjdk.jdiのモジュール・グラフ
導入されたバージョン:
9
関連項目:
Java Platform Debugger Architecture (JPDA)