Quais são as características do trabalho com anotações em Kotlin?

As anotações em Kotlin são semelhantes às anotações em Java, mas têm várias características:

• Sintaxe: As anotações são colocadas antes do elemento a que se aplicam, sem o símbolo @.
• Utilização em tempo de execução: Por padrão, as anotações não são preservadas em tempo de execução. Para as preservar, é necessário usar a meta-anotação @Retention(AnnotationRetention.RUNTIME).
• Aplicação ao tipo: As anotações podem ser aplicadas não só a classes, funções e propriedades, mas também a tipos (por exemplo, @NonNull String). Para isso, usa-se typealias.
• Anotação de construtores: Para anotar o construtor principal de uma classe, usa-se a palavra-chave constructor. Para construtores secundários, a anotação é colocada diretamente antes deles.
• Anotação de propriedades e seus acessores: As anotações podem ser aplicadas à propriedade em si, ao seu getter (@get:) ou ao seu setter (@set:).
• Anotação de parâmetros do construtor para propriedades: As anotações aplicadas aos parâmetros do construtor principal, que também são propriedades, anotam essas propriedades. Para anotar o próprio parâmetro, usa-se @param:.
• Anotação de parâmetros de funções e métodos: As anotações são colocadas diretamente antes do parâmetro.
• Trabalho com anotações em reflection: A reflexão em Kotlin (kotlin-reflect) permite obter informações sobre as anotações em tempo de execução se @Retention(AnnotationRetention.RUNTIME) for usado.
• Campo de aplicação: As anotações podem ter uma declaração de destino usando prefixos:
  • @file: - para o arquivo
  • @property: - para a propriedade
  • @field: - para o campo gerado para a propriedade
  • @get: - para o getter da propriedade
  • @set: - para o setter da propriedade
  • @param: - para o parâmetro do construtor
  • @setparam: - para o parâmetro do setter da propriedade
  • @delegate: - para o campo delegado
  • @use-site: - para indicar o local de uso quando não for possível especificar claramente o objetivo

Exemplo de criação e uso de uma anotação:

// Definição da anotação
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation(val value: String)

// Uso da anotação
@MyAnnotation("Hello")
class MyClass {

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

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

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