¿Cuáles son las características del trabajo con anotaciones en Kotlin?

Las anotaciones en Kotlin son similares a las anotaciones en Java, pero tienen varias características:

• Sintaxis: Las anotaciones se colocan antes del elemento al que se aplican, sin el símbolo @.
• Uso en tiempo de ejecución: Por defecto, las anotaciones no se conservan en tiempo de ejecución. Para conservarse, es necesario usar la meta-anotación @Retention(AnnotationRetention.RUNTIME).
• Aplicación a tipos: Las anotaciones pueden aplicarse no solo a clases, funciones y propiedades, sino también a tipos (por ejemplo, @NonNull String). Para ello se usa typealias.
• Anotación de constructores: Para anotar el constructor principal de una clase, se usa la palabra clave constructor. Para constructores secundarios, la anotación se coloca directamente antes de ellos.
• Anotación de propiedades y sus accesores: Las anotaciones pueden aplicarse a la propiedad en sí, a su getter (@get:) o a su setter (@set:).
• Anotación de parámetros del constructor para propiedades: Las anotaciones que se aplican a los parámetros del constructor principal, que también son propiedades, anotan esas propiedades. Para anotar el propio parámetro, se usa @param:.
• Anotación de parámetros de funciones y métodos: Las anotaciones se colocan directamente antes del parámetro.
• Trabajo con anotaciones en reflection: La reflexión en Kotlin (kotlin-reflect) permite obtener información sobre las anotaciones en tiempo de ejecución si se usa @Retention(AnnotationRetention.RUNTIME).
• Ámbito de aplicación: Las anotaciones pueden tener una declaración de destino mediante prefijos:
  • @file: - para el archivo
  • @property: - para la propiedad
  • @field: - para el campo generado para la propiedad
  • @get: - para el getter de la propiedad
  • @set: - para el setter de la propiedad
  • @param: - para el parámetro del constructor
  • @setparam: - para el parámetro del setter de la propiedad
  • @delegate: - para el campo delegado
  • @use-site: - para indicar el sitio de uso cuando no es posible especificar claramente el objetivo

Ejemplo de creación y uso de una anotación:

// Definición de la anotación
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation(val value: String)

// Uso de la anotación
@MyAnnotation("Hello")
class MyClass {

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

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

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