@Target ({TYPE ,FIELD ,METHOD }) @Retention (RUNTIME ) public @interface Name

为元素设置默认名称的注解。

对于事件类，名称必须是 Java 语言中指定的合法类名（例如，"com.example.Transaction"。对于事件字段或事件设置，名称必须是有效的标识符（例如，"message"）。请参阅第 3.8 节和Java 语言规范的 3.9 了解更多信息。

如果指定的名称无效，则忽略注释。

稳定且易于使用的事件名称采用以下形式：

[org|com|net].[organization|product].EventName

没有 @Name 注释的事件从完全限定的类名中获取它们的名称，这很适合实验，但在生产中应该避免。

名称应该是稳定的，以避免破坏使用或配置事件的设置文件和代码。
该名称不应包含冗余或不必要的信息，例如 "jfr"、"internal"、"events" 或 "Event"。
名称应该简短，但不能短到与其他组织或产品发生冲突。
对于想要配置事件的用户，名称应该易于理解和记忆。如果事件是打算供其他人使用的框架或库的一部分，则尤其如此。通常将库或产品的所有事件放在同一个命名空间中就足够了。例如，OpenJDK 的所有事件都在 "jdk" 命名空间中，没有 "hotspot"、"gc" 或 "compiler" 的子命名空间。这避免了用户不必要的认知负担。通过使用 @Category 注释，事件可以改为分类。类别可以自由重命名而不会破坏依赖性

注解名称

必需元素摘要