Was sind die Besonderheiten bei der Arbeit mit Anmerkungen in Kotlin?

Anmerkungen in Kotlin ähneln Anmerkungen in Java, weisen jedoch einige Besonderheiten auf:

• Syntax: Anmerkungen werden vor dem Element platziert, auf das sie angewendet werden, ohne das @-Symbol.
• Verwendung zur Laufzeit: Standardmäßig werden Anmerkungen nicht zur Laufzeit gespeichert. Um sie zu speichern, muss die Meta-Anmerkung @Retention(AnnotationRetention.RUNTIME) verwendet werden.
• Anwendung auf Typen: Anmerkungen können nicht nur auf Klassen, Funktionen und Eigenschaften angewendet werden, sondern auch auf Typen (z.B. @NonNull String). Dafür wird typealias verwendet.
• Anmerkung von Konstruktoren: Um den Hauptkonstruktor einer Klasse zu annotieren, wird das Schlüsselwort constructor verwendet. Für sekundäre Konstruktoren wird die Anmerkung direkt davor platziert.
• Anmerkung von Eigenschaften und deren Accessoren: Anmerkungen können auf die Eigenschaft selbst, den Getter (@get:) oder den Setter (@set:) angewendet werden.
• Anmerkung von Konstruktorparametern für Eigenschaften: Anmerkungen, die auf die Parameter des Hauptkonstruktors angewendet werden, die gleichzeitig Eigenschaften sind, annotieren diese Eigenschaften. Für die Annotation des Parameters selbst wird @param: verwendet.
• Anmerkung von Funktions- und Methodparametern: Anmerkungen werden direkt vor dem Parameter platziert.
• Arbeiten mit Anmerkungen in Reflection: Kotlin-Reflection (kotlin-reflect) ermöglicht es, Informationen über Anmerkungen zur Laufzeit zu erhalten, wenn @Retention(AnnotationRetention.RUNTIME) verwendet wird.
• Anwendungsbereich: Anmerkungen können eine Zielangabe mit Präfixen haben:
  • @file: - für die Datei
  • @property: - für die Eigenschaft
  • @field: - für das generierte Feld der Eigenschaft
  • @get: - für den Getter der Eigenschaft
  • @set: - für den Setter der Eigenschaft
  • @param: - für den Konstruktorparameter
  • @setparam: - für den Setter-Parameter der Eigenschaft
  • @delegate: - für das Delegat-Feld
  • @use-site: - um die Verwendung zu kennzeichnen, wenn das Ziel nicht klar angegeben werden kann

Beispiel für die Erstellung und Verwendung einer Annotation:

// Definition der Annotation
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation(val value: String)

// Verwendung der Annotation
@MyAnnotation("Hello")
class MyClass {

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

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

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