Класс EventSettings

java.lang.Object

jdk.jfr.EventSettings

public abstract class EventSettings extends Object

Вспомогательный класс для применения настроек событий к записи.

Объект EventSettings для записи можно получить, вызвав метод Recording.enable(String), настраиваемый с помощью цепочки вызовов методов.

В следующем примере показано, как использовать класс EventSettings.

try (Recording r = new Recording()) {
    r.enable("jdk.CPULoad")
     .withPeriod(Duration.ofSeconds(1));
    r.enable("jdk.FileWrite")
     .withoutStackTrace()
     .withThreshold(Duration.ofNanos(10));
    r.start();
    Thread.sleep(10_000);
    r.stop();
    r.dump(Files.createTempFile("recording", ".jfr"));
}

Начиная с:: 9

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract EventSettings`	`with(String name, String value)`	Задает значение настройки для события, связанного с этой настройкой события.
`final EventSettings`	`withoutStackTrace()`	Отключает трассировки стека для события, связанного с этой настройкой события.
`final EventSettings`	`withoutThreshold()`	Указывает, что пороговое значение не используется.
`final EventSettings`	`withPeriod(Duration duration)`	Задает интервал для события, связанного с этой настройкой события.
`final EventSettings`	`withStackTrace()`	Включает трассировки стека для события, связанного с этой настройкой события.
`final EventSettings`	`withThreshold(Duration duration)`	Задает пороговое значение для события, связанного с этой настройкой события.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не истечет определенное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не истечет определенное время.

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

withStackTrace

public final EventSettings withStackTrace()

Включает трассировки стека для события, связанного с этой настройкой события.

Эквивалентно вызову метода with("stackTrace", "true").

Возвращает:: объект настроек события для дальнейшей конфигурации, не null

withoutStackTrace

public final EventSettings withoutStackTrace()

Отключает трассировки стека для события, связанного с этой настройкой события.

Эквивалентно вызову метода with("stackTrace", "false").

Возвращает:: объект настроек события для дальнейшей конфигурации, не null

withoutThreshold

public final EventSettings withoutThreshold()

Указывает, что пороговое значение не используется.

Это вспомогательный метод, эквивалентный вызову метода with("threshold", "0 s").

Возвращает:: объект настроек события для дальнейшей конфигурации, не null

withPeriod

public final EventSettings withPeriod(Duration duration)

Задает интервал для события, связанного с этой настройкой события.

Параметры:: duration — длительность, не null
Возвращает:: объект настроек события для дальнейшей конфигурации, не null

withThreshold

public final EventSettings withThreshold(Duration duration)

Задает пороговое значение для события, связанного с этой настройкой события.

Параметры:: duration — длительность или null, если длительность не используется
Возвращает:: объект настроек события для дальнейшей конфигурации, не null

with

public abstract EventSettings with(String name, String value)

Задает значение настройки для события, связанного с этой настройкой события.

Параметры:: name — имя настройки (например, "threshold"); value — задаваемое значение (например, "20 ms", но не null)
Возвращает:: объект настроек события для дальнейшей конфигурации, не null

© 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.