モジュール jdk.jfr
パッケージ 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

        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メソッドがファイルへの読取りアクセスを拒否した場合。