@fancy fun baz(@fancy foo: Int): Int {
return (@fancy 1)
}
}
在多数情形中 @ 标识是可选的。只有在注解表达式或本地声明中才必须:
fancy class Foo {
fancy fun baz(fancy foo: Int): Int {
@fancy fun bar() { ... }
return (@fancy 1)
}
}
如果要给构造函数注解,就需要在构造函数声明时添加 constructor 关键字,并且需要在前面添加注解:
class Foo @inject constructor (dependency: MyDependency)
//...
也可以注解属性访问者:
special("example") class Foo {}
注解也可以用在 Lambda 中。这将会应用到 lambda 生成的 invoke() 方法。这对 框架很有用,在这个框架中注解被用来并发控制
annotation class Suspendable
val f = @Suspendable { Fiber.sleep(10) }
java 注解在 kotlin 中是完全兼容的:
import org.junit.Assert.*
class Tests {
Test fun simple() {
assertEquals(42, getTheAnswer())
}
}
java 注解也可以通过在导入是重命名实现像修改者那样:
//Java
public @interface Ann {
int intValue();
String stringValue(0;
}
//kotlin
像 java 中那样,值参数是特殊的情形;它的值可以不用明确的名字。
public @interface AnnWithValue {
}
//kotlin
AnnWithValue("abc") class C
如果java 中的 value 参数有数组类型,则在 kotlin 中变成 vararg 参数:
// Java
public @interface AnnWithArrayValue {
String[] value();
}
// Kotlin
AnnWithArrayValue("abc", "foo", "bar") class C
如果你需要明确一个类作为一个注解参数,使用 Kotlin 类KClass。Kotlin 编译器会自动把它转为 java 类,因此 java 代码就可以正常看到注解和参数了。
// Java
public @interface Ann {
int value();
}
// Kotlin
fun foo(ann: Ann) {
}