注解

注解声明

注解是一种将元数据附加到代码中的方法。声明注解需要在类前面使用 annotation 关键字:

annotation class fancy

用法

@fancy class Foo {
	@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)
	//...

也可以注解属性访问者:

class Foo {
	var x: MyDependency?=null
		@inject set
}

构造函数

注解可以有带参数的构造函数。

annotation class special(val why: String)
special("example") class Foo {}

Lambdas

注解也可以用在 Lambda 中。这将会应用到 lambda 生成的 invoke() 方法。这对 Quasar框架很有用,在这个框架中注解被用来并发控制

annotation class Suspendable
val f = @Suspendable { Fiber.sleep(10) }

java 注解

java 注解在 kotlin 中是完全兼容的:

import org.junit.Test
import org.junit.Assert.*

class Tests {
  Test fun simple() {
    assertEquals(42, getTheAnswer())
  }
}

java 注解也可以通过在导入是重命名实现像修改者那样:

import org.junit.Test as test

class Tests {
  test fun simple() {
    ...
  }
}

因为 java 中注解参数顺序是没定义的,你不能通过传入参数的方法调用普通函数。相反,你需要使用命名参数语法:

//Java
public @interface Ann {
	int intValue();
	String stringValue(0;
}

//kotlin
Ann(intValue = 1, stringValue = "abc") class C

像 java 中那样,值参数是特殊的情形;它的值可以不用明确的名字。

public @interface AnnWithValue {
	String value();
}

//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 代码就可以正常看到注解和参数了。

import kotlin.reflect.KClass

annotation class Ann(val arg1: KClass<*>, val arg2: KClass<out Any?>)

Ann(String::class, Int::class) class MyClass

注解实例的值在 kotlin 代码中是暴露属性。

// Java
public @interface Ann {
    int value();
}
// Kotlin
fun foo(ann: Ann) {
    val i = ann.value
}