Spec-Zone.ru › OpenJDK 25

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

@Retention(RUNTIME) @Inherited @Target(TYPE) public @interface Period
Аннотация события, задающая значение настройки по умолчанию для периодического события.

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

@Period("1 s")
@Name("Counter")
class CountEvent extends Event {
    int count;
}
@Period("3 s")
@Name("Fizz")
class FizzEvent extends Event {
}
@Period("5 s")
@Name("Buzz")
class BuzzEvent extends Event {
}

var counter = new AtomicInteger();
FlightRecorder.addPeriodicEvent(CountEvent.class, () -> {
    CountEvent event = new CountEvent();
    event.count = counter.incrementAndGet();
    event.commit();
});
FlightRecorder.addPeriodicEvent(FizzEvent.class, () -> {
    new FizzEvent().commit();
});
FlightRecorder.addPeriodicEvent(BuzzEvent.class, () -> {
    new BuzzEvent().commit();
});

var sb = new StringBuilder();
var last = new AtomicInteger();
var current = new AtomicInteger();
try (var r = new RecordingStream()) {
    r.onEvent("Counter", e -> current.set(e.getValue("count")));
    r.onEvent("Fizz", e -> sb.append("Fizz"));
    r.onEvent("Buzz", e -> sb.append("Buzz"));
    r.onFlush(() -> {
        if (current.get() != last.get()) {
            System.out.println(sb.isEmpty() ? current : sb);
            last.set(current.get());
            sb.setLength(0);
        }
    });
    r.start();
}
Начиная с:
9

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

Модификатор и тип Поле Описание
static final String NAME
Имя настройки "period" для настройки периодических событий

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

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

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

NAME

static final String NAME
Имя настройки "period" для настройки периодических событий
См. также:
  • Значения константных полей

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

value

String value
Возвращает значение настройки по умолчанию для периодической настройки.

Строковое представление положительного значения Long, за которым следует пробел и одна из следующих единиц измерения:

"ns" (наносекунды)
"us" (микросекунды)
"ms" (миллисекунды)
"s" (секунды)
"m" (минуты)
"h" (часы)
"d" (дни)

Примеры значений: "0 ns", "10 ms" и "1 s".

Период также может быть "everyChunk", чтобы указать, что событие происходит как минимум один раз для каждого файла записи. Количество создаваемых событий зависит от того, сколько раз выполняется ротация файлов во время записи данных.

Возвращает:
значение настройки по умолчанию, не null
По умолчанию:
"everyChunk"

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/Period.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API