Kotlin Annotations Meta-annotations
Example
When declaring an annotation, meta-info can be included using the following meta-annotations:
-
@Target: specifies the possible kinds of elements which can be annotated with the annotation (classes, functions, properties, expressions etc.) -
@Retentionspecifies whether the annotation is stored in the compiled class files and whether it's visible through reflection at runtime (by default, both are true.) -
@Repeatableallows using the same annotation on a single element multiple times. -
@MustBeDocumentedspecifies that the annotation is part of the public API and should be included in the class or method signature shown in the generated API documentation.
Example:
@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.EXPRESSION)
@Retention(AnnotationRetention.SOURCE)
@MustBeDocumented
annotation class Fancy
