クラス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 Virtual Machine (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()
    記録の構成方法を指定する設定を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • メソッドの詳細

    • 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ではなく構成を含むファイル
      戻り値:
      nullではなくConfigurationを読み取ります
      スロー:
      ParseException - ファイルを解析できない場合
      IOException - ファイルを読み取れない場合
      関連項目:

    • 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ではなく、事前定義された構成のリスト