Module jdk.management.jfr
Package jdk.management.jfr

Class RecordingInfo

java.lang.Object
jdk.management.jfr.RecordingInfo
public final class RecordingInfo extends Object
管理表示一个Recording。
自：
9
参见：

  • Method Summary

    Modifier and Type
    Method
    Description
    static RecordingInfo
    from(CompositeData cd)
    返回由指定的CompositeData对象表示的RecordingInfo。
    String
    getDestination()
    返回与此RecordingInfo关联的录制停止时应写入数据的目标路径，如果不应写入数据，则返回null。
    boolean
    getDumpOnExit()
    返回与此RecordingInfo关联的录制是否在JVM退出时应转储到文件。
    long
    getDuration()
    返回与此RecordingInfo关联的录制的期望持续时间（以秒为单位），如果未设置持续时间，则返回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()
    返回true如果与此RecordingInfo关联的录制在内存缓冲区已满时应刷新到磁盘，否则返回false。
    String
    toString()
    返回与此RecordingInfo关联的录制的字符串描述。

    Methods declared in class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Method Details

    • getName

      public String getName()
      返回与此RecordingInfo关联的录制的名称。
      返回：
      录制名称，非null
      参见：

    • getId

      public long getId()
      返回与此RecordingInfo关联的录制的唯一ID。
      返回：
      录制ID
      参见：

    • getDumpOnExit

      public boolean getDumpOnExit()
      返回与此RecordingInfo关联的录制是否在JVM退出时应转储到文件。
      返回：
      如果应在退出时转储录制，则返回true，否则返回false
      参见：

    • getMaxAge

      public long getMaxAge()
      返回数据应在磁盘上保留的秒数，如果数据应永久保留，则返回0。

      内存中的录制不受最大年龄的影响。

      返回：
      数据应在磁盘上保留的时间，以秒为单位
      参见：

    • getMaxSize

      public long getMaxSize()
      返回与此RecordingInfo关联的录制在被轮换之前应在磁盘上保留的数据量（以字节为单位），如果数据应无限期保留，则返回0。

      内存中的录制不受最大大小的影响。

      返回：
      数据应在磁盘上保留的量，以字节为单位
      参见：

    • getState

      public String getState()
      返回与此RecordingInfo关联的录制的状态的String表示。

      有效的返回值为"NEW"、"DELAYED"、"STARTING"、"RUNNING"、"STOPPING"、"STOPPED"和"CLOSED"。

      返回：
      录制状态，非null
      参见：

    • getStartTime

      public long getStartTime()
      返回与此RecordingInfo关联的录制的开始时间，以自纪元以来的毫秒数表示，如果录制尚未开始，则返回null。
      返回：
      录制的开始时间，如果录制尚未开始，则返回null
      参见：

    • getStopTime

      public long getStopTime()
      返回与此RecordingInfo关联的录制的实际或预期停止时间，以自纪元以来的毫秒数表示，如果预期或实际停止时间未知，则返回null，这只会在录制尚未停止时发生。
      返回：
      录制的停止时间，如果录制尚未停止，则返回null
      参见：

    • getSettings

      public Map<String,String> getSettings()
      返回与此RecordingInfo关联的录制的设置。
      返回：
      录制的设置，非null
      参见：

    • getDestination

      public String getDestination()
      返回与此RecordingInfo关联的录制停止时应写入数据的目标路径，如果不应写入数据，则返回null。
      返回：
      目标路径，如果未设置则返回null
      参见：

    • toString

      public String toString()
      返回与此RecordingInfo关联的录制的字符串描述。
      覆盖：
      toString 在类 Object中
      返回：
      描述，非null

    • getSize

      public long getSize()
      返回由此RecordingInfo关联的录制记录的数据量。
      返回：
      记录的数据量，以字节为单位

    • isToDisk

      public boolean isToDisk()
      返回true如果与此RecordingInfo关联的录制在内存缓冲区已满时应刷新到磁盘，否则返回false。
      返回：
      如果录制应转储到磁盘，则返回true，否则返回false

    • getDuration

      public long getDuration()
      返回与此RecordingInfo关联的录制的期望持续时间（以秒为单位），如果未设置持续时间，则返回0。
      返回：
      期望的持续时间，如果未设置持续时间，则返回0
      参见：

    • 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
      destination String
      duration Long
      settings javax.management.openmbean.CompositeData[]，其元素类型是SettingDescriptorInfo中指定的映射类型，如在SettingDescriptorInfo.from(javax.management.openmbean.CompositeData)方法中指定的那样。
      参数:
      cd - 表示要返回的RecordingInfo的CompositeData
      返回:
      由cd表示的RecordingInfo，如果cd为null则返回null
      抛出:
      IllegalArgumentException - 如果cd不表示有效的RecordingInfo