元註釋

宣告註釋時,可以使用以下元註釋包含元資訊:

  • @Target:指定可以使用註釋(類,函式,屬性,表示式等)註釋的可能型別的元素

  • @Retention 指定註釋是否儲存在已編譯的類檔案中,以及它是否在執行時通過反射可見(預設情況下,兩者都為真。)

  • @Repeatable 允許多次在單個元素上使用相同的註釋。

  • @MustBeDocumented 指定註釋是公共 API 的一部分,並且應包含在生成的 API 文件中顯示的類或方法簽名中。

例:

@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION,
        AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.EXPRESSION)
@Retention(AnnotationRetention.SOURCE)
@MustBeDocumented
annotation class Fancy