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

@Target(TYPE) @Retention(RUNTIME) @Inherited public @interface Enabled

Аннотация события, определяет, должен ли быть событие включено по умолчанию.

Если событие не имеет аннотации, то по умолчанию событие включено.

Следующий пример демонстрирует, как аннотация Enabled может быть использована для создания отключенного события. Отключенное событие, как максимум, будет иметь издержки на выделение памяти, или же вообще не будет, если компилятор JIT во время выполнения сможет его устранить.

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

public void update() {
    StopWatchEvent e = new StopWatchEvent();
    e.begin();
    ...
    e.commit();
}

Событие может быть включено программно или при необходимости в командной строке, например:

java -XX:StartFlightRecording:StopWatch#enabled=true ...

С момента:: 9

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`NAME`	Имя параметра `"enabled"`, обозначает, что событие должно быть записано.

Краткое описание необязательных элементов

Модификатор и тип	Необязательный элемент	Описание
`boolean`	`value`	Возвращает `true`, если событие по умолчанию должно быть включено, `false` в противном случае.

Подробное описание полей

NAME

static final String NAME

Имя параметра "enabled", обозначает, что событие должно быть записано.

См. также:

Подробное описание элементов

value

boolean value

Возвращает true, если событие по умолчанию должно быть включено, false в противном случае.

Возвращает:: true, если событие по умолчанию должно быть включено, false в противном случае

По умолчанию:: true

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/jdk.jfr/jdk/jfr/Enabled.html