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

Коментарите в Kotlin са подобни на тези в Java, но имат няколко особености:

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

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

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

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

    @get:MyAnnotation("World")
    val myProperty: String = "някаква стойност"

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

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