Kotlin 注解(Annotation)是一種在代碼中添加元數據的方式,它可以用來給類、方法、屬性等添加額外的信息。Kotlin 支持多種注解,以下是一些常見的 Kotlin 注解:
@Target
:用于指定注解可以應用于哪些元素類型,如類、方法、屬性等。@Target(AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation
@Retention
:用于指定注解的保留策略,如運行時、編譯時或源代碼。@Target(AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
annotation class MyAnnotation
@JvmStatic
:用于將 Kotlin 伴生對象的成員方法轉換為靜態方法,以便在 Java 中直接調用。class MyClass {
companion object {
@JvmStatic
fun myStaticMethod() {
println("This is a static method.")
}
}
}
@JvmOverloads
:用于生成具有默認參數值的 Java 方法重載。fun myFunction(@JvmOverloads name: String = "World") {
println("Hello, $name!")
}
@Deprecated
:用于標記不再推薦使用的方法或屬性,并在編譯時發出警告。@Deprecated("Use the newFunction() instead.")
fun oldFunction() {
println("This function is deprecated.")
}
@Volatile
:用于聲明一個變量是不可緩存的,每次讀取都需要重新從主內存中獲取。var myVolatileVar: Int = 0
@Volatile
var myOtherVolatileVar: Int = 0
@Synchronized
:用于將方法或代碼塊加鎖,以確保同一時間只有一個線程可以訪問。class MyClass {
@Synchronized
fun mySynchronizedMethod() {
println("This method is synchronized.")
}
}
@AsType
:用于將一個表達式轉換為指定的類型。val myInt = 42
val myString: String = myInt.asType(String::class)
@When
:用于根據條件選擇不同的實現。fun myWhen(condition: Boolean) {
when (condition) {
true -> println("Condition is true.")
false -> println("Condition is false.")
}
}
@OptIn
和 @OptOut
:用于指定編譯器選項,以啟用或禁用 Kotlin 編譯器插件中的某些特性。@OptIn(ExperimentalTypeInference::class)
fun myExperimentalFunction() {
// 使用實驗性類型推斷
}
@OptOut(ExperimentalTypeInference::class)
fun myNonExperimentalFunction() {
// 不使用實驗性類型推斷
}
這些只是 Kotlin 中可用注解的一部分,Kotlin 還提供了許多其他注解,以滿足不同的需求。