Java Debug Interface

JavaTM Debug Interface

The JavaTM デバッグインタフェースは、仮想マシン (通常はリモート) の実行中にアクセスが必要なデバッガや類似システムに有用な情報を提供するハイレベルな Java API です。

参照先:
          説明

パッケージ
com.sun.jdi Java Debug Interface (JDI) のコアパッケージで、ブートストラップ機能以外に、値、型、およびターゲット仮想マシン自体に対するミラーを定義します。
com.sun.jdi.connect このパッケージには、JDI を使用して、この仮想マシンとターゲットの仮想マシン間の接続を定義します。
com.sun.jdi.connect.spi このパッケージは、新しい TransportService の実装を開発するために使用されるインタフェースおよびクラスで構成されています。
com.sun.jdi.event このパッケージは、JDI イベントとイベント処理を定義します。
com.sun.jdi.request このパッケージは、指定された条件下で JDI イベントが送信されることを要求する場合に使用されます。

 

The JavaTM デバッグインタフェースは、仮想マシン (通常はリモート) の実行中にアクセスが必要なデバッガや類似システムに有用な情報を提供するハイレベルな Java API です。

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

また JDI では仮想マシンの実行を明示的に制御します。この機能には次のようなものが含まれます。スレッドの中断や再開、ブレークポイントやウオッチポイントの設定、例外、クラスローディング、スレッド作成の通知、中断されたスレッド状態、ローカル変数、スタックバックトレースの検査。

JDI は Java Platform Debugger Architecture (JPDA) の最上層です。 このリリースの JPDA の詳細については Java Platform Debugger Architecture マニュアル および Java Platform Debugger Architecture のウェブサイト を参照してください。

汎用例外

ここでは API 全体に適用されるため個々のメソッドには記載されない例外を記載します。

VMMismatchException

Mirror を直接的または間接的にパラメータとして使用するすべての Mirror 上のメソッド (List のエレメントなど) は、異なる仮想マシンからミラー化が行われると VMMismatchException をスローします。

NullPointerException

Object をパラメータとして使用するすべてのメソッドは、null が直接的または間接的に渡されると NullPointerException をスローします。null が有効なパラメータとして明示的に宣言されている場合はスローしません。

注: 以下の例外は特定の条件が満たされるたびにスローされる可能性がありますが、有効な結果が返されない場合のみスローされます。

VMDisconnectedException

ObjectReferenceReferenceTypeEventRequestStackFrameVirtualMachine、またはこれらのいずれかを直接的または間接的にパラメータとして使用するすべてのメソッドは、ターゲット VM が切断されて VMDisconnectEventEventQueueから読み込める場合に VMDisconnectedException をスローします。

VMOutOfMemoryException

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

ObjectCollectedException

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

ReferenceType または ReferenceType を直接的または間接的にパラメータとして使用するすべてのメソッドは、ミラー化型が読み込み解除されると ObjectCollectedException をスローします。


Java Debug Interface