モジュール jdk.jfr
パッケージ jdk.jfr

注釈型Category


  • @Target(TYPE)
    @Inherited
    @Retention(RUNTIME)
    public @interface Category
    イベントの注釈。イベントのタイプを人間が判読可能な形式でカテゴリに関連付けます。 カテゴリは、イベントをユーザーに提示する方法を決定します。 同じカテゴリに属するイベントは、通常、グラフとツリーで一緒に表示されます。 グラフィカルな表象で違反事象が重複しないようにするには、重複するイベントを別々のカテゴリに入れることが重要です。

    例として、Webサーバーへのイメージ・アップロードを監視し、アップロードごとに別々のスレッドを用意するとします。 その後、ユーザーがファイルをアップロードするときに開始され、アップロードが完了したときに終了するファイル・アップロードというイベントが発生する可能性があります。 イメージのアップロードに関する高度な診断のために、より詳細なイベントを作成し、イメージの読み取り、イメージのサイズ変更、およびイメージの書き込みを行うことができます。 これらの詳細なイベントの間に、ソケット読み込みやファイル書き込みなどの他の低レベル・イベントが発生する可能性があります。

    オーバーラップを避ける視覚化は、次のようになります:

     -------------------------------------------------------------------
       |                         File Upload                        |
     ------------------------------------------------------------------
       |       Image Read          | Image Resize |   Image Write   |
     ------------------------------------------------------------------
       | Socket Read | Socket Read |              |    File Write   |
     -------------------------------------------------------------------
     
    これは、次のカテゴリを使用して実現できます:
    記録のオプションとその目的。
    イベント名 Annotation
    ファイルのアップロード @Category("Upload")
    イメージ読み取り @Category({"Upload", "Image Upload"})
    イメージのサイズ変更 @Category({"Upload", "Image Upload"})
    イメージ書き込み @Category({"Upload", "Image Upload"})
    ソケット読取り @Category("Java Application")
    ファイル書込み @Category("Java Application")

    File Upload、Image Read、およびSocket Readは同時に発生しますが、イベントは異なるカテゴリに入れられているため、ビジュアリゼーションでは重複しません。

    カテゴリは、イベントをツリー内でどのように可視化するかを決定するためにも使用できます:

      |- Java Application
      |  |- Socket Read
      |  |- File Write
      |- Upload
         |- File Upload
         |- Image Upload
            |- Image Read
            |- Image Resize
            |- File Write
     
    導入されたバージョン:
    9
    • 必須要素のサマリー

      必須要素 
      修飾子と型 必須要素 説明
      String[] value
      この注釈のカテゴリ名をルートで始まります。
    • 要素の詳細

      • value

        String[] value
        この注釈のカテゴリ名をルートで始まります。
        戻り値:
        カテゴリ名