Каковы особенности работы с аннотациями в Kotlin?

Аннотации в Kotlin схожи с аннотациями в Java, но имеют ряд особенностей:

• Синтаксис: Аннотации ставятся перед элементом, к которому применяются, без символа @.
• Использование в run-time: По умолчанию аннотации не сохраняются в run-time. Для сохранения необходимо использовать мета-аннотацию @Retention(AnnotationRetention.RUNTIME).
• Применение к типу: Аннотации можно применять не только к классам, функциям и свойствам, но и к типам (например, @NonNull String). Для этого используется typealias.
• Аннотирование конструкторов: Для аннотирования основного конструктора класса используется ключевое слово constructor. Для вторичных конструкторов аннотация ставится непосредственно перед ними.
• Аннотирование свойств и их аксессоров: Аннотации можно применять к самому свойству, его геттеру (@get:) или сеттеру (@set:).
• Аннотирование параметров конструктора для свойств: Аннотации, применяемые к параметрам основного конструктора, которые одновременно являются свойствами, аннотируют эти свойства. Для аннотирования самого параметра используется @param:.
• Аннотирование параметров функций и методов: Аннотации применяются непосредственно перед параметром.
• Работа с аннотациями в reflection: Kotlin reflection (библиотека kotlin-reflect) позволяет получать информацию об аннотациях в run-time при наличии @Retention(AnnotationRetention.RUNTIME).
• Область применения: Аннотации могут иметь целевое объявление с помощью префиксов:
  • @file: - для файла
  • @property: - для свойства
  • @field: - для поля, сгенерированного для свойства
  • @get: - для геттера свойства
  • @set: - для сеттера свойства
  • @param: - для параметра конструктора
  • @setparam: - для параметра сеттера свойства
  • @delegate: - для поля делегата
  • @use-site: - для использования сайта, когда четко указать цель невозможно

Пример создания и использования аннотации:

// Определение аннотации
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation(val value: String)

// Использование аннотации
@MyAnnotation("Hello")
class MyClass {

    @get:MyAnnotation("World")
    val myProperty: String = "some value"

    constructor(@param:MyAnnotation("ConstructorParam") param: Int) {
        // ...
    }

    fun myFunction(@MyAnnotation("FunctionParam") param: String) {
        // ...
    }
}