ナビゲーション・リンクをスキップ
Java Debug Interface

Java(tm) Debug Interface

JavaTM Debug Interface (JDI)は、(通常はリモートの)仮想マシンの実行状態にアクセスする必要があるデバッガや同様のシステムに役立つ情報を提供する高レベルの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イベントが送信されることを要求する場合に使用されます。
JavaTM Debug Interface (JDI)は、(通常はリモートの)仮想マシンの実行状態にアクセスする必要があるデバッガや同様のシステムに役立つ情報を提供する高レベルのJava APIです。

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

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

JDIは、Java Platform Debugger Architecture (JPDA)の最上位層です。Java Platform Debugger Architectureの詳細については、このリリースに関するJava Platform Debugger ArchitectureのドキュメントおよびJava Platform Debugger Architecture Webサイトを参照してください。

グローバルな例外

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

VMMismatchException

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

NullPointerException

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

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

VMDisconnectedException

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

VMOutOfMemoryException

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

ObjectCollectedException

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

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

ナビゲーション・リンクをスキップ
Java Debug Interface


Copyright © 1999, 2014, Oracle and/or its affiliates. All rights reserved.