モジュール jdk.management.jfr
パッケージ jdk.management.jfr

クラスRecordingInfo

  • public final class RecordingInfo
extends Object
    Recordingの管理表現。
    導入されたバージョン:
    9
    関連項目:
    Recording

    • メソッドのサマリー

      すべてのメソッド 静的メソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      static RecordingInfo from​(CompositeData cd)
      指定されたCompositeDataオブジェクトによって表されるRecordingInfoを返します。
      String getDestination()
      このRecordingInfoに関連付けられた記録のデータが記録停止時に書き込まれる宛先パス、または記録が書き込まれる必要がない場合はnullを返します。
      boolean getDumpOnExit()
      JVMの終了時に、このRecordingInfoに関連付けられた記録をファイルにダンプする必要があるかどうかを返します。
      long getDuration()
      このRecordingInfoに関連付けられた記録の目的の期間(秒単位)を返します。期間が設定されていない場合は{code 0}を返します。
      long getId()
      このRecordingInfoに関連付けられたレコーディングの一意のIDを返します。
      long getMaxAge()
      データがディスクに保持される秒数を返します。データが永続的に保持される場合は0を返します。
      long getMaxSize()
      データ量をバイト単位で測定し、このRecordingInfoに関連付けられているレコーディングをディスクに保存しておくか、データを無期限に保持する場合は0を返します。
      String getName()
      このRecordingInfoに関連付けられている記録の名前を返します。
      Map<String,​String> getSettings()
      このRecordingInfoに関連付けられている記録の設定を返します。
      long getSize()
      記録によって記録された量データを返します。このRecordingInfoに関連付けられます。
      long getStartTime()
      このRecordingInfoに関連付けられた記録の開始時間(エポックからのミリ秒単位)を返します。記録が開始されていない場合はnullを返します。
      String getState()
      このRecordingInfoに関連付けられた記録の状態のString表現を返します。
      long getStopTime()
      このRecordingInfoに関連付けられている記録の実際の停止時間または予想される停止時間を、エポック以降のミリ秒として測定して戻します。または、予測停止時間または実際の停止時間がわからない場合はnullを返します。これは、記録がまだ停止していない場合にのみ発生する可能性があります。
      boolean isToDisk()
      メモリー・バッファが一杯になったときにRecordingInfoに関連付けられているレコーディングをディスクにフラッシュする必要がある場合はtrue、そうでない場合はfalseを返します。
      String toString()
      このRecordingInfoに関連付けられた記録の文字列説明を返します

    • メソッドの詳細

      • getName

        public String getName()
        このRecordingInfoに関連付けられている記録の名前を返します。
        戻り値:
        nullではなく、記録名
        関連項目:
        Recording.getName()

      • getId

        public long getId()
        このRecordingInfoに関連付けられたレコーディングの一意のIDを返します。
        戻り値:
        レコーディングID
        関連項目:
        Recording.getId()

      • getDumpOnExit

        public boolean getDumpOnExit()
        JVMの終了時に、このRecordingInfoに関連付けられた記録をファイルにダンプする必要があるかどうかを返します。
        戻り値:
        終了時に記録をダンプする場合はtrue、それ以外の場合はfalse
        関連項目:
        Recording.getDumpOnExit()

      • getMaxAge

        public long getMaxAge()
        データがディスクに保持される秒数を返します。データが永続的に保持される場合は0を返します。

        インメモリー・レコーディングは最大経過時間の影響を受けません。

        戻り値:
        ディスク上にデータを保持する時間(秒単位)
        関連項目:
        Recording.getMaxAge(), Recording.setToDisk(boolean)

      • getMaxSize

        public long getMaxSize()
        データ量をバイト単位で測定し、このRecordingInfoに関連付けられているレコーディングをディスクに保存しておくか、データを無期限に保持する場合は0を返します。

        インメモリー・レコーディングは最大サイズの影響を受けません。

        戻り値:
        ディスクに保持する必要があるデータ量(バイト)
        関連項目:
        Recording.setToDisk(boolean), Recording.getMaxSize()

      • getState

        public String getState()
        このRecordingInfoに関連付けられた記録の状態のString表現を返します。

        有効な戻り値は、"NEW"、"DELAYED"、"STARTING"、"RUNNING"、"STOPPING"、"STOPPED"および"CLOSED"です。

        戻り値:
        記録状態。nullではありません
        関連項目:
        Enum.toString(), Recording.getState()

      • getStartTime

        public long getStartTime()
        このRecordingInfoに関連付けられた記録の開始時間(エポックからのミリ秒単位)を返します。記録が開始されていない場合はnullを返します。
        戻り値:
        記録の開始時間。記録が開始されていない場合はnull
        関連項目:
        Recording.getStartTime()

      • getStopTime

        public long getStopTime()
        このRecordingInfoに関連付けられている記録の実際の停止時間または予想される停止時間を、エポック以降のミリ秒として測定して戻します。または、予測停止時間または実際の停止時間がわからない場合はnullを返します。これは、記録がまだ停止していない場合にのみ発生する可能性があります。
        戻り値:
        記録の停止時間。記録が停止していない場合はnull。
        関連項目:
        Recording.getStopTime()

      • getSettings

        public Map<String,​String> getSettings()
        このRecordingInfoに関連付けられている記録の設定を返します。
        戻り値:
        nullではなく記録設定
        関連項目:
        Recording.getSettings()

      • getDestination

        public String getDestination()
        このRecordingInfoに関連付けられた記録のデータが記録停止時に書き込まれる宛先パス、または記録が書き込まれる必要がない場合はnullを返します。
        戻り値:
        宛先、または設定されていない場合はnull
        関連項目:
        Recording.getDestination()

      • toString

        public String toString()
        このRecordingInfoに関連付けられた記録の文字列説明を返します
        オーバーライド:
        toString、クラスObject
        戻り値:
        説明(nullではありません)

      • getSize

        public long getSize()
        記録によって記録された量データを返します。このRecordingInfoに関連付けられます。
        戻り値:
        記録されたデータの量(バイト単位)

      • isToDisk

        public boolean isToDisk()
        メモリー・バッファが一杯になったときにRecordingInfoに関連付けられているレコーディングをディスクにフラッシュする必要がある場合はtrue、そうでない場合はfalseを返します。
        戻り値:
        記録がディスクの場合はtrue、それ以外の場合はfalse

      • getDuration

        public long getDuration()
        このRecordingInfoに関連付けられた記録の目的の期間(秒単位)を返します。期間が設定されていない場合は{code 0}を返します。
        戻り値:
        必要な期間、または期間が設定されていない場合は{code 0}
        関連項目:
        Recording.getDuration()

      • from

        public static RecordingInfo from​(CompositeData cd)
        指定されたCompositeDataオブジェクトによって表されるRecordingInfoを返します。

        指定したCompositeDataには、次のアイテム名およびアイテム・タイプが有効になる必要があります。

        指定されたCompositeDataオブジェクトでサポートされている名前と型
        名前 型
        id Long
        name String
        state String
        dumpOnExit Boolean
        size Long
        toDisk Boolean
        maxAge Long
        maxSize Long
        startTime Long
        stopTime Long
        宛先 String
        duration Long
        設定 SettingDescriptorInfo.from(javax.management.openmbean.CompositeData)メソッドで指定されたSettingDescriptorInfoのマップされた型が要素型であるjavax.management.openmbean.CompositeData[]。

        パラメータ:
        cd - 返されるRecordingInfoを表すCompositeData
        戻り値:
        cdで表されるRecordingInfo、またはcdがnullの場合はnull
        例外:
        IllegalArgumentException - cdが有効なRecordingInfoを表していない場合