元註釋
宣告註釋時,可以使用以下元註釋包含元資訊:
-
@Target
:指定可以使用註釋(類,函式,屬性,表示式等)註釋的可能型別的元素 -
@Retention
指定註釋是否儲存在已編譯的類檔案中,以及它是否在執行時通過反射可見(預設情況下,兩者都為真。) -
@Repeatable
允許多次在單個元素上使用相同的註釋。 -
@MustBeDocumented
指定註釋是公共 API 的一部分,並且應包含在生成的 API 文件中顯示的類或方法簽名中。
例:
@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.EXPRESSION)
@Retention(AnnotationRetention.SOURCE)
@MustBeDocumented
annotation class Fancy