Класс RecordingInfo

java.lang.Object

jdk.management.jfr.RecordingInfo

public final class RecordingInfo extends Object

Представление управления Recording.

Since:

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`static RecordingInfo`	`from(CompositeData cd)`	Возвращает `RecordingInfo`, представленный указанным объектом `CompositeData`.
`String`	`getDestination()`	Возвращает путь назначения, куда данные для записи, связанной с этим `RecordingInfo`, должны быть записаны при завершении записи, или `null`, если запись не должна быть записана.
`boolean`	`getDumpOnExit()`	Возвращает, должна ли запись, связанная с этим `RecordingInfo`, быть выгружена в файл при выходе JVM.
`long`	`getDuration()`	Возвращает желаемую продолжительность записи, измеренную в секундах, связанной с этим `RecordingInfo`, или `0`, если продолжительность не установлена.
`long`	`getId()`	Возвращает уникальный идентификатор записи, связанной с этим `RecordingInfo`.
`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`.
`long`	`getStopTime()`	Возвращает фактическое или ожидаемое время остановки записи, связанной с этим `RecordingInfo`, измеренное в мс с начала эпохи, или `null`, если ожидаемое или фактическое время остановки неизвестно, что может произойти только если запись ещё не была остановлена.
`boolean`	`isToDisk()`	Возвращает `true`, если запись, связанная с этим `RecordingInfo`, должна быть сброшена на диск, когда буферы памяти заполнены, `false` в противном случае.
`String`	`toString()`	Возвращает строковое описание записи, связанной с этим `RecordingInfo`

Методы, объявленные в классе java.lang.Object

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

Методы

getName

public String getName()

Возвращает имя записи, связанной с этим RecordingInfo.

Возвращает:

имя записи, не null

См. также:

getId

public long getId()

Возвращает уникальный идентификатор записи, связанной с этим RecordingInfo.

Возвращает:

идентификатор записи

См. также:

getDumpOnExit

public boolean getDumpOnExit()

Возвращает, нужно ли сохранить запись, связанную с этим RecordingInfo, в файл при выходе JVM.

Возвращает:

true, если запись должна быть сохранена при выходе, false в противном случае

См. также:

getMaxAge

public long getMaxAge()

Возвращает количество секунд, в течение которых данные должны храниться на диске, или 0, если данные должны храниться вечно.

Данные в памяти не затрагиваются максимальным сроком хранения.

Возвращает:

сколько времени данные должны храниться на диске, измеряется в секундах

См. также:

getMaxSize

public long getMaxSize()

Возвращает количество данных, измеряемых в байтах, которое запись, связанная с этим RecordingInfo, должна хранить на диске, прежде чем она будет повернута, или 0, если данные должны храниться неограниченно.

Данные в памяти не затрагиваются максимальным размером.

Возвращает:

количество данных, которое должно храниться на диске, в байтах

См. также:

getState

public String getState()

Возвращает строковое представление состояния записи, связанной с этим RecordingInfo.

Допустимые значения возврата: "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

Overrides:: 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)

Возвращает RecordingInfo, представленную указанным объектом CompositeData.

Указанный объект 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).

Поддерживаемые имена и типы в указанном объекте `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 - CompositeData, представляющий RecordingInfo для возврата
Возвращает:: RecordingInfo, представленный cd, или null, если cd является null
Исключения:: IllegalArgumentException - если cd не представляет допустимое значение RecordingInfo

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.management.jfr/jdk/management/jfr/RecordingInfo.html