@Target(TYPE) @Inherited @Retention(RUNTIME) public @interface Category

イベント・タイプをカテゴリに関連付けるイベント注釈(判読可能なパス形式)。

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

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

次のビジュアライゼーションは、単一スレッドに属する重複するイベントを示しています。イベントを様々なカテゴリに割り当てることで、イベントを視覚的に分離し、垂直に積み上げることができます。

 13:00:01                                                     13:00:05
 ---------------------------------------------------------------------
  1   |                         File Upload                        |
 ---------------------------------------------------------------------
  2   |       Image Read          | Image Resize |   Image Write   |
 ---------------------------------------------------------------------
  3   | Socket Read | Socket Read |              |    File Write   |
 ---------------------------------------------------------------------

次のカテゴリを使用して例を達成できます。

カテゴリおよびレーン
レーン	イベント名	注釈
1	ファイルのアップロード	`@Category("Upload")`
2	イメージ読み取り	`@Category({"Upload", "Image Upload"})`
2	イメージのサイズ変更	`@Category({"Upload", "Image Upload"})`
2	イメージ書き込み	`@Category({"Upload", "Image Upload"})`
3	ソケット読取り	`@Category("Java Application")`
3	ファイル書込み	`@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
  
  この注釈のカテゴリ名をルートで始まります。
  
  戻り値:
  
  カテゴリ名

注釈インタフェースCategory

必須要素のサマリー

要素の詳細

value