模块  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
        从根开始返回此批注的类别名称。
        结果
        类别名称