モジュールjdk.jdi
Java Debug Interface (JDI)は、(通常はリモート)仮想マシンの実行状態へのアクセスを必要とするデバッガや同様のシステムに役立つ情報を提供する高レベルのJava APIです。
JDIは、実行中の仮想マシンの状態、クラス、配列、インタフェースおよびプリミティブ型、およびそれらの型のインスタンスへのイントロスペクティブ・アクセスを提供します。
JDIでは、仮想マシンの実行を明示的に制御することもできます。 スレッドを中断および再開する機能、およびブレークポイント、ウォッチ・ポイントなどを設定する機能。例外、クラスのロード、スレッド作成などの通知。中断されたスレッドの状態、ローカル変数、スタック・バック・トレースなどを検査する機能。
JDIは、「Javaプラットフォーム・デバッガのアーキテクチャ(JPDA)」の最上位レイヤーです。
このモジュールには、単純なコマンド行デバッガであるjdbが含まれています。
グローバル例外
このセクションでは、API全体に適用されるため、個々のメソッドでは説明していない例外について説明します。
ノート: 下記の例外は、指定した条件を満たす場合にスローされることがありますが、それらがスローされるのは、有効な結果を返すことができない場合に限られます。
List
内の要素として使う場合など、Mirror
を直接的または間接的にパラメータとして取るMirror
の任意のメソッドは、別の仮想マシンによって作成されたミラーが存在する場合にVMMismatchException
をスローします。パラメータとして
Object
をとるメソッドは、nullが有効なパラメータとして明示的に説明されていないかぎり、nullが直接または間接的に渡された場合に、NullPointerException
をスローします。
ObjectReference
、ReferenceType
、EventRequest
、StackFrame
、またはVirtualMachine
のすべてのメソッドまたは、これらのいずれかをパラメータとして直接または間接的にとるメソッドは、ターゲットのVMが切断されVMDisconnectEvent
がEventQueue
から読み取られているか、読取りに使用できる場合に、VMDisconnectedException
をスローすることがあります。
ObjectReference
、ReferenceType
、EventRequest
、StackFrame
、またはVirtualMachine
のすべてのメソッドまたは、これらのいずれかをパラメータとして直接または間接的にとるメソッドは、ターゲットのVMのメモリーが不足した場合に、VMOutOfMemoryException
をスローすることがあります。
ObjectReference
のすべてのメソッドまたはObjectReference
をパラメータとして直接的または間接的にとるメソッドは、ミラー・オブジェクトがガベージ・コレクトされた場合にObjectCollectedException
をスローすることがあります。
ReferenceType
のすべてのメソッドまたはReferenceType
をパラメータとして直接的または間接的にとるメソッドは、ミラーされた型がアンロードされた場合にObjectCollectedException
をスローすることがあります。
- モジュール・グラフ:
- ツール・ガイド:
- jdb
- 導入されたバージョン:
- 9
- 関連項目:
-
パッケージ
パッケージ説明これは、Java Debug Interface (JDI)のコア・パッケージで、ブートストラップ機能以外に、値、型、およびターゲット仮想マシン自体のミラーを定義します。このパッケージは、JDIを使用する仮想マシンとターゲット仮想マシン間の接続を定義します。このパッケージは、新しいTransportService
実装を開発するために使用されるインタフェースおよびクラスで構成されます。このパッケージは、JDIイベントとイベント処理を定義します。このパッケージは、指定された条件下でJDIイベントが送信されることを要求する場合に使用されます。 -
サービス