模块  jdk.jfr
软件包  jdk.jfr

Annotation Type Category

  • @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

    • Required Element Summary

      Required Elements  
      变量和类型 Required Element 描述
      String[] value
      从根开始返回此批注的类别名称。

    • Element Detail

      • value

        String[] value
        从根开始返回此批注的类别名称。
        结果
        类别名称