Класс RecordingFile

java.lang.Object

jdk.jfr.consumer.RecordingFile

Все реализуемые интерфейсы:: Closeable, AutoCloseable

public final class RecordingFile extends Object implements Closeable

Файл записи.

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

try (RecordingFile recordingFile = new RecordingFile(Paths.get("recording.jfr"))) {
    while (recordingFile.hasMoreEvents()) {
        RecordedEvent event = recordingFile.readEvent();
        System.out.println(event);
    }
}

Начиная с:: 9

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

Конструктор	Описание
`RecordingFile(Path file)`	Создает файл записи.

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

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает этот файл записи и освобождает все связанные с ним системные ресурсы.
`boolean`	`hasMoreEvents()`	Возвращает `true`, если в файле записи есть непрочитанные события, и `false` в противном случае.
`static List<RecordedEvent>`	`readAllEvents(Path path)`	Возвращает список всех событий в файле.
`RecordedEvent`	`readEvent()`	Читает следующее событие в записи.
`List<EventType>`	`readEventTypes()`	Возвращает список всех типов событий в этой записи.
`void`	`write(Path destination, Predicate<RecordedEvent> filter)`	Фильтрует события и записывает их в новый файл.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.

Подробное описание конструкторов

RecordingFile

public RecordingFile(Path file) throws IOException

Создает файл записи.

Следует использовать только файлы записи из доверенных источников.

Параметры:: file — путь к файлу, который нужно открыть, не null
Вызывает исключение:: IOException — если файл не является допустимым файлом записи или произошла ошибка ввода-вывода; NoSuchFileException — если не удается найти file

Подробное описание методов

readEvent

public RecordedEvent readEvent() throws IOException

Читает следующее событие в записи.

Возвращает:

следующее событие, не null

Вызывает исключение:

EOFException — если в файле записи больше нет событий

IOException — если произошла ошибка ввода-вывода

См. также:

hasMoreEvents

public boolean hasMoreEvents()

Возвращает true, если в файле записи есть непрочитанные события, и false в противном случае.

Возвращает:: true, если в записи есть непрочитанные события, и false в противном случае.

readEventTypes

public List<EventType> readEventTypes() throws IOException

Возвращает список всех типов событий в этой записи.

Возвращает:

список типов событий, не null

Вызывает исключение:

IOException — если при чтении файла произошла ошибка ввода-вывода

См. также:

close

public void close() throws IOException

Закрывает этот файл записи и освобождает все связанные с ним системные ресурсы.

Определено в:: close в интерфейсе AutoCloseable
Определено в:: close в интерфейсе Closeable
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода

write

public void write(Path destination, Predicate<RecordedEvent> filter) throws IOException

Фильтрует события и записывает их в новый файл.

Параметры:: destination — путь, по которому следует записать новый файл, не null; filter — фильтр, определяющий, следует ли включить событие, не null
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода, файл не является файлом Flight Recorder или это версия файла JFR, которую невозможно разобрать
Начиная с:: 19

readAllEvents

public static List<RecordedEvent> readAllEvents(Path path) throws IOException

Возвращает список всех событий в файле.

Этот метод предназначен для простых случаев, когда удобно прочитать все события за одну операцию. Он не предназначен для чтения больших файлов.

Следует использовать только файлы записи из доверенных источников.

Параметры:: path — путь к файлу, не null
Возвращает:: события из файла в виде объекта List; возможность изменения List зависит от реализации и поэтому не определена, не null
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода, файл не является файлом Flight Recorder или это версия файла JFR, которую невозможно разобрать

© 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.