Класс Configuration

java.lang.Object

jdk.jfr.Configuration

public final class Configuration extends Object

Коллекция настроек и метаданных, описывающих конфигурацию.

Следующий пример демонстрирует, как использовать класс Configuration для перечисления доступных конфигураций и передачи объекта конфигурации в Recording.

public static void main(String... args) throws Exception {
    if (args.length == 0) {
        System.out.println("Configurations:");
        for (Configuration c : Configuration.getConfigurations()) {
            System.out.println("Name: " + c.getName());
            System.out.println("Label: " + c.getLabel());
            System.out.println("Description: " + c.getDescription());
            System.out.println("Provider: " + c.getProvider());
            System.out.println();
        }
    } else {
        String name = args[0];
        Configuration c = Configuration.getConfiguration(name);
        try (Recording r = new Recording(c)) {
            System.out.println("Starting recording with settings:");
            for (Map.Entry<String, String> setting : c.getSettings().entrySet()) {
                System.out.println(setting.getKey() + " = " + setting.getValue());
            }
            r.start();
        }
    }
}

С момента:: 9

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

Модификатор и тип	Метод	Описание
`static Configuration`	`create(Reader reader)`	Считывает конфигурацию из потока символов.
`static Configuration`	`create(Path path)`	Считывает конфигурацию из файла.
`static Configuration`	`getConfiguration(String name)`	Возвращает предопределённую конфигурацию.
`static List<Configuration>`	`getConfigurations()`	Возвращает неизменяемый список предопределённых конфигураций для данной виртуальной машины Java (JVM).
`String`	`getContents()`	Возвращает текстовое представление конфигурации (например, содержимое файла JFC).
`String`	`getDescription()`	Возвращает краткое описание конфигурации (например, `"Low overhead configuration safe for continuous use in production environments"`).
`String`	`getLabel()`	Возвращает удобочитаемое имя (например, `"Continuous" or "Profiling"`).
`String`	`getName()`	Возвращает идентифицирующее имя (например, `"default" or "profile")`).
`String`	`getProvider()`	Возвращает информацию о создателе конфигурации (например, `"OpenJDK"`).
`Map<String,String>`	`getSettings()`	Возвращает настройки, определяющие конфигурацию записи.

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

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

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

getSettings

public Map<String,String> getSettings()

Возвращает настройки, определяющие конфигурацию записи.

Изменение возвращаемого объекта Map не изменяет конфигурацию.

Возвращает:: настройки, не null

getName

public String getName()

Возвращает идентифицирующее имя (например, "default" or "profile")).

Возвращает:: имя или null, если оно отсутствует

getLabel

public String getLabel()

Возвращает удобочитаемое имя (например, "Continuous" or "Profiling").

Возвращает:: метку или null, если она отсутствует

getDescription

public String getDescription()

Возвращает краткое описание конфигурации (например,

"Low
 overhead configuration safe for continuous use in production
 environments"

Возвращает:: описание или null, если оно отсутствует

getProvider

public String getProvider()

Возвращает информацию о создателе конфигурации (например, "OpenJDK").

Возвращает:: создателя или null, если он отсутствует

getContents

public String getContents()

Возвращает текстовое представление конфигурации (например, содержимое файла JFC).

Возвращает:

содержимое или null, если оно отсутствует

См. также:

create

public static Configuration create(Path path) throws IOException, ParseException

Считывает конфигурацию из файла.

Параметры:

path - файл, содержащий конфигурацию, не null

Возвращает:

прочитанную Configuration, не null

Исключения:

ParseException - если файл не может быть распарсен

IOException - если файл не может быть прочитан

См. также:

create

public static Configuration create(Reader reader) throws IOException, ParseException

Считывает конфигурацию из потока символов.

Параметры:: reader - поток, содержащий содержимое конфигурации, не null
Возвращает:: конфигурацию, не null
Исключения:: IOException - если произошла ошибка ввода-вывода при чтении содержимого из Reader; ParseException - если файл не может быть распарсен

getConfiguration

public static Configuration getConfiguration(String name) throws IOException, ParseException

Возвращает предопределённую конфигурацию.

См. getConfigurations() для доступных имён конфигураций.

Параметры:: name - имя конфигурации (например, "default" или "profile")
Возвращает:: конфигурацию, не null
Исключения:: IOException - если конфигурация с данным именем не существует или при возникновении ошибки ввода-вывода при чтении файла конфигурации; ParseException - если файл конфигурации не может быть распарсен

getConfigurations

public static List<Configuration> getConfigurations()

Возвращает неизменяемый список предопределённых конфигураций для данной виртуальной машины Java (JVM).

Возвращает:: список предопределённых конфигураций, не 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.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.jfr/jdk/jfr/Configuration.html