Класс Configuration

java.lang.Object

jdk.jfr.Configuration

public final class Configuration extends Object

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

Since:: 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 объекта не изменяет конфигурацию.

Returns:: настройки, а не null

getName

public String getName()

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

Returns:: имя или null, если имя отсутствует

getLabel

public String getLabel()

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

Returns:: метку или null если она отсутствует

getDescription

public String getDescription()

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

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

)

Returns:: описание или null если оно отсутствует

getProvider

public String getProvider()

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

Returns:: создателя или null если он отсутствует

getContents

public String getContents()

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

Returns:

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

See Also:

getContents()

create

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

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

Parameters:

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

Returns:

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

Throws:

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

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

SecurityException - если существует менеджер безопасности, и его метод checkRead запрещает чтение файла.

See Also:

create

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

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

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

getConfiguration

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

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

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

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

getConfigurations

public static List<Configuration> getConfigurations()

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

Returns:: список предопределённых конфигураций, а не null

© 1993, 2021, 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/17/docs/api/jdk.jfr/jdk/jfr/Configuration.html