Класс RecordingInfo

java.lang.Object

jdk.management.jfr.RecordingInfo

public final class RecordingInfo extends Object

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

Начиная с:

См. также:

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

Модификатор и тип	Метод	Описание
`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`, в виде `String`.
`long`	`getStopTime()`	Возвращает фактическое или ожидаемое время остановки записи, связанной с этим `RecordingInfo`, в миллисекундах с начала эпохи или `null`, если ожидаемое или фактическое время остановки неизвестно. Такое возможно только в том случае, если запись еще не остановлена.
`boolean`	`isToDisk()`	Возвращает `true`, если запись, связанная с этим `RecordingInfo`, следует сбрасывать на диск при заполнении буферов памяти, и `false` в противном случае.
`String`	`toString()`	Возвращает строковое описание записи, связанной с этим `RecordingInfo`

Методы, объявленные в классе 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, в виде 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)

Возвращает 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(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(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://docs.oracle.com/en/java/javase/25/docs/api/jdk.management.jfr/jdk/management/jfr/RecordingInfo.html