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

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

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

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

Устойчивое и удобное в использовании имя события имеет вид:

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

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

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