com.sun.jdi.request

インタフェースMethodEntryRequest

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

EventRequest, Mirror

@Exported
public interface MethodEntryRequest
extends EventRequest

ターゲットVM内でメソッドが呼び出される際の通知要求です。有効なMethodEntryRequestが満たされると、MethodEntryEventを含むevent setがEventQueueに置かれます。既存のMethodEntryRequestのコレクションは、EventRequestManagerによって管理されます。

導入されたバージョン:

1.3

関連項目:

MethodEntryEvent, 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	addInstanceFilter(ObjectReference instance) この要求により生成されるイベントを、現在実行中のインスタンス(「this」)が、指定されたオブジェクトであるものに制限します。
void	addThreadFilter(ThreadReference thread) この要求によって生成されるイベントを、指定されたスレッド内にあるものに制限します。

インタフェース com.sun.jdi.request.EventRequestから継承されたメソッド

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

インタフェース com.sun.jdi.Mirrorから継承されたメソッド

toString, virtualMachine

メソッドの詳細

addThreadFilter

void addThreadFilter(ThreadReference thread)

この要求によって生成されるイベントを、指定されたスレッド内にあるものに制限します。

パラメータ:

thread - フィルタするスレッド。

例外:

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

addClassFilter

void addClassFilter(ReferenceType refType)

この要求によって生成されるイベントを、メソッドが指定された参照型またはそのサブ型のいずれかであるものに制限します。イベントは、指定された参照型に安全にキャストできる参照型の中であれば、任意の位置で生成される。

パラメータ:

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

例外:

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

addClassFilter

void addClassFilter(String classPattern)

この要求によって生成されるイベントを、メソッドがこの制限された正規表現に一致する名前のクラス内にあるものに制限します。正規表現は、完全一致および「*」で始まるか「*」で終了するパターン(例、「*.Foo」や「java.*」)に制限されます。

パラメータ:

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

例外:

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

addClassExclusionFilter

void addClassExclusionFilter(String classPattern)

この要求によって生成されるイベントを、メソッドがこの制限された正規表現(例、「java.*」や「*.Foo」)に一致しない名前のクラス内にあるものに制限します。

パラメータ:

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

例外:

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

addInstanceFilter

void addInstanceFilter(ObjectReference instance)

この要求により生成されるイベントを、現在実行中のインスタンス(「this」)が、指定されたオブジェクトであるものに制限します。

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

パラメータ:

instance - このフィルタを合格するために現在のインスタンスである必要があるオブジェクト。

例外:

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

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

導入されたバージョン:

1.4