モジュール 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

  • メソッドの詳細

    • 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