Wat zijn de kenmerken van werken met annotaties in Kotlin?

Annotaties in Kotlin lijken op annotaties in Java, maar hebben een aantal kenmerken:

• Syntax: Annotaties worden vóór het element geplaatst waarop ze van toepassing zijn, zonder het @-symbool.
• Gebruik in runtime: Standaard worden annotaties niet bewaard in runtime. Om ze te bewaren, moet de meta-annotatie @Retention(AnnotationRetention.RUNTIME) worden gebruikt.
• Toepassing op type: Annotaties kunnen niet alleen worden toegepast op klassen, functies en eigenschappen, maar ook op types (bijvoorbeeld, @NonNull String). Hiervoor wordt typealias gebruikt.
• Annotatie van constructors: Om de hoofdconstructor van een klasse te annoteren, wordt het sleutelwoord constructor gebruikt. Voor secundaire constructors wordt de annotatie direct vóór hen geplaatst.
• Annotatie van eigenschappen en hun accessors: Annotaties kunnen worden toegepast op de eigenschap zelf, op de getter (@get:) of op de setter (@set:).
• Annotatie van constructorparameters voor eigenschappen: Annotaties die worden toegepast op de parameters van de hoofdconstructor, die ook eigenschappen zijn, annoteren deze eigenschappen. Om het eigenlijke parameter te annoteren, wordt @param: gebruikt.
• Annotatie van functie- en methodparameters: Annotaties worden direct vóór de parameter geplaatst.
• Werken met annotaties in reflection: Kotlin reflection (kotlin-reflect) maakt het mogelijk om informatie over annotaties op te halen in runtime, mits @Retention(AnnotationRetention.RUNTIME) wordt gebruikt.
• Toepassingsgebied: Annotaties kunnen een doelverklaring hebben met behulp van prefixen:
  • @file: - voor het bestand
  • @property: - voor de eigenschap
  • @field: - voor het gegenereerde veld voor de eigenschap
  • @get: - voor de getter van de eigenschap
  • @set: - voor de setter van de eigenschap
  • @param: - voor de constructorparameter
  • @setparam: - voor de setterparameter van de eigenschap
  • @delegate: - voor het delegaatveld
  • @use-site: - om de gebruikslocatie aan te geven wanneer het doel niet duidelijk kan worden aangegeven

Voorbeeld van het maken en gebruiken van een annotatie:

// Definitie van de annotatie
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation(val value: String)

// Gebruik van de annotatie
@MyAnnotation("Hello")
class MyClass {

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

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

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