- 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
ファイル内のすべてのイベントのリストを返します。このメソッドは、すべてのイベントを1回の操作で読み取ると便利な単純なケース用です。 大きなファイルを読み込むためのものではありません。
- パラメータ:
path
-null
ではなく、ファイルへのパス- 戻り値:
- ファイルからのイベントが
List
オブジェクトとして表示される - 例外:
IOException
- I/Oエラーが発生した場合、Flight Recorderファイルまたは解析できないJFRファイルのバージョンではありませんSecurityException
- セキュリティ・マネージャが存在し、そのcheckRead
メソッドがファイルへの読取りアクセスを拒否した場合。
-
-