Spec-Zone.ru › OpenJDK 21

Класс 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 при отсутствии
См. также:
  • getContents()

create

public static Configuration create(Path path) throws IOException, ParseException
Читает конфигурацию из файла.
Параметры:
path - файл, содержащий конфигурацию, а не null
Возвращает:
прочитанную Configuration, а не null
Исключения:
ParseException - если файл не может быть распарсен
IOException - если файл не может быть прочитан
SecurityException - если существует менеджер безопасности, и его метод checkRead запрещает чтение файла.
См. также:
  • File.getPath()
  • SecurityManager.checkRead(java.lang.String)

create

public static Configuration create(Reader reader) throws IOException, ParseException
Читает конфигурацию из потока символов.
Параметры:
reader - 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, 2023, 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/21/docs/api/jdk.jfr/jdk/jfr/Configuration.html

Spec-Zone.ru

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