Интерфейс аннотации включён

@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

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.jfr/jdk/jfr/Enabled.html