Ποια είναι τα χαρακτηριστικά της εργασίας με τις…

Οι σχολιασμοί στο Kotlin μοιάζουν με αυτούς στη Java, αλλά έχουν ορισμένα χαρακτηριστικά:

Σύνταξη: Οι σχολιασμοί τοποθετούνται πριν από το στοιχείο στο οποίο εφαρμόζονται, χωρίς το σύμβολο @.
Χρήση σε χρόνο εκτέλεσης: Από προεπιλογή, οι σχολιασμοί δεν διατηρούνται σε χρόνο εκτέλεσης. Για να διατηρηθούν, πρέπει να χρησιμοποιηθεί η μετα-σχολία @Retention(AnnotationRetention.RUNTIME).
Εφαρμογή σε τύπο: Οι σχολιασμοί μπορούν να εφαρμοστούν όχι μόνο σε κλάσεις, συναρτήσεις και ιδιότητες, αλλά και σε τύπους (π.χ., @NonNull String). Για αυτό, χρησιμοποιείται το typealias.
Σχολιασμός κατασκευαστών: Για να σχολιάσετε τον κύριο κατασκευαστή μιας κλάσης, χρησιμοποιείται η λέξη-κλειδί constructor. Για δευτερεύοντες κατασκευαστές, η σχολίαση τοποθετείται άμεσα πριν από αυτούς.
Σχολιασμός ιδιοτήτων και των accessor τους: Οι σχολιασμοί μπορούν να εφαρμοστούν στην ιδιότητα, στον getter (@get:) ή στον setter (@set:).
Σχολιασμός παραμέτρων κατασκευαστή για ιδιότητες: Οι σχολιασμοί που εφαρμόζονται στις παραμέτρους του κύριου κατασκευαστή, που είναι επίσης ιδιότητες, σχολιάζουν αυτές τις ιδιότητες. Για να σχολιάσετε την ίδια την παράμετρο, χρησιμοποιείται το @param:.
Σχολιασμός παραμέτρων συναρτήσεων και μεθόδων: Οι σχολιασμοί τοποθετούνται άμεσα πριν από την παράμετρο.
Εργασία με σχολιασμούς σε reflection: Το Kotlin reflection (kotlin-reflect) επιτρέπει την απόκτηση πληροφοριών σχετικά με τους σχολιασμούς σε χρόνο εκτέλεσης, εφόσον χρησιμοποιείται το @Retention(AnnotationRetention.RUNTIME).
Πεδίο εφαρμογής: Οι σχολιασμοί μπορούν να έχουν δηλωμένο στόχο με τη βοήθεια προθέσεων:
- @file: - για το αρχείο
- @property: - για την ιδιότητα
- @field: - για το πεδίο που δημιουργείται για την ιδιότητα
- @get: - για τον getter της ιδιότητας
- @set: - για τον setter της ιδιότητας
- @param: - για την παράμετρο κατασκευαστή
- @setparam: - για την παράμετρο του setter της ιδιότητας
- @delegate: - για το πεδίο του 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) {
        // ...
    }
}

Ποια είναι τα χαρακτηριστικά της εργασίας με τις σημειώσεις σε Kotlin;