モジュール jdk.jfr
パッケージ jdk.jfr

注釈インタフェースEnabled

@Target(TYPE) @Retention(RUNTIME) @Inherited public @interface Enabled
イベント注釈は、デフォルトでイベントを有効にするかどうかを決定します。

イベントに注釈がない場合、デフォルトでイベントは有効になっています。

次の例は、Enabled注釈を使用して無効化されたイベントを作成する方法を示しています。 無効なイベントは、ほとんどの場合割り当てのオーバーヘッドを持ちます。または、実行時JITコンパイラで削除できる場合は何もありません。 

@Name("StopWatch")
@Label("Stop Watch")
@Category("Debugging")
@StackTrace(false)
@Enabled(false)
static public class StopWatchEvent extends Event {
}

public void update() {
    StopWatchEvent e = new StopWatchEvent();
    e.begin();
    ...
    e.commit();
}
イベントは、プログラム的に、または必要に応じてコマンド行で有効にできます。次に例を示します: 
java -XX:StartFlightRecording:StopWatch#enabled=true ...

導入されたバージョン:
9

  • オプション要素のサマリー

    オプションの要素
    修飾子と型
    任意要素
    説明
    boolean
    value
    デフォルトでイベントを有効にする必要がある場合はtrueを返し、それ以外の場合はfalseを返します。

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final String
    NAME
    "enabled"という名前を設定すると、イベントが記録されます。

  • フィールド詳細

    • NAME

      static final String NAME
      "enabled"という名前を設定すると、イベントが記録されます。
      関連項目:

  • 要素の詳細

    • value

      boolean value
      デフォルトでイベントを有効にする必要がある場合はtrueを返し、それ以外の場合はfalseを返します。
      戻り値:
      デフォルトでイベントを有効にする必要がある場合はtrue、それ以外の場合はfalse
      デフォルト:
      true