-
@Target(TYPE) @Inherited @Retention(RUNTIME) public @interface Category
事件注释,以人类可读路径的格式将事件类型与类别相关联。该类别确定如何向用户呈现事件。 同一类别中的事件通常以图形和树形式一起显示。 为避免图形表示中持续时间事件的重叠,重叠事件必须位于不同的类别中。
例如,要监控图像上传到Web服务器并为每次上载创建单独的线程,会在用户上载文件时启动名为“文件上载”的事件,并在上载完成时结束。 对于有关图像上载的高级诊断,将创建更详细的事件(例如,图像读取,图像调整大小和图像写入)。 在这些详细的活动中。 可能会发生其他低级别事件(例如,套接字读取和文件写入)。
以下示例显示了避免重叠的可视化:
------------------------------------------------------------------- | File Upload | ------------------------------------------------------------------ | Image Read | Image Resize | Image Write | ------------------------------------------------------------------ | Socket Read | Socket Read | | File Write | -------------------------------------------------------------------
可以使用以下类别来实现该示例: Recording options and their purpose. Event Name Annotation File Upload@Category("Upload")
Image Read@Category({"Upload", "Image Upload"})
Image Resize@Category({"Upload", "Image Upload"})
Image Write@Category({"Upload", "Image Upload"})
Socket Read@Category("Java Application")
File Write@Category("Java Application")
文件上载,图像读取和套接字读取事件同时发生(在同一个线程中),但事件在不同的类别中,因此它们在可视化中不重叠。
以下示例显示了如何使用类别来确定如何在树中显示事件:
|- Java Application | |- Socket Read | |- File Write |- Upload |- File Upload |- Image Upload |- Image Read |- Image Resize |- File Write
- 从以下版本开始:
- 9
-
-
Element Detail
-
value
String[] value
从根开始返回此批注的类别名称。- 结果
- 类别名称
-
-