モジュール jdk.jdi

パッケージ com.sun.jdi.request

インタフェースClassPrepareRequest

すべてのスーパー・インタフェース:

EventRequest, Mirror

public interface ClassPrepareRequest extends EventRequest

クラスがターゲットVM内で準備される際の通知要求です。 有効なClassPrepareRequestが満たされると、ClassPrepareEventを含むevent setがEventQueueに置かれます。 既存のClassPrepareRequestのコレクションは、EventRequestManagerによって管理されます。

クラスの準備は、Java Virtual Machine仕様で定義されています。

導入されたバージョン:

1.3

関連項目:

• ClassPrepareEvent
• EventQueue
• EventRequestManager

フィールドのサマリー

インタフェースcom.sun.jdi.request.EventRequestで宣言されているフィールド

SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE

メソッドのサマリー

修飾子と型	メソッド	説明
void	addClassExclusionFilter(String classPattern)	この要求によって生成されるイベントを、この制限された正規表現に一致しない名前を持つ参照型の準備に制限します。
void	addClassFilter(ReferenceType refType)	この要求によって生成されるイベントを、指定された参照型およびサブ型の準備に制限します。
void	addClassFilter(String classPattern)	この要求によって生成されるイベントを、この制限された正規表現に一致する名前を持つ参照型の準備に制限します。
void	addSourceNameFilter(String sourceNamePattern)	この要求によって生成されるイベントを、制限された正規表現sourceNamePatternが準備されている参照型のいずれかのsourceNameに一致する参照型の準備に制限します。

インタフェースcom.sun.jdi.request.EventRequestで宣言されたメソッド

addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy

インタフェースcom.sun.jdi.Mirrorで宣言されたメソッド

toString, virtualMachine

メソッドの詳細

addClassFilter

void addClassFilter(ReferenceType refType)

この要求によって生成されるイベントを、指定された参照型およびサブ型の準備に制限します。 イベントは、指定された参照型に安全にキャスト可能な、準備された参照型のために生成されます。

パラメータ:

refType - フィルタする参照型。

例外:

InvalidRequestStateException - この要求が現在有効になっている場合、または削除されている場合。 フィルタは無効な要求にだけ追加できる。

addClassFilter

void addClassFilter(String classPattern)

この要求によって生成されるイベントを、この制限された正規表現に一致する名前を持つ参照型の準備に制限します。 正規表現は、完全一致および「*」で始まるか「*」で終了するパターン(たとえば、「*.Foo」や「java.*」)に制限されます。

パラメータ:

classPattern - フィルタするためのパターン文字列。

例外:

InvalidRequestStateException - この要求が現在有効になっている場合、または削除されている場合。 フィルタは無効な要求にだけ追加できる。

addClassExclusionFilter

void addClassExclusionFilter(String classPattern)

この要求によって生成されるイベントを、この制限された正規表現に一致しない名前を持つ参照型の準備に制限します。 正規表現は、完全一致および「*」で始まるか「*」で終了するパターン(たとえば、「*.Foo」や「java.*」)に制限されます。

パラメータ:

classPattern - フィルタで除外するためのパターン文字。

例外:

InvalidRequestStateException - この要求が現在有効になっている場合、または削除されている場合。 フィルタは無効な要求にだけ追加できる。

addSourceNameFilter

void addSourceNameFilter(String sourceNamePattern)

この要求によって生成されるイベントを、制限された正規表現sourceNamePatternが準備されている参照型のいずれかのsourceNameに一致する参照型の準備に制限します。 すなわち、refTypeが準備されているReferenceTypeの場合、少なくとも1つの層があり、それをrefType.availableStrata();によって返されるリストで「someStratum」と呼ぶとします。そのため、refType.sourceNames(someStratam)によって返されるリスト上の名前は「sourceNamePattern」と一致します。 正規表現は、完全一致および「*」で始まるか「*」で終了するパターン(たとえば、「*.Foo」や「java.*」)に制限されます。

この操作は、ターゲットでサポートされていないことがあります。 この操作がサポートされているかどうかを確認するには、VirtualMachine.canUseSourceNameFilters()を使用します。

パラメータ:

sourceNamePattern - フィルタするためのパターン文字列。

例外:

UnsupportedOperationException - ターゲット仮想マシンがこの操作をサポートしていない場合。

InvalidRequestStateException - この要求が現在有効になっている場合、または削除されている場合。 フィルタは無効な要求にだけ追加できる。

導入されたバージョン:

1.6