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 还提供了许多其他注解,以满足不同的需求。