• 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(tm)仮想マシン仕様の第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(tm)仮想マシン仕様の第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(tm)仮想マシン仕様の第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(tm)仮想マシン仕様の第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(tm)仮想マシン仕様の第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(tm)仮想マシン仕様のクラス・ファイル形式の説明に記載されている、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(tm)仮想マシン仕様のフレームのセクションに定義されているとおり、このコマンドの受信時に、指定されたスレッドの現在のメソッドになります。

指定されるスレッドは、中断されている必要があります。メソッドの復帰は、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のメソッド復帰の通知。このイベントはメソッド内のすべてのコードが実行されたあとで生成されますが、このイベントの位置はメソッド内で最後に実行された位置です。MethodExitEventは、ネイティブおよび非ネイティブ・メソッドの両方で生成されます。メソッドが例外をスローして終了した場合、MethodExitEventは生成されません。
		int			requestID	イベントを生成させたリクエスト
		threadID			thread	メソッドから出たスレッド
		location			location	終了の位置
	Case MethodExitWithReturnValue - eventKindがJDWP.EventKind.METHOD_EXIT_WITH_RETURN_VALUEの場合:					ターゲットVMのメソッド復帰の通知。このイベントはメソッド内のすべてのコードが実行されたあとで生成されますが、このイベントの位置はメソッド内で最後に実行された位置です。MethodExitEventは、ネイティブおよび非ネイティブ・メソッドの両方で生成されます。メソッドが例外をスローして終了した場合、MethodExitEventは生成されません。 これは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定数