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

注釈型Category


  • @Target(TYPE)
    @Inherited
    @Retention(RUNTIME)
    public @interface Category
    イベント・タイプをカテゴリに関連付けるイベント注釈(判読可能なパス形式)。

    このカテゴリは、ユーザーへのイベントの提示方法を決定します。 同じカテゴリにあるイベントは、通常、グラフとツリーに一緒に表示されます。 グラフィック表示での期間イベントの重複を回避するには、重複するイベントが個別のカテゴリにある必要があります。

    たとえば、アップロードごとに別のスレッドがあるWebサーバーにイメージ・アップロードをモニターするには、ファイル・アップロードと呼ばれるイベントが開始され、ユーザーがファイルをアップロードしてアップロードの完了時に終了します。 イメージのアップロードに関する高度な診断については、(たとえば、イメージ読取り、イメージのサイズ変更およびイメージ書込みです。)という詳細なイベントが作成されます。 これらの詳細イベント中に、他のレベル・イベントは(例: Socket ReadおよびFile Write)となる可能性があります。

    次の例は、重複を避けるビジュアライゼーションを示しています。

     -------------------------------------------------------------------
       |                         File Upload                        |
     ------------------------------------------------------------------
       |       Image Read          | Image Resize |   Image Write   |
     ------------------------------------------------------------------
       | Socket Read | Socket Read |              |    File Write   |
     -------------------------------------------------------------------
     
    次のカテゴリを使用して例を達成できます。
    レコーディングのオプションとその目的。
    イベント名 注釈
    ファイルのアップロード @Category("Upload")
    イメージ読み取り @Category({"Upload", "Image Upload"})
    イメージのサイズ変更 @Category({"Upload", "Image Upload"})
    イメージ書き込み @Category({"Upload", "Image Upload"})
    ソケット読取り @Category("Java Application")
    ファイル書込み @Category("Java Application")

    ファイル・アップロード、イメージ読取りおよびソケット読取りの各イベントは、同時に(同じスレッドで)を起こしますが、イベントが異なるカテゴリにあるため、ビジュアライゼーションで重複しません。

    次の例は、カテゴリを使用して、ツリー内でのイベントのビジュアル化方法を決定する方法を示しています。

      |- Java Application
      |  |- Socket Read
      |  |- File Write
      |- Upload
         |- File Upload
         |- Image Upload
            |- Image Read
            |- Image Resize
            |- File Write
     

    導入されたバージョン:
    9
    • 必須要素のサマリー

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

      • value

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