java.lang.Object
jdk.jfr.consumer.RecordingFile
- すべての実装されたインタフェース:
Closeable
,AutoCloseable
レコーディング・ファイル。
次の例は、レコーディング・ファイル内のすべてのイベントの読込みと印刷の方法を示しています。
try (RecordingFile recordingFile = new RecordingFile(Paths.get("recording.jfr"))) { while (recordingFile.hasMoreEvents()) { RecordedEvent event = recordingFile.readEvent(); System.out.println(event); } }
- 導入されたバージョン:
- 9
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明void
close()
このレコーディング・ファイルを閉じて、それに関連するすべてのシステム・リソースを解放します。boolean
レコーディング・ファイルに未読イベントが存在する場合true
、それ以外の場合はfalse
を返します。static List<RecordedEvent>
readAllEvents
(Path path) ファイル内のすべてのイベントのリストを返します。レコーディング中の次のイベントを読み込みます。このレコーディングのすべてのイベント・タイプのリストを返します。
-
コンストラクタの詳細
-
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
public boolean hasMoreEvents()レコーディング・ファイルに未読イベントが存在する場合true
、それ以外の場合はfalse
を返します。- 戻り値:
- レコーディングに未読イベントが存在する場合は
true
、そうでない場合はfalse
。
-
readEventTypes
public List<EventType> readEventTypes() throws IOExceptionこのレコーディングのすべてのイベント・タイプのリストを返します。- 戻り値:
null
ではなく、イベント・タイプのリスト- 例外:
IOException
- ファイルからの読み取り中にI/Oエラーが発生した場合- 関連項目:
-
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
メソッドがファイルへの読取りアクセスを拒否した場合。
-