モジュール jdk.jdi

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

インタフェースExceptionRequest

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

EventRequest, Mirror

public interface ExceptionRequest extends EventRequest

ターゲットVMで例外が発生する際の通知要求です。 有効なExceptionRequestが満たされると、ExceptionEventを含むevent setがEventQueueに置かれます。 既存のExceptionRequestのコレクションは、EventRequestManagerによって管理されます。

導入されたバージョン:

1.3

関連項目:

• ExceptionEvent
• 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)	この要求によって生成されるイベントを、指定されたスレッド内にあるものに制限します。
ReferenceType	exception()	どの例外型に対して例外イベントが要求されたかを返します。
boolean	notifyCaught()	要求された型のキャッチされた例外が、スロー時にイベントを生成するかどうかを返します。
boolean	notifyUncaught()	要求された型のキャッチされない例外が、スロー時にイベントを生成するかどうかを返します。

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

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

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

toString, virtualMachine

メソッドの詳細

exception

ReferenceType exception()

どの例外型に対して例外イベントが要求されたかを返します。

戻り値:

EventRequestManager.createExceptionRequest(com.sun.jdi.ReferenceType, boolean, boolean)で要求された例外(およびそのサブクラス)、またはすべての例外が要求された場合(デフォルト)はnull。

notifyCaught

boolean notifyCaught()

要求された型のキャッチされた例外が、スロー時にイベントを生成するかどうかを返します。

例外がスローされる時点では、その例外が本当にキャッチされるかどうかを常に判定できるわけではありません。 詳細は、ExceptionEvent.catchLocation()を参照してください。

戻り値:

キャッチされた例外が報告される場合はboolean型のtrue、それ以外の場合はfalse。

notifyUncaught

boolean notifyUncaught()

要求された型のキャッチされない例外が、スロー時にイベントを生成するかどうかを返します。

例外がスローされる時点では、その例外が本当にキャッチされないかどうかを常に判定できるわけではありません。 詳細は、ExceptionEvent.catchLocation()を参照してください。

戻り値:

キャッチされた例外が報告される場合はboolean型のtrue、それ以外の場合はfalse。

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)

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

パラメータ:

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

例外:

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

addInstanceFilter

void addInstanceFilter(ObjectReference instance)

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

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

パラメータ:

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

例外:

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

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

導入されたバージョン:

1.4