Класс 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 запрещает чтение файла.