Module jdk.jfr

Package jdk.jfr

Annotation Interface Enabled

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

事件注解，确定事件是否应默认启用。

如果事件没有注解，则默认情况下事件是启用的。

以下示例显示了如何使用Enabled注解创建一个禁用的事件。禁用的事件最多会有一个分配的开销，如果运行时JIT编译器能够消除它，则没有开销。

@Name("StopWatch")
@Label("计时器")
@Category("调试")
@StackTrace(false)
@Enabled(false)
static public class StopWatchEvent extends Event {
}

public void update() {
    StopWatchEvent e = new StopWatchEvent();
    e.begin();
    ...
    e.commit();
}

事件可以在需要时通过编程方式或命令行启用，例如：

java -XX:StartFlightRecording:StopWatch#enabled=true ...

自 JDK 版本:

9

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
boolean	value	如果默认情况下应启用事件，则返回true，否则返回false。

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NAME	设置名称为"enabled"，表示应记录该事件。

Field Details

NAME

             static final String NAME
            

设置名称为"enabled"，表示应记录该事件。

参见:

• 常量字段数值

Element Details

value

             boolean value
            

如果默认情况下应启用事件，则返回true，否则返回false。

返回:

如果默认情况下事件应启用，则返回true，否则返回false

默认值:

true