@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