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
文字ストリームから構成を読み取ります。static Configuration
ファイルから構成を読み込みます。static Configuration
getConfiguration
(String name) 定義済みの構成を返します。static List
<Configuration> このJava Virtual Machine (JVM)の事前定義された構成の不変なリストを返します。構成(たとえば、JFCファイルの内容)のテキスト表現を返します。(例えば"Low overhead configuration safe for continuous use in production environments"
)の構成を説明する短い文を返しますgetLabel()
判読可能な名前("Continuous" or "Profiling"
など)を返します。getName()
識別名("default" or "profile")
など)を返します。構成(例えば"OpenJDK"
)を作成した担当者を返します。レコーディングの構成方法を指定する設定を返します。
-
メソッドの詳細
-
getSettings
-
getName
-
getLabel
-
getDescription
public String getDescription()(例えば"Low overhead configuration safe for continuous use in production environments"
)の構成を説明する短い文を返します- 戻り値:
- 説明(存在しない場合は
null
)
-
getProvider
-
getContents
-
create
public static Configuration create(Path path) throws IOException, ParseException ファイルから構成を読み込みます。- パラメータ:
path
-null
ではなく構成を含むファイル- 戻り値:
null
ではなくConfiguration
を読み取ります- 例外:
ParseException
- ファイルを解析できない場合IOException
- ファイルを読み取れない場合SecurityException
- セキュリティ・マネージャが存在し、そのcheckRead
メソッドがファイルへの読取りアクセスを拒否した場合。- 関連項目:
-
create
public static Configuration create(Reader reader) throws IOException, ParseException 文字ストリームから構成を読み取ります。- パラメータ:
reader
-null
ではなく構成の内容を提供するReader
- 戻り値:
- 構成、
null
でない - 例外:
IOException
-Reader
からの内容の読取り中にI/Oエラーが発生した場合ParseException
- ファイルを解析できない場合
-
getConfiguration
public static Configuration getConfiguration(String name) throws IOException, ParseException 定義済みの構成を返します。使用可能な構成名については、
getConfigurations()
を参照してください。- パラメータ:
name
- 構成(たとえば、"default"
や"profile"
などです。)の名前- 戻り値:
- 構成、
null
でない - 例外:
IOException
- 指定された名前の構成が存在しない場合、または構成ファイルの読取り中にI/Oエラーが発生した場合ParseException
- 構成ファイルを解析できない場合
-
getConfigurations
public static List<Configuration> getConfigurations()このJava Virtual Machine (JVM)の事前定義された構成の不変なリストを返します。- 戻り値:
null
ではなく、事前定義された構成のリスト
-