Класс 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()`	Возвращает список всех типов событий в этой записи.

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

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

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

RecordingFile

public RecordingFile(Path file) throws IOException

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

Параметры:: file - путь к открываемому файлу, не null
Исключения:: IOException - если это не допустимый файл записи, или произошла ошибка ввода-вывода; NoSuchFileException - если file не может быть найден; SecurityException - если менеджер безопасности существует и его метод checkRead запрещает чтение файла.

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

readEvent

public RecordedEvent readEvent() throws IOException

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

Возвращает:

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

Исключения:

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

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

См. также:

hasMoreEvents()

hasMoreEvents

public boolean hasMoreEvents()

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

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

readEventTypes

public List<EventType> readEventTypes() throws IOException

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

Возвращает:

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

Исключения:

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

См. также:

hasMoreEvents()

close

public void close() throws IOException

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

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

readAllEvents

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

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

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

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

© 1993, 2021, 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/17/docs/api/jdk.jfr/jdk/jfr/consumer/RecordingFile.html