Интерфейс аннотации Enabled

@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://docs.oracle.com/en/java/javase/25/docs/api/jdk.jfr/jdk/jfr/Enabled.html