模块  jdk.management.jfr
软件包  jdk.management.jfr

Class RecordingInfo

  • public final class RecordingInfo
extends Object
    管理代表 Recording 。
    从以下版本开始：
    9
    另请参见：
    Recording

    • 方法摘要

      所有方法  静态方法  实例方法 具体的方法 
      变量和类型 方法 描述
      static RecordingInfo from​(CompositeData cd)
      返回 RecordingInfo由指定表示 CompositeData对象。
      String getDestination()
      返回目标路径，其中记录停止时应写入与此RecordingInfo关联的记录的数据，如果不应写入记录，则null 。
      boolean getDumpOnExit()
      返回当JVM退出时， RecordingInfo应将与此 RecordingInfo关联的记录转储到文件。
      long getDuration()
      返回与此RecordingInfo关联的记录的所需持续时间（以秒为单位），如果未设置持续时间，则返回{code 0}。
      long getId()
      返回与此 RecordingInfo关联的录制内容的唯一ID。
      long getMaxAge()
      返回数据应保留在磁盘上的 0如果要永久保存数据，则返回 0 。
      long getMaxSize()
      返回以字节为单位的数据量，与此 RecordingInfo相关联的记录应在磁盘旋转之前保留在磁盘上，如果要无限期保留数据，则返回 0 。
      String getName()
      返回与此 RecordingInfo关联的录制文件的名称。
      Map<String,​String> getSettings()
      返回与此 RecordingInfo关联的录制设置。
      long getSize()
      返回录制记录的数据量。 与此关联RecordingInfo 。
      long getStartTime()
      返回与此 RecordingInfo关联的录制的开始时间（以纪元为单位测量为ms），如果录制尚未开始，则 null 。
      String getState()
      返回与此 RecordingInfo关联的记录状态的 String表示。
      long getStopTime()
      返回与此 RecordingInfo关联的记录的实际或预期停止时间（以纪元为单位测量为ms），如果 null预期或实际停止时间，则 null ，这只有在录制尚未停止时才会发生。
      boolean isToDisk()
      返回 true如果与此相关的记录 RecordingInfo应刷新到磁盘，当内存缓冲区已满， 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应将与此 RecordingInfo关联的记录转储到文件。
        结果
        true如果录制应该在退出时转储，否则为 false
        另请参见：
        Recording.getDumpOnExit()

      • getMaxAge

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

        记忆中的记录不受最大年龄的影响。

        结果
        数据应保存在磁盘上的时间长度，以秒为单位
        另请参见：
        Recording.getMaxAge() ， Recording.setToDisk(boolean)

      • getMaxSize

        public long getMaxSize()
        返回以字节为单位的数据量，与此RecordingInfo相关联的记录应在磁盘旋转之前保留在磁盘上，如果要无限期保留数据，则返回0 。

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

        结果
        数据量应保存在磁盘上，以字节为单位
        另请参见：
        Recording.setToDisk(boolean) ， Recording.getMaxSize()

      • getState

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

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

        结果
        记录状态，而不是 null
        另请参见：
        Enum.toString() ， Recording.getState()

      • getStartTime

        public long getStartTime()
        返回与此 RecordingInfo关联的录制的开始时间（以纪元为单位测量为ms），如果录制尚未开始，则 null 。
        结果
        录制的开始时间，如果录制尚未开始， null
        另请参见：
        Recording.getStartTime()

      • getStopTime

        public long getStopTime()
        返回与此 RecordingInfo关联的录制的实际或预期停止时间（以自纪元以来的ms null如果 null预期或实际停止时间，则 null ，这只有在录制尚未停止时才会发生。
        结果
        录制的停止时间，如果录制尚未停止， null 。
        另请参见：
        Recording.getStopTime()

      • 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()
        返回 true如果与此相关的记录 RecordingInfo应刷新到磁盘，当内存缓冲区已满， false否则。
        结果
        true如果记录到磁盘上， false否则

      • getDuration

        public long getDuration()
        返回与此RecordingInfo关联的记录的所需持续时间（以秒为单位），如果未设置持续时间，则返回{code 0}。
        结果
        期望的持续时间，如果没有设置持续时间，则为{code 0}
        另请参见：
        Recording.getDuration()

      • from

        public static RecordingInfo from​(CompositeData cd)
        返回RecordingInfo由指定表示CompositeData对象。

        指定的CompositeData必须具有以下项目名称和项目类型才有效。

        Supported names and types in a specified CompositeData object
        Name Type
        id Long
        name String
        state String
        dumpOnExit Boolean
        size Long
        disk Boolean
        maxAge Long
        maxSize Long
        startTime Long
        stopTime Long
        destination String
        duration Long
        settings javax.management.openmbean.CompositeData[] whose element type is the mapped type for SettingDescriptorInfo as specified in the SettingDescriptorInfo.from(javax.management.openmbean.CompositeData) method.
        参数
        cd - CompositeData代表要返回的 RecordingInfo
        结果
        所述 RecordingInfo由下式表示 cd ，或 null如果 cd是 null
        异常
        IllegalArgumentException - 如果 cd不代表有效 RecordingInfo