- 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()
このレコーディングのすべてのイベント・タイプのリストを返します。
-
-
-
コンストラクタの詳細
-
RecordingFile
public RecordingFile(Path file) throws IOException
記録ファイルを作成します。- パラメータ:
file
-null
を開かないファイルのパス- 例外:
IOException
- 有効な記録ファイルではないか、I/Oエラーが発生した場合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
- ファイルからの読み取り中にI/Oエラーが発生した場合- 関連項目:
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
- I/Oエラーが発生した場合は、Java Flight Recorderファイルまたは解析できないJFRファイルのバージョンではありませんSecurityException
- セキュリティ・マネージャが存在し、そのcheckReadメソッドがファイルへの読取りアクセスを拒否した場合。
-
-