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