Класс 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 |
Читает конфигурацию из потока символов. |
static Configuration |
create |
Читает конфигурацию из файла. |
static Configuration |
getConfiguration |
Возвращает предопределенную конфигурацию. |
static List |
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 |
getSettings() |
Возвращает настройки, определяющие, как настраивается запись. |
Подробное описание методов
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()
- Возвращает:
- содержимое или
nullпри отсутствии - См. также:
create
public static Configuration create(Path path) throws IOException, ParseException
- Параметры:
-
path- файл, содержащий конфигурацию, а неnull - Возвращает:
- прочитанную
Configuration, а неnull - Исключения:
-
ParseException- если файл не может быть распарсен -
IOException- если файл не может быть прочитан -
SecurityException- если существует менеджер безопасности, и его методcheckReadзапрещает чтение файла. - См. также:
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()
- Возвращает:
- список предопределенных конфигураций, а не
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