|
Java Debug Interface | |||||||||
| 前 次 | フレームあり フレームなし | |||||||||
参照:
説明
| パッケージ | |
| com.sun.jdi | Java Debug Interface (JDI) のコアパッケージで、ブートストラップ機能以外に、値、 型、およびターゲット VirtualMachine 自体に対するミラーを定義します。 |
| com.sun.jdi.connect | このパッケージには、JDI を使用して、この Virtual Machine とターゲットの Virtual Machine 間の接続を定義します。 |
| com.sun.jdi.event | このパッケージには、JDI イベントとイベント処理を定義します。 |
| com.sun.jdi.request | このパッケージは、指定された条件下で JDI イベントが送信されることを要求する場合に使用されます。 |
JavaTM Debug Interface (JDI) は高レベルの Java API で、仮想マシン (通常はリモート) の動作状態にアクセスする必要のあるデバッガやそれと同様の機能を持つシステムに対して有用な情報を提供します。
JDI は、仮想マシンの動作状態、Class、Array、Interface、プリミティブ型、およびそれらの型のインスタンスへの内省的なアクセスを提供します。
また JDI は、仮想マシンの実行を明示的に制御できます。スレッドの中断および再開を行なう機能、ブレークポイントやウォッチポイントを設定する機能があります。その他に、例外の通知、クラスのロード、スレッドの作成などを行えます。さらに、中断されたスレッド状態、ローカル変数、スタックバックトレースなどをインスペクトする機能もあります。
JDI は、Java Platform Debugger Architecture (JPDA) の最上位に位置する層です。Java Platform Debugger Architecture の詳細は、このリリースの Java Platform Debugger Architecture のドキュメントおよび Java Platform Debugger Architecture の web サイトを参照してください。
グローバルな例外:
このセクションでは、API 全体に適用される例外について説明します。個々のメソッドについては説明しません。
注: 特定の状況下にありながら、正しい結果が返されないときに例外のスローが保証されるのみである場合には、常に以下の例外が返されます。直接または間接的にパラメータとして (例、
List内の要素として)MirrorをとるMirrorのメソッドは、ミラーが異なる仮想マシンからのものである場合にVMMismatchExceptionをスローします。パラメータとして
Objectをとるメソッドは、直接または間接的に null が渡される場合にNullPointerExceptionをスローします。ただし、null が有効なパラメータとして明示的に示されている場合はスローされません。
ObjectReference、ReferenceType、EventRequest、StackFrame、VirtualMachineのメソッド、あるいは直接または間接的にパラメータとしてこれらのクラスの 1 つをとるメソッドは、対象となる VM が未接続でVMDisconnectEventがEventQueueから現在読み込み可能であるかまたは過去に読み込み可能であった場合、VMDisconnectedExceptionをスローします。
ObjectReference、ReferenceType、EventRequest、StackFrame、VirtualMachine、あるいは直接または間接的にパラメータとしてこれらのクラスの 1 つをとるメソッドは、対象となる VM がメモリ不足である場合、VMOutOfMemoryExceptionをスローします。
ObjectReferenceのメソッド、あるいは直接または間接的にパラメータとしてObjectReferenceをとるメソッドは、ミラー化されたオブジェクトがガベージコレクトされた場合に、ObjectCollectedExceptionをスローします。
ReferenceTypeのメソッド、あるいは直接または間接的にパラメータとしてReferenceTypeをとるメソッドは、ミラー化された型がアンロードされた場合に、ObjectCollectedExceptionをスローします。
|
Java Debug Interface | |||||||||
| 前 次 | フレームあり フレームなし | |||||||||