モジュール 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
        ファイル内のすべてのイベントのリストを返します。

        このメソッドは、すべてのイベントを1回の操作で読み取ると便利な単純なケース用です。 大きなファイルを読み込むためのものではありません。

        信頼できるソースからのファイルのレコーディングのみを使用してください。

        パラメータ:
        path - nullではなく、ファイルへのパス
        戻り値:
        ファイルからのイベントがListオブジェクトとして表示される
        例外:
        IOException - I/Oエラーが発生した場合、Flight Recorderファイルまたは解析できないJFRファイルのバージョンではありません
        SecurityException - セキュリティ・マネージャが存在し、そのcheckReadメソッドがファイルへの読取りアクセスを拒否した場合。