Интерфейс аннотации Name

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

Аннотация, задающая имя элемента по умолчанию.

Для классов событий имя должно быть допустимым именем класса в соответствии со спецификацией языка Java (например, "com.example.Transaction". Для полей событий или параметров событий имя должно быть допустимым идентификатором (например, "message"). Дополнительные сведения см. в разделах 3.8 и 3.9 спецификации языка Java.

Если указанное имя недопустимо, аннотация игнорируется.

Стабильное и удобное имя события имеет следующий формат:

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

События без аннотации @Name получают имя из полного имени класса, что подходит для экспериментов, но не рекомендуется для промышленного использования.

• Имя должно быть стабильным, чтобы не нарушать работу файлов настроек и кода, использующего событие или настраивающего его.
• Имя не должно содержать избыточную или ненужную информацию, например "jfr", "internal", "events" или "Event".
• Имя должно быть коротким, но не настолько коротким, чтобы совпадать с именами других организаций или продуктов.
• Имя должно быть понятным и легко запоминающимся для пользователей, которые хотят настроить событие. Это особенно важно, если событие входит в состав платформы или библиотеки, предназначенной для использования другими разработчиками. Обычно достаточно поместить все события библиотеки или продукта в одно пространство имён. Например, все события OpenJDK находятся в пространстве имён "jdk" без отдельных пространств имён для "hotspot", "gc" или "compiler". Это снижает ненужную когнитивную нагрузку на пользователей. Вместо этого события можно распределить по категориям с помощью аннотации @Category. Категории можно свободно переименовывать, не нарушая работу зависимостей