反射

反射是这样的一组语言和库功能,它允许在运行时自省你的程序的结构。 Kotlin 让语言中的函数和属性
做为一等公⺠、并对其自省(即在运行时获悉一个名称或者一个属性或函数的类型)与简单地使用函数
式或响应式⻛格紧密相关。
在 Java 平台上,使用反射功能所需的运行时组件作为单独的 JAR 文件(kotlin-reflect.jar)分发。这样做是为了减少不使用反射功能的应用程序所需的运行时库的大小。如果你需要使用反射,请确保该 .jar文件添加到项目的 classpath 中。

类引用

最基本的反射功能是获取 Kotlin 类的运行时引用。要获取对静态已知的 Kotlin 类的引用,可以使用 类字面值 语法:

val c = MyClass::class

该引用是 KClass 类型的值。
请注意,Kotlin 类引用与 Java 类引用不同。要获得 Java 类引用, 请在 KClass 实例上使用 .java 属性。

绑定的类引用(自 1.1 起)

通过使用对象作为接收者,可以用相同的 ::class 语法获取指定对象的类的引用:

val widget: Widget = ......
assert(widget is GoodWidget) { "Bad widget: ${widget::class.qualifiedName}" }

你可以获取对象的精确类的引用,例如 GoodWidget 或 BadWidget ,尽管接收者表达式的类型是Widget.

可调用引用

函数、属性以及构造函数的引用,除了作为自省程序结构外, 还可以用于调用或者用作函数类型的实例。
所有可调用引用的公共超类型是 KCallable<out R>, 其中 R 是返回值类型,对于属性是属性类型,
对于构造函数是所构造类型。

函数引用

当我们有一个具名函数声明如下:

fun isOdd(x: Int) = x % 2 != 0

我们可以很容易地直接调用它( isOdd(5) ),但是我们也可以将其作为一个函数类型的值,例如将其传
给另一个函数。为此,我们使用 :: 操作符:

val numbers = listOf(1, 2, 3)
println(numbers.filter(::isOdd))
result: System.out: [1, 3]

*filter fun *

/**
 * Returns a list containing only elements matching the given [predicate].
 */
public inline fun <T> Iterable<T>.filter(predicate: (T) -> Boolean): List<T> {
    return filterTo(ArrayList<T>(), predicate)
}

这里 ::isOdd 是函数类型 (Int) -> Boolean 的一个值。
函数引用属于 KFunction<out R> 的子类型之一,取决于参数个数,例如 KFunction3<T1, T2,T3, R> 。
当上下文中已知函数期望的类型时,:: 可以用于重载函数。 例如:

fun isOdd(x: Int) = x % 2 != 0
fun isOdd(s: String) = s == "brillig" || s == "slithy" || s == "tove"
val numbers = listOf(1, 2, 3)
println(numbers.filter(::isOdd)) // 引用到 isOdd(x: Int)

或者,你可以通过将方法引用存储在具有显式指定类型的变量中来提供必要的上下文:

val predicate: (String) -> Boolean = ::isOdd// 引用到 isOdd(x: String)

如果我们需要使用类的成员函数或扩展函数,它需要是限定的,例如 String::toCharArray 。
请注意,即使以扩展函数的引用初始化一个变量,其推断出的函数类型也会没有接收者(它会有一个接
受接收者对象的额外参数)。如需改为带有接收者的函数类型,请明确指定其类型:

val isEmptyStringList: List<String>.() -> Boolean = List<String>::isEmpty

示例:函数组合

考虑以下函数:

fun <A, B, C> compose(f: (B) -> C, g: (A) -> B): (A) -> C {
       return { x -> f(g(x)) }
}

它返回一个传给它的两个函数的组合: compose(f, g) = f(g(*)) 。 现在,你可以将其应用于可调
用引用:

属性引用

要把属性作为 Kotlin中 的一等对象来访问,我们也可以使用 :: 运算符:

val x = 1
fun main() {
    println(::x.get())
    println(::x.name)
}
//result:
//System.out: 1
//System.out: x

表达式 ::x 求值为 KProperty<Int> 类型的属性对象,它允许我们使用 get() 读取它的值,或者
使用 name 属性来获取属性名。更多信息请参⻅关于 KProperty 类的文档。
对于可变属性,例如 var y = 1 ,::y 返回 KMutableProperty<Int> 类型的一个值, 该类型有一
个 set() 方法。

var y = 1
fun main() {
    ::y.set(2)
    println(y)
//result : System.out: 2
}

属性引用可以用在预期具有单个泛型参数的函数的地方:

val strs = listOf("a", "bc", "def")
println(strs.map(String::length))
//result :System.out: [1, 2, 3]

要访问属于类的成员的属性,我们这样限定它:

class A(val p: Int)
val prop = A::p
println(prop.get(A(1)))
//result System.out: 1

对于扩展属性:

val String.lastChar: Char
     get() = this[length - 1]
fun main() {
    println(String::lastChar.get("abc"))
}

与 Java 反射的互操作性

在Java平台上,标准库包含反射类的扩展,它提供了与 Java 反射对象之间映射(参⻅ kotlin.reflect.jvm 包)。 例如,要查找一个用作 Kotlin 属性 getter 的 幕后字段或 Java方法,可以这样写:

import kotlin.reflect.jvm.*
class A(val p: Int)
fun main() {
    println(A::p.javaGetter) // 输出 "public final int A.getP()"
    println(A::p.javaField) // 输出 "private final int A.p"
}

要获得对应于 Java 类的 Kotlin 类,请使用 .kotlin 扩展属性:

fun getKClass(o: Any): KClass<Any> = o.javaClass.kotlin