• Version (1)
• ClassesBySignature (2)
• AllClasses (3)
• AllThreads (4)
• TopLevelThreadGroups (5)
• Dispose (6)
• IDSizes (7)
• Suspend (8)
• Resume (9)
• Exit (10)
• CreateString (11)
• Capabilities (12)
• ClassPaths (13)
• DisposeObjects (14)
• HoldEvents (15)
• ReleaseEvents (16)
• CapabilitiesNew (17)
• RedefineClasses (18)
• SetDefaultStratum (19)
• AllClassesWithGeneric (20)
• InstanceCounts (21)

• Signature (1)
• ClassLoader (2)
• Modifiers (3)
• Fields (4)
• Methods (5)
• GetValues (6)
• SourceFile (7)
• NestedTypes (8)
• Status (9)
• Interfaces (10)
• ClassObject (11)
• SourceDebugExtension (12)
• SignatureWithGeneric (13)
• FieldsWithGeneric (14)
• MethodsWithGeneric (15)
• Instances (16)
• ClassFileVersion (17)
• ConstantPool (18)

• Superclass (1)
• SetValues (2)
• InvokeMethod (3)
• NewInstance (4)

• NewInstance (1)

• LineTable (1)
• VariableTable (2)
• Bytecodes (3)
• IsObsolete (4)
• VariableTableWithGeneric (5)

• ReferenceType (1)
• GetValues (2)
• SetValues (3)
• MonitorInfo (5)
• InvokeMethod (6)
• DisableCollection (7)
• EnableCollection (8)
• IsCollected (9)
• ReferringObjects (10)

• Value (1)

• Name (1)
• Suspend (2)
• Resume (3)
• Status (4)
• ThreadGroup (5)
• Frames (6)
• FrameCount (7)
• OwnedMonitors (8)
• CurrentContendedMonitor (9)
• Stop (10)
• Interrupt (11)
• SuspendCount (12)
• OwnedMonitorsStackDepthInfo (13)
• ForceEarlyReturn (14)

• Name (1)
• Parent (2)
• Children (3)

• Length (1)
• GetValues (2)
• SetValues (3)

• VisibleClasses (1)

• Set (1)
• Clear (2)
• ClearAllBreakpoints (3)

• GetValues (1)
• SetValues (2)
• ThisObject (3)
• PopFrames (4)

• ReflectedType (1)

• Composite (100)

VirtualMachine コマンドセット (1)

Version コマンド (1)

出力データ

(なし)

応答データ

string					description	VM のバージョンに関するテキスト情報
int					jdwpMajor	JDWP のメジャーバージョン番号
int					jdwpMinor	JDWP のマイナーバージョン番号
string					vmVersion	ターゲット VM の JRE バージョン (java.version プロパティーの値と同じ)
string					vmName	ターゲット VM 名 (java.vm.name プロパティーの値と同じ)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

ClassesBySignature コマンド (2)

出力データ

string					signature	検索するクラスの JNI シグニチャー (たとえば、"Ljava/lang/String;")。

応答データ

int					classes	あとに続く参照型の数。
classes 回の繰り返し:
	byte				refTypeTag	あとに続く参照型の種類。
	referenceTypeID				typeID	対応するロードされた参照型
	int				status	現在のクラスのステータス。

エラーデータ

VM_DEAD

仮想マシンが動作していない。

AllClasses コマンド (3)

出力データ

(なし)

応答データ

int					classes	あとに続く参照型の数。
classes 回の繰り返し:
	byte				refTypeTag	あとに続く参照型の種類。
	referenceTypeID				typeID	ロードされた参照型
	string				signature	ロードされた参照型の JNI シグニチャー
	int				status	現在のクラスのステータス。

エラーデータ

VM_DEAD

仮想マシンが動作していない。

AllThreads コマンド (4)

出力データ

(なし)

応答データ

int					threads	あとに続くスレッドの数
threads 回の繰り返し:
	threadID				thread	実行中のスレッド

エラーデータ

VM_DEAD

仮想マシンが動作していない。

TopLevelThreadGroups コマンド (5)

出力データ

(なし)

応答データ

int					groups	あとに続くスレッドグループの数
groups 回の繰り返し:
	threadGroupID				group	トップレベルのスレッドグループ

エラーデータ

VM_DEAD

仮想マシンが動作していない。

Dispose コマンド (6)

• すべてのイベント要求が取り消される。
• スレッドレベルの Resume コマンドまたは VM レベルの Resume コマンドにより中断されたすべてのスレッドが、実行に必要な回数だけ再開される。
• ガベージコレクションが無効にされたすべての状況で、再度有効にされる

この仮想マシンを起源とするリソース (オブジェクト参照や参照型など) は、無効になります。

出力データ

(なし)

応答データ

(なし)

エラーデータ

(なし)

IDSizes コマンド (7)

出力データ

(なし)

応答データ

int					fieldIDSize	fieldID のサイズ (バイト単位)
int					methodIDSize	methodID のサイズ (バイト単位)
int					objectIDSize	objectID のサイズ (バイト単位)
int					referenceTypeIDSize	referenceTypeID のサイズ (バイト単位)
int					frameIDSize	frameID のサイズ (バイト単位)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

Suspend コマンド (8)

java.lang.Thread.suspend とは異なり、仮想マシンと個々のスレッド両方の中断がカウントされます。スレッドをふたたび実行する前に、VM レベルの Resume コマンドまたはスレッドレベルの Resume コマンドを使って、中断の実行回数と同じ数だけ再開を実行する必要があります。

出力データ

(なし)

応答データ

(なし)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

Resume コマンド (9)

出力データ

(なし)

応答データ

(なし)

エラーデータ

(なし)

Exit コマンド (10)

出力データ

int					exitCode	終了コード

応答データ

(なし)

エラーデータ

(なし)

CreateString コマンド (11)

出力データ

string					utf	作成された文字列内で使用する UTF-8 形式の文字。

応答データ

stringID					stringObject	作成された文字列 (java.lang.String のインスタンス)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

Capabilities コマンド (12)

出力データ

(なし)

応答データ

boolean					canWatchFieldModification	VM がフィールドの変更を監視して、変更ウォッチポイントイベントを送信可能かどうか
boolean					canWatchFieldAccess	VM がフィールドへのアクセスを監視して、アクセスウォッチポイントイベントを送信可能かどうか
boolean					canGetBytecodes	VM が、指定されたメソッドのバイトコードを取得できるかどうか
boolean					canGetSyntheticAttribute	フィールドまたはメソッドが合成である場合、VM がそれを判別できるかどうか(つまり、メソッドまたはフィールドがコンパイラにより生成されたものである場合、VM がそれを判別できるかどうか)
boolean					canGetOwnedMonitorInfo	所有されたスレッドのモニター情報を、VM が取得可能かどうか
boolean					canGetCurrentContendedMonitor	現在競合しているスレッドのモニターを、VM が取得可能かどうか
boolean					canGetMonitorInfo	指定されたオブジェクトのモニター情報を、VM が取得できるかどうか

エラーデータ

VM_DEAD

仮想マシンが動作していない。

ClassPaths コマンド (13)

出力データ

(なし)

応答データ

string					baseDir	次のリスト内のいずれかの相対パス解決で使用されるベースディレクトリ。
int					classpaths	classpath 内のパスの数
classpaths 回の繰り返し:
	string				path	classpath の 1 コンポーネント
int					bootclasspaths	bootclasspath 内のパスの数。
bootclasspaths 回の繰り返し:
	string				path	bootclasspath の 1 コンポーネント

エラーデータ

VM_DEAD

仮想マシンが動作していない。

DisposeObjects コマンド (14)

このコマンドの使用は、必須ではありません。このコマンドが送られない場合、各 ID に関連付けられているリソースは、対応するオブジェクトのガベージコレクションの実行後に、バックエンドにより解放されます。このコマンドのもっとも効果的な利用法は、大量のオブジェクト (大規模な配列など) がバックエンドから取得されているが、すぐにはガベージコレクションが行われない場合に、バックエンドの負荷を軽減することです。

このコマンドで解放された ID は、バックエンドにより再利用されることがあります。この説明では、参照がカウントされていることを想定しており、バックエンドは同等の動作をする任意の実装を使用できます。

出力データ

int					requests	あとに続くオブジェクト破棄要求の数
requests 回の繰り返し:
	objectID				object	オブジェクト ID
	int				refCnt	このオブジェクト ID がバックエンドから受け取ったパケットに含まれていた回数。ここに正確なカウントを指定することにより、オブジェクト ID が着信パケットの一部であり、まだフロントエンドにより処理されていない場合に、オブジェクト ID がバックエンドで解放されることを回避できる。

応答データ

(なし)

エラーデータ

(なし)

HoldEvents コマンド (15)

出力データ

(なし)

応答データ

(なし)

エラーデータ

(なし)

ReleaseEvents コマンド (16)

出力データ

(なし)

応答データ

(なし)

エラーデータ

(なし)

CapabilitiesNew コマンド (17)

出力データ

(なし)

応答データ

boolean					canWatchFieldModification	VM がフィールドの変更を監視して、変更ウォッチポイントイベントを送信可能かどうか
boolean					canWatchFieldAccess	VM がフィールドへのアクセスを監視して、アクセスウォッチポイントイベントを送信可能かどうか
boolean					canGetBytecodes	VM が、指定されたメソッドのバイトコードを取得できるかどうか
boolean					canGetSyntheticAttribute	フィールドまたはメソッドが合成である場合、VM がそれを判別できるかどうか(つまり、メソッドまたはフィールドがコンパイラにより生成されたものである場合、VM がそれを判別できるかどうか)
boolean					canGetOwnedMonitorInfo	所有されたスレッドのモニター情報を、VM が取得可能かどうか
boolean					canGetCurrentContendedMonitor	現在競合しているスレッドのモニターを、VM が取得可能かどうか
boolean					canGetMonitorInfo	指定されたオブジェクトのモニター情報を、VM が取得できるかどうか
boolean					canRedefineClasses	VM がクラスを再定義できるかどうか
boolean					canAddMethod	VM がクラスを再定義するときにメソッドを追加できるかどうか
boolean					canUnrestrictedlyRedefineClasses	VM がクラスを自由に再定義できるかどうか
boolean					canPopFrames	VM がスタックフレームをポップできるかどうか
boolean					canUseInstanceFilters	VM が特定のオブジェクトでイベントをフィルタできるかどうか
boolean					canGetSourceDebugExtension	VM がソースデバッグ拡張機能を取得できるかどうか
boolean					canRequestVMDeathEvent	VM が VM 終了イベントを要求できるかどうか
boolean					canSetDefaultStratum	VM がデフォルトの層を設定できるかどうか
boolean					canGetInstanceInfo	VM がインスタンス、クラスのインスタンス数、参照するオブジェクトを返せるかどうか
boolean					canRequestMonitorEvents	VM が監視イベントを要求できるかどうか
boolean					canGetMonitorFrameInfo	VM がフレームの深さに関する情報を含む監視を取得できるかどうか
boolean					canUseSourceNameFilters	VM がソース名に基づいてクラス準備イベントをフィルタ処理できるかどうか
boolean					canGetConstantPool	VM が定数プール情報を返せるかどうか
boolean					canForceEarlyReturn	VM がメソッドからの戻り値を早期に返させることができるかどうか
boolean					reserved22	将来の権限のために予約済み
boolean					reserved23	将来の権限のために予約済み
boolean					reserved24	将来の権限のために予約済み
boolean					reserved25	将来の権限のために予約済み
boolean					reserved26	将来の権限のために予約済み
boolean					reserved27	将来の権限のために予約済み
boolean					reserved28	将来の権限のために予約済み
boolean					reserved29	将来の権限のために予約済み
boolean					reserved30	将来の権限のために予約済み
boolean					reserved31	将来の権限のために予約済み
boolean					reserved32	将来の権限のために予約済み

エラーデータ

VM_DEAD

仮想マシンが動作していない。

RedefineClasses コマンド (18)

canRedefineClasses 権限が必要です (CapabilitiesNew を参照)。canRedefineClasses 権限に加え、ターゲット VM には、クラスを再定義するときにメソッドを追加する canAddMethod 権限、または任意の方法でクラスを再定義する canUnrestrictedlyRedefineClasses が必要です。

出力データ

int					classes	あとに続く参照型の数。
classes 回の繰り返し:
	referenceTypeID				refType	参照型。
	int				classfile	定義するクラスのバイト数 (下)
	classfile 回の繰り返し:
		byte			classbyte	JVM クラスファイル形式のバイト。

応答データ

(なし)

エラーデータ

INVALID_CLASS	refType の 1 つが参照型の ID ではない。
INVALID_OBJECT	refType の 1 つが既知の ID ではない。
UNSUPPORTED_VERSION	クラスファイルのバージョンがこの VM でサポートされていない。
INVALID_CLASS_FORMAT	仮想マシンがクラスファイルを読み込もうとしたが、ファイルの形式が間違っているか、その他の理由でクラスファイルとして解釈できない。
CIRCULAR_CLASS_DEFINITION	クラスの初期化中に、循環定義が検出された。
FAILS_VERIFICATION	クラスファイルの形式は正しいが、検証ルーチンは何らかの種類の内部的な不整合かセキュリティー上の問題を検出した。
NAMES_DONT_MATCH	新しいクラスファイル内で定義されたクラス名が、旧クラスオブジェクト内の名前と異なる。
NOT_IMPLEMENTED	この機能は実装されていない (CapabilitiesNew.canRedefineClasses が false)
ADD_METHOD_NOT_IMPLEMENTED	追加メソッドが実装されていない。
SCHEMA_CHANGE_NOT_IMPLEMENTED	スキーマの変更が実装されていない。
HIERARCHY_CHANGE_NOT_IMPLEMENTED	新しいクラスのバージョンの直接スーパークラスが異なる、または直接実装されているインタフェースが異なり、canUnrestrictedlyRedefineClasses が false。
DELETE_METHOD_NOT_IMPLEMENTED	新しいクラスのバージョンでは、旧クラスのバージョンで宣言したメソッドを宣言せず、また canUnrestrictedlyRedefineClasses が false。
CLASS_MODIFIERS_CHANGE_NOT_IMPLEMENTED	新しいクラスのバージョンの修飾子が異なり、canUnrestrictedlyRedefineClasses が false。
METHOD_MODIFIERS_CHANGE_NOT_IMPLEMENTED	新しいクラスのバージョンのメソッドの修飾子が旧クラスのバージョンの修飾子と異なり、canUnrestrictedlyRedefineClasses が false。
VM_DEAD	仮想マシンが動作していない。

SetDefaultStratum コマンド (19)

出力データ

string					stratumID	デフォルト層、または参照型デフォルトを使用するための空の文字列。

応答データ

(なし)

エラーデータ

NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

AllClassesWithGeneric コマンド (20)

出力データ

(なし)

応答データ

int					classes	あとに続く参照型の数。
classes 回の繰り返し:
	byte				refTypeTag	あとに続く参照型の種類。
	referenceTypeID				typeID	ロードされた参照型
	string				signature	ロードされた参照型の JNI シグニチャー。
	string				genericSignature	ロードされた参照型のジェネリックシグニチャー、ない場合は空の文字列。
	int				status	現在のクラスのステータス。

エラーデータ

VM_DEAD

仮想マシンが動作していない。

InstanceCounts コマンド (21)

これは JDWP バージョン 1.6 以降。canGetInstanceInfo 権限が必要です (CapabilitiesNew を参照)。

出力データ

int					refTypesCount	全参照型の数。負でない数値。
refTypesCount 回の繰り返し:
	referenceTypeID				refType	参照型 ID。

応答データ

int					counts	あとに続く回数。
counts 回の繰り返し:
	long				instanceCount	「出力データ」内の参照型のインスタンス数。

エラーデータ

ILLEGAL_ARGUMENT	refTypesCount がゼロより小さい。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

ReferenceType コマンドセット (2)

Signature コマンド (1)

プリミティブクラスの場合、返されるシグニチャーは対応するプリミティブ型のシグニチャーです。たとえば、「I」は、java.lang.Integer.TYPE により表されるクラスのシグニチャーとして返されます。

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

string					signature	参照型の JNI シグニチャー。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

ClassLoader コマンド (2)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

classLoaderID					classLoader	参照型のクラスローダー。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Modifiers コマンド (3)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					modBits	Java™ 仮想マシン仕様の第 4 章で定義されている修飾子ビット

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Fields コマンド (4)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					declared	宣言されているフィールドの数。
declared 回の繰り返し:
	fieldID				fieldID	フィールド ID。
	string				name	フィールドの名前。
	string				signature	フィールドの JNI シグニチャー。
	int				modBits	フィールド宣言に関する補足情報を提供する修飾子ビットフラグ (アクセスフラグともいう)。個々のフラグ値は、Java™ 仮想マシン仕様の第 4 章に定義されている。また、合成属性の権限を利用可能な場合には、0xf0000000 ビットは、そのフィールドが合成であることを示す。

エラーデータ

CLASS_NOT_PREPARED	クラスがロードされているが、まだ準備されていない。
INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Methods コマンド (5)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					declared	宣言されているメソッドの数。
declared 回の繰り返し:
	methodID				methodID	メソッド ID。
	string				name	メソッドの名前。
	string				signature	メソッドの JNI シグニチャー。
	int				modBits	メソッド宣言に関する補足情報を提供する修飾子ビットフラグ (アクセスフラグともいう)。個々のフラグ値は、Java™ 仮想マシン仕様の第 4 章に定義されている。また、合成属性の権限を利用可能な場合には、0xf0000000 ビットは、そのメソッドが合成であることを示す。

エラーデータ

CLASS_NOT_PREPARED	クラスがロードされているが、まだ準備されていない。
INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

GetValues コマンド (6)

出力データ

referenceTypeID					refType	参照型 ID。
int					fields	取得する値の数
fields 回の繰り返し:
	fieldID				fieldID	取得するフィールド

応答データ

int					values	返される値の数。fields の取得する値の数と常に等しい。
values 回の繰り返し:
	value				value	フィールドの値

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_FIELDID	無効なフィールド。
VM_DEAD	仮想マシンが動作していない。

SourceFile コマンド (7)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

string					sourceFile	ソースファイルの名前。ファイルのパス情報は含まれない

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
ABSENT_INFORMATION	ソースファイルの属性が存在しない。
VM_DEAD	仮想マシンが動作していない。

NestedTypes コマンド (8)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					classes	ネストされたクラスとインタフェースの数
classes 回の繰り返し:
	byte				refTypeTag	あとに続く参照型の種類。
	referenceTypeID				typeID	ネストされたクラスまたはインタフェースの ID。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Status コマンド (9)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					status	ステータスビット。JDWP.ClassStatus を参照

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Interfaces コマンド (10)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					interfaces	実装したインタフェースの数
interfaces 回の繰り返し:
	interfaceID				interfaceType	実装されたインタフェース。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

ClassObject コマンド (11)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

classObjectID					classObject	クラスオブジェクト。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

SourceDebugExtension コマンド (12)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

string					extension	拡張属性

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
ABSENT_INFORMATION	拡張属性が指定されていない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

SignatureWithGeneric コマンド (13)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

string					signature	参照型の JNI シグニチャー。
string					genericSignature	参照型のジェネリックシグニチャー、ない場合は空の文字列。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

FieldsWithGeneric コマンド (14)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					declared	宣言されているフィールドの数。
declared 回の繰り返し:
	fieldID				fieldID	フィールド ID。
	string				name	フィールドの名前。
	string				signature	フィールドの JNI シグニチャー。
	string				genericSignature	フィールドのジェネリックシグニチャー、ない場合は空の文字列。
	int				modBits	フィールド宣言に関する補足情報を提供する修飾子ビットフラグ (アクセスフラグともいう)。個々のフラグ値は、Java™ 仮想マシン仕様の第 4 章に定義されている。また、合成属性の権限を利用可能な場合には、0xf0000000 ビットは、そのフィールドが合成であることを示す。

エラーデータ

CLASS_NOT_PREPARED	クラスがロードされているが、まだ準備されていない。
INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

MethodsWithGeneric コマンド (15)

出力データ

referenceTypeID					refType	参照型 ID。

応答データ

int					declared	宣言されているメソッドの数。
declared 回の繰り返し:
	methodID				methodID	メソッド ID。
	string				name	メソッドの名前。
	string				signature	メソッドの JNI シグニチャー。
	string				genericSignature	メソッドのジェネリックシグニチャー、ない場合は空の文字列。
	int				modBits	メソッド宣言に関する補足情報を提供する修飾子ビットフラグ (アクセスフラグともいう)。個々のフラグ値は、Java™ 仮想マシン仕様の第 4 章に定義されている。また、合成属性の権限を利用可能な場合には、0xf0000000 ビットは、そのメソッドが合成であることを示す。

エラーデータ

CLASS_NOT_PREPARED	クラスがロードされているが、まだ準備されていない。
INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Instances コマンド (16)

これは JDWP バージョン 1.6 以降。canGetInstanceInfo 権限が必要です (CapabilitiesNew を参照)。

出力データ

referenceTypeID					refType	参照型 ID。
int					maxInstances	返されるインスタンスの最大数。負でない数値。ゼロの場合、すべてのインスタンスが返される。

応答データ

int					instances	あとに続くインスタンスの数。
instances 回の繰り返し:
	tagged-objectID				instance	この参照型のインスタンス。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
ILLEGAL_ARGUMENT	maxInstances がゼロより小さい。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

ClassFileVersion コマンド (17)

これは JDWP バージョン 1.6 以降。

出力データ

referenceTypeID					refType	クラス。

応答データ

int					majorVersion	メジャーバージョン番号
int					minorVersion	マイナーバージョン番号

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
ABSENT_INFORMATION	プリミティブ型および配列型のクラスファイルバージョン情報が存在しない。
VM_DEAD	仮想マシンが動作していない。

ConstantPool コマンド (18)

これは JDWP バージョン 1.6 以降。canGetConstantPool 権限が必要です (CapabilitiesNew を参照)。

出力データ

referenceTypeID					refType	クラス。

応答データ

int					count	定数プールエントリの総数に 1 を加えた値。これは、Java™ 仮想マシン仕様のクラスファイル形式の説明に記載されている、constant_pool_count 項目と一致する。
int					bytes
bytes 回の繰り返し:
	byte				cpbytes	raw バイトの定数プール

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
NOT_IMPLEMENTED	ターゲット仮想マシンが定数プール情報の取得をサポートしていない。
ABSENT_INFORMATION	プリミティブ型および配列型の定数プール情報が存在しない。
VM_DEAD	仮想マシンが動作していない。

ClassType コマンドセット (3)

Superclass コマンド (1)

出力データ

classID					clazz	クラス型 ID。

応答データ

classID					superclass	スーパークラス (java.lang.Object のクラス ID が指定されている場合は、null)。

エラーデータ

INVALID_CLASS	clazz がクラスの ID ではない。
INVALID_OBJECT	clazz が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

SetValues コマンド (2)

出力データ

classID					clazz	クラス型 ID。
int					values	設定するフィールドの数。
values 回の繰り返し:
	fieldID				fieldID	設定するフィールド。
	untagged-value				value	フィールドに入力する値。

応答データ

(なし)

エラーデータ

INVALID_CLASS	clazz がクラスの ID ではない。
CLASS_NOT_PREPARED	クラスがロードされているが、まだ準備されていない。
INVALID_OBJECT	clazz が既知の ID ではない、またはオブジェクトフィールドの値が既知の ID ではない。
INVALID_FIELDID	無効なフィールド。
VM_DEAD	仮想マシンが動作していない。

InvokeMethod コマンド (3)

メソッド呼び出しは、指定されたスレッドで実行されます。メソッド呼び出しは、指定されたスレッドがイベントにより中断されている場合にだけ実行されます。ターゲット VM がフロントエンドにより中断されている場合のメソッド呼び出しはサポートされていません。

指定されたメソッドは、指定された引数リスト内の引数を使って呼び出されます。メソッド呼び出しは同期的に行われます。そのため、呼び出されたメソッドがターゲット VM 内で復帰するまで、応答パケットは送信されません。戻り値 (たいていの場合、void 値) は応答パケットに含まれます。呼び出されたメソッドが例外をスローする場合、例外オブジェクト ID が応答パケット内に設定されます。そうでない場合、例外オブジェクト ID は null になります。

プリミティブ引数の場合、引数値の型と引数の型は厳密に一致している必要があります。オブジェクト引数の場合、引数値の型から引数の型への拡張参照変換が存在し、かつ引数の型がロードされている必要があります。

デフォルトでは、ターゲット VM 内のすべてのスレッドがメソッドの呼び出し中に再開されます (イベントまたはコマンドによって以前に中断されたスレッドの場合)。これは、いずれかのスレッドが、呼び出し先メソッドが必要とするモニターを所有している場合に、デッドロックが発生するのを防ぎます。ブレークポイントまたはほかのイベントが、呼び出し中に発生する可能性があります。ただし、この暗黙の再開処理が、ThreadReference の Resume コマンドの処理とまったく同じであることに注意してください。このため、スレッドの中断カウントが 1 より大きいと、呼び出し中もスレッドは中断状態のままになります。デフォルトでは、ターゲット VM 内のすべてのスレッドは、呼び出しの完了時に中断します (呼び出し前のスレッドの状態とは無関係)。

options フィールドに INVOKE_SINGLE_THREADED ビットフラグを指定することにより、呼び出し中にほかのスレッドが再開しないようにできます。ただし、前述のようなデッドロックに対する保護や、デッドロックからの回復ができなくなるため、このオプションはよく注意して利用してください。指定されたスレッドだけが再開されます (前述したすべてのスレッドの場合と同様)。シングルスレッド呼び出しが完了すると、呼び出し元スレッドはふたたび中断されます。シングルスレッド呼び出し中に開始されたすべてのスレッドは、呼び出し完了時にも中断されません。

ターゲット VM が呼び出し中に切断されても (たとえば、VirtualMachine の Dispose コマンドによる)、メソッド呼び出しは続行されます。

出力データ

classID					clazz	クラス型 ID。
threadID					thread	呼び出しを行うスレッド。
methodID					methodID	呼び出すメソッド。
int					arguments
arguments 回の繰り返し:
	value				arg	引数の値。
int					options	呼び出しオプション

応答データ

value					returnValue	戻り値。
tagged-objectID					exception	スローされた例外。

エラーデータ

INVALID_CLASS	clazz がクラスの ID ではない。
INVALID_OBJECT	clazz が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
THREAD_NOT_SUSPENDED	指定されたスレッドは、イベントによって中断されていない。
VM_DEAD	仮想マシンが動作していない。

NewInstance コマンド (4)

インスタンスの作成は、指定されたスレッドで実行されます。インスタンスの作成は、指定されたスレッドがイベントにより中断されている場合にだけ実行されます。ターゲット VM がフロントエンドにより中断されている場合のメソッド呼び出しはサポートされていません。

指定されたコンストラクタは、指定された引数リスト内の引数を使って呼び出されます。コンストラクタ呼び出しは同期的に行われます。そのため、呼び出されたメソッドがターゲット VM 内で復帰するまで、応答パケットは送信されません。戻り値 (たいていの場合、void 値) は応答パケットに含まれます。コンストラクタが例外をスローする場合、例外オブジェクト ID が応答パケット内に設定されます。そうでない場合、例外オブジェクト ID は null になります。

プリミティブ引数の場合、引数値の型と引数の型は厳密に一致している必要があります。オブジェクト引数の場合、引数値の型から引数の型への拡張参照変換が存在し、かつ引数の型がロードされている必要があります。

デフォルトでは、ターゲット VM 内のすべてのスレッドがメソッドの呼び出し中に再開されます (イベントまたはコマンドによって以前に中断されたスレッドの場合)。これは、いずれかのスレッドが、呼び出し先メソッドが必要とするモニターを所有している場合に、デッドロックが発生するのを防ぎます。ブレークポイントまたはほかのイベントが、呼び出し中に発生する可能性があります。ただし、この暗黙の再開処理が、ThreadReference の Resume コマンドの処理とまったく同じであることに注意してください。このため、スレッドの中断カウントが 1 より大きいと、呼び出し中もスレッドは中断状態のままになります。デフォルトでは、ターゲット VM 内のすべてのスレッドは、呼び出しの完了時に中断します (呼び出し前のスレッドの状態とは無関係)。

options フィールドに INVOKE_SINGLE_THREADED ビットフラグを指定することにより、呼び出し中にほかのスレッドが再開しないようにできます。ただし、前述のようなデッドロックに対する保護や、デッドロックからの回復ができなくなるため、このオプションはよく注意して利用してください。指定されたスレッドだけが再開されます (前述したすべてのスレッドの場合と同様)。シングルスレッド呼び出しが完了すると、呼び出し元スレッドはふたたび中断されます。シングルスレッド呼び出し中に開始されたすべてのスレッドは、呼び出し完了時にも中断されません。

ターゲット VM が呼び出し中に切断されても (たとえば、VirtualMachine の Dispose コマンドによる)、メソッド呼び出しは続行されます。

出力データ

classID					clazz	クラス型 ID。
threadID					thread	コンストラクタを呼び出すスレッド。
methodID					methodID	呼び出し先のコンストラクタ。
int					arguments
arguments 回の繰り返し:
	value				arg	引数の値。
int					options	コンストラクタ呼び出しのオプション

応答データ

tagged-objectID					newObject	新規に作成されたオブジェクト、またはコンストラクタが例外をスローする場合は null。
tagged-objectID					exception	スローされた例外 (存在する場合)、または null。

エラーデータ

INVALID_CLASS	clazz がクラスの ID ではない。
INVALID_OBJECT	clazz が既知の ID ではない、またはオブジェクトパラメータの値が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
THREAD_NOT_SUSPENDED	指定されたスレッドは、イベントによって中断されていない。
VM_DEAD	仮想マシンが動作していない。

ArrayType コマンドセット (4)

NewInstance コマンド (1)

出力データ

arrayTypeID					arrType	新規インスタンスの配列型。
int					length	配列の長さ。

応答データ

tagged-objectID					newArray	新規作成された配列オブジェクト。

エラーデータ

INVALID_ARRAY	配列が無効。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

InterfaceType コマンドセット (5)

Method コマンドセット (6)

LineTable コマンド (1)

出力データ

referenceTypeID					refType	クラス。
methodID					methodID	メソッド。

応答データ

long					start	メソッドについて有効な最小のコードインデックス。>=0 または -1 (メソッドがネイティブの場合)
long					end	メソッドについて有効な最大のコードインデックス。>=0 または -1 (メソッドがネイティブの場合)
int					lines	このメソッドの行テーブル内のエントリ数。
lines 回の繰り返し:
	long				lineCodeIndex	行の初期コードインデックス (開始 <= lineCodeIndex < 終了)
	int				lineNumber	行番号。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
VM_DEAD	仮想マシンが動作していない。

VariableTable コマンド (2)

出力データ

referenceTypeID					refType	クラス。
methodID					methodID	メソッド。

応答データ

int					argCnt	引数で使用されるフレーム内のワード数。8 バイトの引数は 2 ワードを使用し、その他の引数は 1 ワードを使用する。
int					slots	変数の数。
slots 回の繰り返し:
	long				codeIndex	変数が可視状態にある最初のコードインデックス (符号なし)。length と一緒に使う。次のときにのみ、変数を取得または設定できる: 現在の codeIndex <= 現在のフレームコードインデックス < codeIndex + length
	string				name	変数の名前。
	string				signature	変数型の JNI シグニチャー。
	int				length	codeIndex と一緒に使う符号なしの値。次のときにのみ、変数を取得または設定できる: 現在の codeIndex <= 現在のフレームコードインデックス < code index + length
	int				slot	フレーム内の局所変数のインデックス

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
ABSENT_INFORMATION	メソッドの変数情報がない。
VM_DEAD	仮想マシンが動作していない。

Bytecodes コマンド (3)

出力データ

referenceTypeID					refType	クラス。
methodID					methodID	メソッド。

応答データ

int					bytes
bytes 回の繰り返し:
	byte				bytecode	Java バイトコード。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
NOT_IMPLEMENTED	ターゲット仮想マシンがバイトコードの取得をサポートしていない。
VM_DEAD	仮想マシンが動作していない。

IsObsolete コマンド (4)

出力データ

referenceTypeID					refType	クラス。
methodID					methodID	メソッド。

応答データ

boolean					isObsolete	RedefineClasses コマンドによって、このメソッドが同等でないメソッドで置き換えられている場合は true。

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
NOT_IMPLEMENTED	ターゲット仮想マシンがこのクエリーをサポートしていない。
VM_DEAD	仮想マシンが動作していない。

VariableTableWithGeneric コマンド (5)

出力データ

referenceTypeID					refType	クラス。
methodID					methodID	メソッド。

応答データ

int					argCnt	引数で使用されるフレーム内のワード数。8 バイトの引数は 2 ワードを使用し、その他の引数は 1 ワードを使用する。
int					slots	変数の数。
slots 回の繰り返し:
	long				codeIndex	変数が可視状態にある最初のコードインデックス (符号なし)。length と一緒に使う。次のときにのみ、変数を取得または設定できる: 現在の codeIndex <= 現在のフレームコードインデックス < codeIndex + length
	string				name	変数の名前。
	string				signature	変数型の JNI シグニチャー。
	string				genericSignature	変数型のジェネリックシグニチャー、ない場合は空の文字列。
	int				length	codeIndex と一緒に使う符号なしの値。次のときにのみ、変数を取得または設定できる: 現在の codeIndex <= 現在のフレームコードインデックス < code index + length
	int				slot	フレーム内の局所変数のインデックス

エラーデータ

INVALID_CLASS	refType が参照型の ID ではない。
INVALID_OBJECT	refType が既知の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
ABSENT_INFORMATION	メソッドの変数情報がない。
VM_DEAD	仮想マシンが動作していない。

Field コマンドセット (8)

ObjectReference コマンドセット (9)

ReferenceType コマンド (1)

出力データ

objectID					object	オブジェクト ID

応答データ

byte					refTypeTag	あとに続く参照型の種類。
referenceTypeID					typeID	実行時の参照型。

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

GetValues コマンド (2)

出力データ

objectID					object	オブジェクト ID
int					fields	取得する値の数
fields 回の繰り返し:
	fieldID				fieldID	取得するフィールド。

応答データ

int					values	返される値の数。「fields」の取得する値の数と常に等しい。応答では、フィールドの値はコマンド内の対応する fieldID と同じ順序で順序付けされる。
values 回の繰り返し:
	value				value	フィールドの値

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_FIELDID	無効なフィールド。
VM_DEAD	仮想マシンが動作していない。

SetValues コマンド (3)

出力データ

objectID					object	オブジェクト ID
int					values	設定するフィールドの数。
values 回の繰り返し:
	fieldID				fieldID	設定するフィールド。
	untagged-value				value	フィールドに入力する値。

応答データ

(なし)

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_FIELDID	無効なフィールド。
VM_DEAD	仮想マシンが動作していない。

MonitorInfo コマンド (5)

出力データ

objectID					object	オブジェクト ID

応答データ

threadID					owner	モニターの所有者、または null (現在は所有されていない場合)。
int					entryCount	モニターが入力された回数。
int					waiters	モニターを待機しているスレッドの数、現在の所有者が存在しない場合は 0
waiters 回の繰り返し:
	threadID				thread	このモニターを待機しているスレッド。

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

InvokeMethod コマンド (6)

メソッド呼び出しは、指定されたスレッドで実行されます。メソッド呼び出しは、指定されたスレッドがイベントにより中断されている場合にだけ実行されます。ターゲット VM がフロントエンドにより中断されている場合のメソッド呼び出しはサポートされていません。

指定されたメソッドは、指定された引数リスト内の引数を使って呼び出されます。メソッド呼び出しは同期的に行われます。そのため、呼び出されたメソッドがターゲット VM 内で復帰するまで、応答パケットは送信されません。戻り値 (たいていの場合、void 値) は応答パケットに含まれます。呼び出されたメソッドが例外をスローする場合、例外オブジェクト ID が応答パケット内に設定されます。そうでない場合、例外オブジェクト ID は null になります。

プリミティブ引数の場合、引数値の型と引数の型は厳密に一致している必要があります。オブジェクト引数の場合、引数値の型から引数の型への拡張参照変換が存在し、かつ引数の型がロードされている必要があります。

デフォルトでは、ターゲット VM 内のすべてのスレッドがメソッドの呼び出し中に再開されます (イベントまたはコマンドによって以前に中断されたスレッドの場合)。これは、いずれかのスレッドが、呼び出し先メソッドが必要とするモニターを所有している場合に、デッドロックが発生するのを防ぎます。ブレークポイントまたはほかのイベントが、呼び出し中に発生する可能性があります。ただし、この暗黙の再開処理が、ThreadReference の Resume コマンドの処理とまったく同じであることに注意してください。このため、スレッドの中断カウントが 1 より大きいと、呼び出し中もスレッドは中断状態のままになります。デフォルトでは、ターゲット VM 内のすべてのスレッドは、呼び出しの完了時に中断します (呼び出し前のスレッドの状態とは無関係)。

options フィールドに INVOKE_SINGLE_THREADED ビットフラグを指定することにより、呼び出し中にほかのスレッドが再開しないようにできます。ただし、前述のようなデッドロックに対する保護や、デッドロックからの回復ができなくなるため、このオプションはよく注意して利用してください。指定されたスレッドだけが再開されます (前述したすべてのスレッドの場合と同様)。シングルスレッド呼び出しが完了すると、呼び出し元スレッドはふたたび中断されます。シングルスレッド呼び出し中に開始されたすべてのスレッドは、呼び出し完了時にも中断されません。

ターゲット VM が呼び出し中に切断されても (たとえば、VirtualMachine の Dispose コマンドによる)、メソッド呼び出しは続行されます。

出力データ

objectID					object	オブジェクト ID
threadID					thread	呼び出しを行うスレッド。
classID					clazz	クラスの型。
methodID					methodID	呼び出すメソッド。
int					arguments	引数の数。
arguments 回の繰り返し:
	value				arg	引数の値。
int					options	呼び出しオプション

応答データ

value					returnValue	戻り値、または null (例外がスローされた場合)。
tagged-objectID					exception	スローされた例外 (存在する場合)。

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_CLASS	clazz が参照型の ID ではない。
INVALID_METHODID	methodID がメソッドの ID ではない。
INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
THREAD_NOT_SUSPENDED	指定されたスレッドは、イベントによって中断されていない。
VM_DEAD	仮想マシンが動作していない。

DisableCollection コマンド (7)

ターゲット VM の中断中は、すべてのスレッドが中断しているため、ガベージコレクションは行われません。中断中に変数、フィールド、および配列を調べるという一般的な操作の場合は、明示的にガベージコレクションを無効にしなくても安全です。

このメソッドを使用すると、ターゲット VM 内のガベージコレクションのパターンが変わるため、アプリケーションの動作がデバッガ実行時とデバッガ非実行時とで異なる結果になる可能性があります。そのため、このメソッドの使用には慎重を期してください。

出力データ

objectID					object	オブジェクト ID

応答データ

(なし)

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

EnableCollection コマンド (8)

出力データ

objectID					object	オブジェクト ID

応答データ

(なし)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

IsCollected コマンド (9)

出力データ

objectID					object	オブジェクト ID

応答データ

boolean					isCollected	オブジェクトがガベージコレクトされた場合は true、そうでない場合は false

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

ReferringObjects コマンド (10)

これは JDWP バージョン 1.6 以降。canGetInstanceInfo 権限が必要です (CapabilitiesNew を参照)。

出力データ

objectID					object	オブジェクト ID
int					maxReferrers	返される参照オブジェクトの最大数。負でない数値。ゼロの場合、すべての参照オブジェクトが返される。

応答データ

int					referringObjects	あとに続くオブジェクトの数。
referringObjects 回の繰り返し:
	tagged-objectID				instance	このオブジェクトを参照するオブジェクト。

エラーデータ

INVALID_OBJECT	オブジェクトが既知の ID ではない。
ILLEGAL_ARGUMENT	maxReferrers がゼロより小さい。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

StringReference コマンドセット (10)

Value コマンド (1)

出力データ

objectID					stringObject	String オブジェクトの ID。

応答データ

string					stringValue	文字列の値の UTF-8 表現。

エラーデータ

INVALID_STRING	文字列が無効。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

ThreadReference コマンドセット (11)

Name コマンド (1)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

string					threadName	スレッドの名前。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Suspend コマンド (2)

java.lang.Thread.suspend() とは異なり、仮想マシンと個々のスレッド両方の中断がカウントされます。スレッドを再実行する前に、中断された回数と同じ数の再開が行われなければなりません。

コマンドを使って単一のスレッドを中断することには、java.lang.Thread.suspend() の場合と同様の危険があります。中断されたスレッドが実行中の別のスレッドに必要なモニターを保持している場合、ターゲット VM でデッドロックが発生する可能性があります (少なくとも、中断されたスレッドが再開されるまでの間)。

中断されたスレッドは、前述の JDI 再開メソッドの 1 つを使って再開されるまで中断状態を維持することが保証されます。ターゲット VM 内のアプリケーションが、中断したスレッドを {@link java.lang.Thread#resume} を使って再開することはできません。

これにより、スレッドのステータスが変化することはない点に注意してください (ThreadStatus を参照)。たとえば、このスレッドが実行中だった場合、ほかのスレッドからは依然として実行中に見えます。

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Resume コマンド (3)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Status コマンド (4)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

int					threadStatus	スレッドステータスコードの 1 つ。JDWP.ThreadStatus を参照
int					suspendStatus	中断ステータスコードの 1 つ。JDWP.SuspendStatus を参照

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

ThreadGroup コマンド (5)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

threadGroupID					group	このスレッドのスレッドグループ。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Frames コマンド (6)

出力データ

threadID					thread	スレッドのオブジェクト ID。
int					startFrame	取得する最初のフレームのインデックス。
int					length	取得するフレームのカウント (-1 は「残りすべて」の意味)。

応答データ

int					frames	取得されたフレーム数
frames 回の繰り返し:
	frameID				frameID	このフレームの ID。
	location				location	このフレームの現在位置

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

FrameCount コマンド (7)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

int					frameCount	このスレッドスタックのフレームカウント。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

OwnedMonitors コマンド (8)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

int					owned	所有するモニターの数
owned 回の繰り返し:
	tagged-objectID				monitor	所有するモニター

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

CurrentContendedMonitor コマンド (9)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

tagged-objectID					monitor	競合するモニター、または null (競合するモニターが現在は存在しない場合)。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

Stop コマンド (10)

出力データ

threadID					thread	スレッドのオブジェクト ID。
objectID					throwable	非同期の例外。このオブジェクトは、java.lang.Throwable のインスタンスまたはサブクラスでなければならない

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	スレッドが既知の ID ではない、または非同期の例外がガベージコレクトされている。
VM_DEAD	仮想マシンが動作していない。

Interrupt コマンド (11)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

SuspendCount コマンド (12)

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

int					suspendCount	このスレッドの未処理の中断の回数。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

OwnedMonitorsStackDepthInfo コマンド (13)

これは JDWP バージョン 1.6 以降。

出力データ

threadID					thread	スレッドのオブジェクト ID。

応答データ

int					owned	所有するモニターの数
owned 回の繰り返し:
	tagged-objectID				monitor	所有するモニター
	int				stack_depth	モニターが取得されたスタック深度の位置

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

ForceEarlyReturn コマンド (14)

早期復帰するメソッドを「被呼び出しメソッド」と呼びます。被呼び出しメソッドは、Java™ 仮想マシン仕様のフレームのセクションに定義されているとおり、このコマンドの受信時に、指定されたスレッドの現在のメソッドになります。

指定されるスレッドは、中断されている必要があります。メソッドの復帰は、Java プログラミング言語のコードの実行がこのスレッド上で再開されたときに行われます。このコマンドが送信されてからスレッドの実行が再開されるまでの間、スタックの状態は未定義です。

被呼び出しメソッドでは、これ以上の命令は実行されません。特に、最終的にブロックは実行されません。注:これにより、アプリケーション内で整合性のない状態が発生することがあります。

被呼び出しメソッドを呼び出すことによって獲得されたロック (これが synchronized メソッドの場合) と、被呼び出しメソッド内の synchronized ブロックに入ることによって獲得されたロックは解除されます。注:これは、JNI ロックや java.util.concurrent.locks ロックには適用されません。

通常復帰の場合と同様に、MethodExit などのイベントが生成されます。

被呼び出しメソッドは、非ネイティブの Java プログラミング言語のメソッドとします。スタック上にフレームが 1 つだけある状態でスレッドへの強制復帰を行なった場合、スレッドが再開時に終了します。

void メソッドの場合、値は void 値である必要があります。プリミティブ値を返すメソッドの場合、値の型と戻り値の型は正確に一致している必要があります。オブジェクト値の場合、値型から戻り値の型への広範な参照変換が存在し、かつ戻り値の型がロードされている必要があります。

これは JDWP バージョン 1.6 以降。canForceEarlyReturn 権限が必要です (CapabilitiesNew を参照)。

出力データ

threadID					thread	スレッドのオブジェクト ID。
value					value	返す値。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	スレッドまたは値が既知の ID ではない。
THREAD_NOT_SUSPENDED	指定されたスレッドは、イベントによって中断されていない。
THREAD_NOT_ALIVE	スレッドが開始されていないか、すでに終了している。
OPAQUE_FRAME	ネイティブメソッドに対応するフレームからの早期復帰が試みられた。または、実装がこのフレーム上でこの機能を提供できない。
NO_MORE_FRAMES	呼び出しスタックに Java または JNI フレームはもうない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
TYPE_MISMATCH	値の型がメソッドの戻り値に適合しない。
VM_DEAD	仮想マシンが動作していない。

ThreadGroupReference コマンドセット (12)

Name コマンド (1)

出力データ

threadGroupID					group	スレッドグループのオブジェクト ID。

応答データ

string					groupName	スレッドグループの名前。

エラーデータ

INVALID_THREAD_GROUP	スレッドグループが無効。
INVALID_OBJECT	group が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Parent コマンド (2)

出力データ

threadGroupID					group	スレッドグループのオブジェクト ID。

応答データ

threadGroupID					parentGroup	親スレッドグループオブジェクト、または null (指定されたスレッドグループがトップレベルのスレッドグループの場合)

エラーデータ

INVALID_THREAD_GROUP	スレッドグループが無効。
INVALID_OBJECT	group が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

Children コマンド (3)

出力データ

threadGroupID					group	スレッドグループのオブジェクト ID。

応答データ

int					childThreads	子スレッドの数。
childThreads 回の繰り返し:
	threadID				childThread	直接の子スレッド ID。
int					childGroups	子スレッドグループの数。
childGroups 回の繰り返し:
	threadGroupID				childGroup	直接の子スレッドグループの ID。

エラーデータ

INVALID_THREAD_GROUP	スレッドグループが無効。
INVALID_OBJECT	group が既知の ID ではない。
VM_DEAD	仮想マシンが動作していない。

ArrayReference コマンドセット (13)

Length コマンド (1)

出力データ

arrayID					arrayObject	配列のオブジェクト ID。

応答データ

int					arrayLength	配列の長さ。

エラーデータ

INVALID_OBJECT	arrayObject が既知の ID ではない。
INVALID_ARRAY	配列が無効。
VM_DEAD	仮想マシンが動作していない。

GetValues コマンド (2)

出力データ

arrayID					arrayObject	配列のオブジェクト ID。
int					firstIndex	取得する最初のインデックス。
int					length	取得するコンポーネントの数。

応答データ

arrayregion					values	取得した値。値がオブジェクトの場合、タグ付けされた値になる。それ以外の場合は、タグ付けされていない値になる

エラーデータ

INVALID_LENGTH	インデックスがこの配列の最後を越えている場合。
INVALID_OBJECT	arrayObject が既知の ID ではない。
INVALID_ARRAY	配列が無効。
VM_DEAD	仮想マシンが動作していない。

SetValues コマンド (3)

出力データ

arrayID					arrayObject	配列のオブジェクト ID。
int					firstIndex	設定する最初のインデックス。
int					values	設定する値の数。
values 回の繰り返し:
	untagged-value				value	設定する値。

応答データ

(なし)

エラーデータ

INVALID_LENGTH	インデックスがこの配列の最後を越えている場合。
INVALID_OBJECT	arrayObject が既知の ID ではない。
INVALID_ARRAY	配列が無効。
VM_DEAD	仮想マシンが動作していない。

ClassLoaderReference コマンドセット (14)

VisibleClasses コマンド (1)

可視クラスリストには、型の名前空間に関して、便利な特性があります。特定の型の名前は、リスト中に最高 1 回しか出現しません。このクラスローダーにより定義されたクラスの型名を使って宣言されたフィールドまたは変数はそれぞれ、その単一の型に解決される必要があります。

返されるリストの順番は保証されていません。

出力データ

classLoaderID					classLoaderObject	クラスローダーのオブジェクト ID。

応答データ

int					classes	可視クラスの数。
classes 回の繰り返し:
	byte				refTypeTag	あとに続く参照型の種類。
	referenceTypeID				typeID	このクラスローダーに対する可視クラス。

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_CLASS_LOADER	クラスローダーが無効。
VM_DEAD	仮想マシンが動作していない。

EventRequest コマンドセット (15)

Set コマンド (1)

出力データ

byte					eventKind	要求するイベントの種類。要求できるイベントの全リストは、JDWP.EventKind を参照。要求するために権限が必要となるイベントもある。
byte					suspendPolicy	このイベントの発生時にどのスレッドを中断するか。イベントおよびコマンド応答の順序は、スレッドが中断および再開される順序を正確に反映するので要注意。たとえば、VM を中断するイベントの発生前に、VM 全体の再開が処理される場合、その再開コマンドへの応答は、中断イベントより前にトランスポートに書き込まれる。
int					modifiers	生成されるイベント数の制御に使用される制約。修飾子は、イベントがイベントキューに配置される前に満たす必要のある追加の条件を指定する。このコレクションに指定された順序で各修飾子をイベントに適用することにより、イベントはフィルタにかけられる。すべての修飾子の条件を満たすイベントだけがレポートされる。0 の値は、要求に修飾子が存在しないことを意味する。 ターゲット VM からデバッガ VM に送信されるイベントトラフィックの量を減らすことにより、フィルタ処理でデバッガのパフォーマンスを劇的に向上させることが可能。
modifiers 回の繰り返し:
	byte				modKind	修飾子の種類
	Case Count - modKind が 1 の場合:					要求されたイベントが報告される回数を最大で、指定された回数発生したあと 1 回に制限する。このフィルタが最初に count - 1 回に達する時点までは、イベントはレポートされない。1 回かぎりのイベントを要求するには、このメソッドをカウント 1 で呼び出せばよい。 カウントが 0 に達したあとは、この要求内の続くフィルタが適用される。それらのフィルタがいずれもイベントを抑制しない場合、そのイベントはレポートされる。そうでない場合、イベントはレポートされない。どちらの場合にも、この要求に対して、それ以降のイベントがレポートされることはない。この修飾子は、どんな種類のイベントにも使用できる。
		int			count	イベントを発生させる前のカウント。1 回かぎりのイベントで使用する。
	Case Conditional - modKind が 2 の場合:					式による条件
		int			exprID	将来の使用のために予約済み
	Case ThreadOnly - modKind が 3 の場合:					レポートされるイベントを、指定されたスレッド内のものに制限する。この修飾子は、クラスのアンロードを除く、すべての種類のイベントに使用できる。
		threadID			thread	要求されたスレッド
	Case ClassOnly - modKind が 4 の場合:					クラス準備イベントの場合に、この要求で生成されたイベントを制限して、指定された参照型および任意のサブタイプの準備となるようにする。モニター待機およびモニター待機終了イベントの場合、この要求で生成されるイベントを、指定された参照型またはその任意のサブタイプであるモニターオブジェクトを保持するイベントに限定する。それ以外のイベントの場合、この要求で生成されるイベントを、指定された参照型またはその任意のサブタイプ内で発生したものに限定する。イベントは、指定された参照型に安全にキャストできる参照型の中であれば、任意の位置で生成される。この修飾子は、クラスのアンロード、スレッド開始、およびスレッド終了を除く、すべての種類のイベントで使用できる。
		referenceTypeID			clazz	要求されたクラス
	Case ClassMatch - modKind が 5 の場合:					レポートされるイベントを、指定された限定的な正規表現に名前が一致するクラスのイベントに限定する。クラス準備イベントの場合、準備されたクラス名で判定される。クラスのアンロードイベントの場合、アンロードされたクラス名で判定される。モニター待機および待機終了イベントの場合、モニターオブジェクトのクラス名が一致する。それ以外のイベントの場合、イベントが発生した位置のクラス名で判定される。この修飾子は、スレッド開始およびスレッド終了を除く、すべての種類のイベントで使用できる。
		string			classPattern	要求されたクラスパターン。マッチ条件は、指定されたクラスパターンに正確に一致する場合と、パターンの最初または最後が「*」である場合 (たとえば、「*.Foo」、「java.*」) に限定される。
	Case ClassExclude - modKind が 6 の場合:					レポートされるイベントを、指定された限定的な正規表現に名前が一致しないクラスのイベントに限定する。クラス準備イベントの場合、準備されたクラス名で判定される。クラスのアンロードイベントの場合、アンロードされたクラス名で判定される。モニター待機および待機終了イベントの場合、モニターオブジェクトのクラス名が一致する。それ以外のイベントの場合、イベントが発生した位置のクラス名で判定される。この修飾子は、スレッド開始およびスレッド終了を除く、すべての種類のイベントで使用できる。
		string			classPattern	許可されないクラスパターン。マッチ条件は、指定されたクラスパターンに正確に一致する場合と、パターンの最初または最後が「*」である場合 (たとえば、「*.Foo」、「java.*」) に限定される。
	Case LocationOnly - modKind が 7 の場合:					レポートされるイベントを、指定された場所で発生するイベントに限定する。この修飾子は、ブレークポイント、フィールドアクセス、フィールド変更、ステップ、および例外の各イベントで使用できる。
		location			loc	要求される場所
	Case ExceptionOnly - modKind が 8 の場合:					レポートされる例外を、クラスと、それがキャッチされるかどうかを基準にして限定する。この修飾子は、例外イベントでのみ使用できる。
		referenceTypeID			exceptionOrNull	レポートされる例外。null (0) は、すべての種類の例外をレポートするという意味。null 以外の場合は、レポートされる例外イベントを、指定された型またはその任意のサブタイプに限定する。
		boolean			caught	キャッチされた例外をレポートする
		boolean			uncaught	キャッチされなかった例外をレポートする。例外がキャッチされたかどうかは、例外がスローされた時点でいつも判断できるとはかぎらない。詳細は、複合イベントの例外イベントのキャッチ位置に関する説明を参照。
	Case FieldOnly - modKind が 9 の場合:					レポートされるイベントを、指定されたフィールドで発生するイベントに限定する。この修飾子は、フィールドアクセスおよびフィールド変更イベントでのみ使用できる。
		referenceTypeID			declaring	フィールドが宣言されている型。
		fieldID			fieldID	要求されたフィールド
	Case Step - modKind が 10 の場合:					レポートされるステップイベントを、深さおよびサイズの制限を満たすものに限定する。この修飾子は、ステップイベントでのみ使用できる。
		threadID			thread	ステップ実行を行うスレッド
		int			size	各ステップのサイズ。JDWP.StepSize を参照
		int			depth	相対呼び出しスタックの制限。JDWP.StepDepth を参照
	Case InstanceOnly - modKind が 11 の場合:					レポートされるイベントを、指定されたオブジェクトがアクティブな「this」オブジェクトであるイベントに限定する。static メソッドの場合のマッチ条件は、null オブジェクト。この修飾子は、クラス準備、クラスのアンロード、スレッド開始、およびスレッド終了を除く、すべての種類のイベントで使用できる。この修飾子は、JDWP バージョン 1.4 で導入された。
		objectID			instance	要求された「this」オブジェクト
	Case SourceNameMatch - modKind が 12 の場合:					レポートされるクラス準備イベントを、指定された限定的な正規表現に一致するソース名を持つ参照型に限定する。ソース名は、参照型の SourceDebugExtension により決定される。この修飾子は、クラス準備イベントでのみ使用できる。これは JDWP バージョン 1.6 以降。canUseSourceNameFilters 権限が必要 (CapabilitiesNew を参照)。
		string			sourceNamePattern	要求されたソース名パターン。マッチ条件は、指定されたパターンに正確に一致する場合と、パターンの最初または最後が「*」である場合 (たとえば、「*.Foo」、「java.*」) に限定される。

応答データ

int					requestID	作成された要求の ID

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_CLASS	無効なクラス。
INVALID_STRING	文字列が無効。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_COUNT	カウントが無効。
INVALID_FIELDID	無効なフィールド。
INVALID_METHODID	無効なメソッド。
INVALID_LOCATION	無効な位置。
INVALID_EVENT_TYPE	指定されたイベントタイプの ID が認識されない。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

Clear コマンド (2)

出力データ

byte					eventKind	解除するイベントタイプ
int					requestID	解除する要求の ID

応答データ

(なし)

エラーデータ

VM_DEAD	仮想マシンが動作していない。
INVALID_EVENT_TYPE	指定されたイベントタイプの ID が認識されない。

ClearAllBreakpoints コマンド (3)

出力データ

(なし)

応答データ

(なし)

エラーデータ

VM_DEAD

仮想マシンが動作していない。

StackFrame コマンドセット (16)

GetValues コマンド (1)

出力データ

threadID					thread	フレームのスレッド。
frameID					frame	フレーム ID。
int					slots	取得する値の数。
slots 回の繰り返し:
	int				slot	フレーム内の局所変数のインデックス。
	byte				sigbyte	変数の型を識別するタグ

応答データ

int					values	取得された値の数。slots の取得する値の数と常に等しい。
values 回の繰り返し:
	value				slotValue	局所変数の値。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_FRAMEID	無効な jframeID。
INVALID_SLOT	無効なスロット。
VM_DEAD	仮想マシンが動作していない。

SetValues コマンド (2)

局所変数の情報を利用できなくても、フロントエンドが正しい局所変数インデックスを判別できる場合は、値の設定が可能です。一般に、局所変数テーブルの情報にアクセスしなくても、メソッドシグニチャーからメソッド引数について変数のインデックスを判別できます。

出力データ

threadID					thread	フレームのスレッド。
frameID					frame	フレーム ID。
int					slotValues	設定する値の数。
slotValues 回の繰り返し:
	int				slot	スロット ID。
	value				slotValue	設定する値。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_FRAMEID	無効な jframeID。
VM_DEAD	仮想マシンが動作していない。

ThisObject コマンド (3)

出力データ

threadID					thread	フレームのスレッド。
frameID					frame	フレーム ID。

応答データ

tagged-objectID					objectThis	このフレームについての「this」オブジェクト。

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
INVALID_FRAMEID	無効な jframeID。
VM_DEAD	仮想マシンが動作していない。

PopFrames コマンド (4)

これは JDWP バージョン 1.4 以降です。canPopFrames 権限が必要です (CapabilitiesNew を参照)。

出力データ

threadID					thread	スレッドのオブジェクト ID。
frameID					frame	フレーム ID。

応答データ

(なし)

エラーデータ

INVALID_THREAD	渡されたスレッドが null、有効でないスレッド、または終了している。
INVALID_OBJECT	thread が既知の ID ではない。
INVALID_FRAMEID	無効な jframeID。
THREAD_NOT_SUSPENDED	指定されたスレッドは、イベントによって中断されていない。
NO_MORE_FRAMES	呼び出しスタックに Java または JNI フレームはもうない。
INVALID_FRAMEID	無効な jframeID。
NOT_IMPLEMENTED	この機能はこの仮想マシンに実装されていない。
VM_DEAD	仮想マシンが動作していない。

ClassObjectReference コマンドセット (17)

ReflectedType コマンド (1)

出力データ

classObjectID					classObject	クラスオブジェクト。

応答データ

byte					refTypeTag	あとに続く参照型の種類。
referenceTypeID					typeID	リフレクトされた参照型

エラーデータ

INVALID_OBJECT	この参照型はすでにアンロードされ、ガベージコレクトされた。
VM_DEAD	仮想マシンが動作していない。

Event コマンドセット (64)

Composite コマンド (100)

複合イベントとしてグループ化されるイベントには、次の方法で制限が課されます。

• 同一スレッドに対するほかのスレッド開始イベントとのみ一緒にされる:
  • スレッド開始イベント
• 同一スレッドに対するほかのスレッド終了イベントとのみ一緒にされる:
  • スレッド終了イベント
• 同一クラスに対するほかのクラス準備イベントとのみ一緒にされる:
  • クラス準備イベント
• 同一クラスに対するほかのクラスアンロードイベントとのみ一緒にされる:
  • クラスアンロードイベント
• 同一フィールドアクセスに対するアクセスウォッチポイントイベントとのみ一緒にされる:
  • アクセスウォッチポイントイベント
• 同一フィールド変更に対するほかの変更ウォッチポイントイベントとのみ一緒にされる:
  • 変更ウォッチポイントイベント
• 同一モニターオブジェクトの Monitor contended enter イベントとのみ一緒にされる:
  • Monitor Contended Enter イベント
• 同一モニターオブジェクトの Monitor contended entered イベントとのみ一緒にされる:
  • Monitor Contended Entered イベント
• 同一モニターオブジェクトのモニター待機イベントとのみ一緒にされる:
  • モニター待機イベント
• 同一モニターオブジェクトのモニター待機終了イベントとのみ一緒にされる:
  • モニター待機終了イベント
• 同一の例外発生に対するほかの例外イベントとのみ一緒にされる:
  • 例外イベント
• 同一位置および同一スレッド内の、このグループのほかのメンバーとのみ一緒にされる:
  • ブレークポイントイベント
  • ステップイベント
  • メソッドエントリイベント
  • メソッド終了イベント

VM 開始イベントと VM 終了イベントは自動的に生成されるイベントです。つまり、EventRequest.Set コマンドを使ってこれらのイベントを要求する必要はありません。VM 開始イベントは、VM の初期化の完了を示します。VM 終了イベントは、VM の終了を示します。自動的に生成されるイベントが発生したときにデバッガが接続されている場合、そのイベントはターゲット VM から送信されます。自動的に生成されるイベントは、EventRequest.Set コマンドを使って要求することもできます。したがって、イベントの発生時に同じイベントの種類の複数のイベントがターゲット VM から送信されます。自動的に生成されるイベントは、イベントデータの requestID フィールドが 0 に設定された状態で送信されます。イベントデータの suspendPolicy フィールドの値は、イベントによって異なります。自動的に生成される VM 開始イベントの場合、suspendPolicy の値は定義されないため、実装固有または構成固有になります。たとえば、Sun の実装では、suspendPolicy は起動時の JDWP エージェントのオプションとして指定されます。自動的に生成される VM 終了イベントの suspendPolicy は NONE に設定されます。

イベントデータ

byte					suspendPolicy	この複合イベントによりどのスレッドが中断されるか
int					events	セット内のイベント。
events 回の繰り返し:
	byte				eventKind	イベントの種類のセレクタ
	Case VMStart - eventKind が JDWP.EventKind.VM_START の場合:					ターゲット VM の初期化の通知。このイベントは、メインスレッドの開始前、かつアプリケーションコードの実行前に受け取られる。このイベントが発生する前に、大量のシステムコードが実行され、多数のシステムクラスがロードされる。このイベントは、明示的に要求されていなくても、常にターゲット VM により生成される。
		int			requestID	イベントを生成させた要求 (イベントが自動的に生成された場合は 0)。
		threadID			thread	初期スレッド
	Case SingleStep - eventKind が JDWP.EventKind.SINGLE_STEP の場合:					ターゲット VM のステップ完了の通知。その位置のコードが実行される前に、ステップイベントが生成される。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	ステップ実行の行われたスレッド
		location			location	ステップ実行の行われた位置
	Case Breakpoint - eventKind が JDWP.EventKind.BREAKPOINT の場合:					ターゲット VM のブレークポイントの通知。その位置のコードが実行される前に、ブレークポイントイベントが生成される。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	ブレークポイントをヒットしたスレッド
		location			location	ヒットした位置
	Case MethodEntry - eventKind が JDWP.EventKind.METHOD_ENTRY の場合:					ターゲット VM のメソッド呼び出しの通知。このイベントは、呼び出されたメソッド内のコードが実行される前に生成される。メソッドエントリイベントは、ネイティブおよび非ネイティブのメソッドの両方で生成される。 いくつかの VM では、メソッドがスレッドの初期化の一部として呼び出された場合、特定のスレッドのスレッド開始イベントが発生する前に、そのスレッドについてのメソッドエントリイベントが発生することがある。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	メソッドに入ったスレッド
		location			location	メソッド内の初期実行可能ファイルの位置。
	Case MethodExit - eventKind が JDWP.EventKind.METHOD_EXIT の場合:					ターゲット VM のメソッド復帰の通知。このイベントは、メソッド内のすべてのコードが実行されたあとで生成される。ただし、このイベントの位置は、メソッド内で最後に実行された位置になる。メソッド終了イベントは、ネイティブおよび非ネイティブのメソッドの両方で生成される。メソッドが例外をスローして終了した場合、メソッド終了イベントは生成されない。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	メソッドから出たスレッド
		location			location	終了の位置
	Case MethodExitWithReturnValue - eventKind が JDWP.EventKind.METHOD_EXIT_WITH_RETURN_VALUE の場合:					ターゲット VM のメソッド復帰の通知。このイベントは、メソッド内のすべてのコードが実行されたあとで生成される。ただし、このイベントの位置は、メソッド内で最後に実行された位置になる。メソッド終了イベントは、ネイティブおよび非ネイティブのメソッドの両方で生成される。メソッドが例外をスローして終了した場合、メソッド終了イベントは生成されない。 これは JDWP バージョン 1.6 以降。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	メソッドから出たスレッド
		location			location	終了の位置
		value			value	メソッドから返される値
	Case MonitorContendedEnter - eventKind が JDWP.EventKind.MONITOR_CONTENDED_ENTER の場合:					ターゲット VM 内のスレッドが別のスレッドによってすでに獲得されているモニターに入ろうとする際の通知。canRequestMonitorEvents 権限が必要 (CapabilitiesNew を参照)。 これは JDWP バージョン 1.6 以降。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	モニターに入ろうとしているスレッド
		tagged-objectID			object	モニターオブジェクト参照
		location			location	競合するモニター開始の位置
	Case MonitorContendedEntered - eventKind が JDWP.EventKind.MONITOR_CONTENDED_ENTERED の場合:					ターゲット VM 内のスレッドが、別のスレッドによって獲得されたモニターが解放されるのを待ってモニターに入るときに送信される通知。canRequestMonitorEvents 権限が必要 (CapabilitiesNew を参照)。 これは JDWP バージョン 1.6 以降。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	モニターに入ったスレッド
		tagged-objectID			object	モニターオブジェクト参照
		location			location	競合するモニター開始の位置
	Case MonitorWait - eventKind が JDWP.EventKind.MONITOR_WAIT の場合:					モニターオブジェクト上で待機しようとしているスレッドの通知。canRequestMonitorEvents 権限が必要 (CapabilitiesNew を参照)。 これは JDWP バージョン 1.6 以降。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	待機しようとしているスレッド
		tagged-objectID			object	モニターオブジェクト参照
		location			location	待機が発生する位置
		long			timeout	スレッド待機時間 (単位はミリ秒)
	Case MonitorWaited - eventKind が JDWP.EventKind.MONITOR_WAITED の場合:					ターゲット VM 内のスレッドがモニターオブジェクト上での待機を終了するときに送信される通知。canRequestMonitorEvents 権限が必要 (CapabilitiesNew を参照)。 これは JDWP バージョン 1.6 以降。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	待機したスレッド
		tagged-objectID			object	モニターオブジェクト参照
		location			location	待機が発生した位置
		boolean			timed_out	タイムアウトした場合 true
	Case Exception - eventKind が JDWP.EventKind.EXCEPTION の場合:					ターゲット VM の例外通知。例外が非ネイティブメソッドからスローされた場合、例外イベントは例外がスローされた位置で生成される。例外がネイティブメソッドからスローされた場合、例外がスローされたあとの最初の非ネイティブ位置で例外イベントが生成される。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	例外付きのスレッド
		location			location	例外がスローされた位置 (または、ネイティブメソッドからスローされた場合は、スローされたあとの最初の非ネイティブの位置)
		tagged-objectID			exception	スローされた例外
		location			catchLocation	キャッチされた位置、または 0 (キャッチされなかった場合)。例外がキャッチされたと見なされるのは、スローの時点で、その例外を処理する try 文で現在の位置が動的に囲まれている場合。詳細は、JVM 仕様を参照。そのような try 文が存在する場合、キャッチの位置は、該当する catch 節内の最初の位置になる。 例外の発生時に呼び出しスタック内にネイティブメソッドが存在する場合は、返されるキャッチ位置について重要な制約があるので要注意。そのような場合、呼び出しスタック上の何らかのネイティブメソッドにより例外が処理されるかどうかは予測できない。そのため、ここでキャッチされなかったと見なされた例外が、実はネイティブメソッドによって処理されていて、ターゲット VM を終了させないという状況が起こり得る。さらに、ここで返されるキャッチ位置に、例外をスローしたスレッドが必ず到達すると見なすこともできない。現在位置とキャッチ位置との間にネイティブフレームが存在する場合には、例外がネイティブメソッド内で処理され、クリアーされる可能性がある。 ソースコード内に try-catch ブロックが明示的に記述されていない場合、コンパイラが try-catch ブロックを生成できることに注意。たとえば、synchronized および finally ブロックについて生成されるコードには、暗黙の try-catch ブロックが含まれることがある。例外のスロー時にその種の暗黙的に生成された try-catch ブロックが呼び出しスタック上に存在する場合は、ソースコード上では例外がキャッチされないように見えるとしても、例外はキャッチされたと見なされる。
	Case ThreadStart - eventKind が JDWP.EventKind.THREAD_START の場合:					ターゲット VM の新しい実行中スレッドの通知。新規スレッドは、java.lang.Thread.start を呼び出した結果として、または JNI を介して VM に新規スレッドを接続した結果として実行されるようになる。この通知は、新規スレッドにより、その実行が開始される少し前に生成される。このタイミングの影響で、このイベントが受信される前に、そのスレッドについてほかのイベントが受信される可能性がある。特に、メソッドエントリイベントおよびメソッド終了イベントは、スレッドの初期化中に発生することがある。また、VirtualMachine AllThreads コマンドが、あるスレッドを、そのスレッドのスレッド開始イベントが受信される前に返す可能性もある。 このイベントは、スレッドオブジェクトの作成については何の情報も提供しておらず、デバッグ対象の VM によっては、ずっと以前に作成されたスレッドである可能性もあるので、注意を要する。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	開始したスレッド
	Case ThreadDeath - eventKind が JDWP.EventKind.THREAD_DEATH の場合:					ターゲット VM の完了済みスレッドの通知。この通知は、終了しようとしているスレッドにより終了前に生成される。このタイミングのため、{@link VirtualMachine#allThreads} は、このイベントの受信後に、このスレッドを返すことができる。 このイベントは、スレッドオブジェクトの寿命については何の情報も提供しない。ターゲット VM にどんな参照が存在するかに応じて、すぐにガベージコレクトされることも、されないこともある。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	終了するスレッド
	Case ClassPrepare - eventKind が JDWP.EventKind.CLASS_PREPARE の場合:					ターゲット VM のクラス準備の通知。クラス準備の定義については、JVM 仕様を参照。プリミティブクラス (たとえば、java.lang.Integer.TYPE) の場合、クラス準備イベントは生成されない。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	準備が行われているスレッド。まれに、ターゲット VM 内のデバッガシステムスレッドでこのイベントが発生することがある。デバッガスレッドはこれらのイベントの発生を防ぐための予防措置を講じるが、ある状況下、特に java.lang.Error のいくつかのサブクラスでは回避できない。このイベントがデバッガシステムスレッドにより生成された場合、このメソッドが返す値は null になる。また、このイベントについて要求された中断ポリシーが EVENT_THREAD である場合は、そのポリシーに反してすべてのスレッドが中断させられ、複合イベントの中断ポリシーもその変更をリフレクトする。 前述の説明は、通常の (デバッグ以外の) 操作中にターゲット VM により作成されたシステムスレッドには当てはまらない。
		byte			refTypeTag	参照型の種類。JDWP.TypeTag を参照
		referenceTypeID			typeID	準備中の型
		string			signature	型シグニチャー
		int			status	型のステータス。JDWP.ClassStatus を参照
	Case ClassUnload - eventKind が JDWP.EventKind.CLASS_UNLOAD の場合:					ターゲット VM のクラスアンロードの通知。 ガベージコレクションの実行中にはデバッガのバックエンドに厳しい制約があるため、アンロード情報は大幅に制限されている。
		int			requestID	イベントを生成させたリクエスト
		string			signature	型シグニチャー
	Case FieldAccess - eventKind が JDWP.EventKind.FIELD_ACCESS の場合:					ターゲット VM のフィールドアクセスの通知。フィールドの変更は、フィールドアクセスとは見なされない。canWatchFieldAccess 権限が必要 (CapabilitiesNew を参照)。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	アクセス中のスレッド
		location			location	アクセスの位置
		byte			refTypeTag	参照型の種類。JDWP.TypeTag を参照
		referenceTypeID			typeID	フィールドの型
		fieldID			fieldID	アクセスされているフィールド
		tagged-objectID			object	アクセスされているオブジェクト (static の場合は null=0)
	Case FieldModification - eventKind が JDWP.EventKind.FIELD_MODIFICATION の場合:					ターゲット VM のフィールド変更の通知。canWatchFieldModification 権限が必要 (CapabilitiesNew を参照)。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	変更中のスレッド
		location			location	変更の位置
		byte			refTypeTag	参照型の種類。JDWP.TypeTag を参照
		referenceTypeID			typeID	フィールドの型
		fieldID			fieldID	変更されているフィールド
		tagged-objectID			object	変更されているオブジェクト (static の場合は null=0)
		value			valueToBe	割り当てられる値
	Case VMDeath - eventKind が JDWP.EventKind.VM_DEATH の場合:
		int			requestID	イベントを生成させたリクエスト

Error 定数