インタフェースClassPrepareRequest

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

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

導入されたバージョン:
1.3
関連項目:

  • フィールドのサマリー

    インタフェースで宣言されたフィールド EventRequest

    SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE
    修飾子と型
    フィールド
    説明
    static final int
    SUSPEND_ALL
    イベントの発生時に、すべてのスレッドを中断します。
    static final int
    SUSPEND_EVENT_THREAD
    イベントの発生時に、イベントを生成したスレッドだけを中断します。
    static final int
    SUSPEND_NONE
    イベントの発生時に、どのスレッドも中断しません。

  • メソッドのサマリー

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

    インタフェースで宣言されたメソッド EventRequest

    addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy
    修飾子と型
    メソッド
    説明
    void
    addCountFilter(int count)
    要求されたイベントが報告される回数を最大で、指定された回数発生したあと1回に制限する。
    void
    disable()
    setEnabled(false)と同じです。
    void
    enable()
    setEnabled(true)と同じです。
    Object
    getProperty(Object key)
    指定されたキーを持つプロパティの値を返します。
    boolean
    isEnabled()
    このイベント要求が現在有効かどうかを判定します。
    void
    putProperty(Object key, Object value)
    この要求に任意のキーと値の「プロパティ」を追加します。
    void
    setEnabled(boolean val)
    このイベント要求を有効または無効にします。
    void
    setSuspendPolicy(int policy)
    ターゲットVM内で要求されたイベントが発生する際に中断するスレッドを決定します。
    int
    suspendPolicy()
    ターゲットVM内で要求されたイベントが発生する際に中断するスレッドを示す値を返します。

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

    toString, virtualMachine
    修飾子と型
    メソッド
    説明
    String
    toString()
    このミラーについて説明する文字列を返します。
    VirtualMachine
    virtualMachine()
    このミラーが属する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