Kotlin学习（12）元编程、注解与反射

@Target(AnnotationTarget.CLASS,

AnnotationTarget.FUNCTION,

AnnotationTarget.VALUE_PARAMETER,

AnnotationTarget.EXPRESSION)

@Retention(AnnotationRetention.SOURCE)

@Repeatable

@MustBeDocumented

annotation class Run

从这个关键字上可以看出注解也是一种class，编译器同样可以对注解类型在编译器进行类型检查。

自定义的注解中使用的注解，称之为元注解。通过向注解类添加元注解的方式来指定其他属性。元注解说明如表：

| 元注解名称 | 功能说明 |

| — | — |

| @Target | 指定这个注解可被用于哪些元素 ( 这些元素定义在kotlin.annotation.AnnotationTarget 枚举类中。它们是：类 CLASS, 注解类 ANNOTATION_CLASS，泛型参数 TYPE_PARAMETER，函数 FUNCTION, 属性 PROPERTY, 用于描述域成员变量的 FIELD，局部变量 LOCAL_VARIABLE，VALUE_PARAMETER，CONSTRUCTOR，PROPERTY_GETTER，PROPERTY_SETTER， 用于描述类、接口(包括注解类型) 或enum声明的 TYPE， 表达式 EXPRESSION，文件 FILE，类型别名TYPEALIAS等 |

| @Retention | 指定这个注解的信息是否被保存到编译后的 class 文件中, 以及在运行时是否可以通过反射访问到它, 可取的枚举值有3个，分别是： SOURCE （注解数据不存储在二进制输出），BINARY（注解数据存储在二进制输出中, 但反射不可见）， RUNTIME（注解数据存储在二进制输出中, 可用于反射 (默认值 ） |

| @Repeatable | 允许在单个元素上多次使用同一个注解 |

| @MustBeDocumented | 表示这个注解是公开 API 的一部分, 在自动产生的 API 文档的类或者函数签名中, 应该包含这个注解的信息。 |

2.2 使用注解

上面我们声明了Run注解，它可以使用在 CLASS、FUNCTION、VALUE_PARAMETER和EXPRESSION上，我们这里给出的示例使用在类上：

@Run

class SwordTest()

我们声明的 TestCase注解有个构造函数，传入的参数时一个String类型的ID，把这个注解用在函数上：

@Run

class SwordTest() {

@TestCase(id = “a”)

fun testCase(testId: String) {

println(“Run SwordTest Id = $testId”)

}

}

上面是注解在代码中的简单使用示例。其中的 @TestCase(id=“a”)是注解构造函数的使用。

注解可以带有参数的构造器。注解参数可支持的数据类型如下：

• 基本数据类型

• String

• KClass

• enum

• Annotation

• 上面的除了基本数据类型为引用的 数组

下面两种声明是不会通过的

annotation class TestCase1(val id: Array)

annotation class TestCase2(val id: SwordTest)

另外需要注意的是，注解类型中不能有null，因为 JVM不支持将null作为注解属性的值进行存储。

如果注解用作另一个注解的参数时，则其名称不能以 @字符作为前缀。

例如：

annotation class AnnoX(val value: String)

annotation class AnnoY(

val message: String

val annoX: AnnoX = AnnoX(“X”))

2.3 处理注解

如果没有相应的注解信息处理逻辑流程，那么注解可以说是废了，没有什么实用价值。

首先，我们的目标测试类是：

@Run

class SwordTest() {

@TestCase(id = “a”)

fun testCase(testId: String) {

println(“Run SwordTest Id = $testId”)

}

}

我们需要在 @TestCase注解作用在函数上的处理过程

1. ::class 引用

首先声明一个变量指向SwordTest实例

然后就可以通过这个变量来获取该对象的类的信息，使用 ::class来获取 sword对象实例的 KClass类的引用

val sword = SwordTest()

val kClass = sword::class

//有点像Java中的 getClass()

//上面这行代码，Kotlin编译器会自动推断出 kClass变量的类型是

val kClass:KClass = sword::class

2. members扩展属性

下面我们需要获取 sword对象类型所声明的所有函数。Kotlin中 可以直接使用扩展属性 declaredFunctions来获取这个类中声明的所有函数。

//返回的是一个 Collection<KCallable<>> 其中是Koltlin泛型中的星投影

val members = kClass.members

3. annotations属性

KFunction 类型继承了 KCallable，KCallable又继承了 KAnnotatedElement。KAnnotatedElement中有个public val annotations:List属性里存储了该函数所有的注解信息。通过遍历这个存储Annotation的List，可以获取到TestCase注解：

for (f in members ) {

f.annotations.forEach {

if(it is TestCase){

val id = it.id //TestCase 注解的属性ID

doSomething(id) //注解处理逻辑

}

}

}

4. call函数

另外，如果想通过反射来调用函数，可以直接使用 call()：

f.call(sword, id)

//等价于

f.javaMethod?.invoke(sword, id)

//到这里，我们就完成了一个简单的注解处理器，完整的代码如下：

@Target(

AnnotationTarget.CLASS,

AnnotationTarget.FUNCTION,

AnnotationTarget.VALUE_PARAMETER,

AnnotationTarget.EXPRESSION

)

@Retention(AnnotationRetention.SOURCE)

@Repeatable

@MustBeDocumented

annotation class TestCase(val id: String)

class SwordTest {

@TestCase(id = “a”)

fun testCase(testId: String) {

println(“Run SwordTest Id = $testId”)

}

}

fun testAnnoProcessing() {

val sword = SwordTest()

val kClass = sword::class

val members = kClass.members

for (f in members) {

f.annotations.forEach {

if (it is TestCase) {

val id = it.id

doSomething(id)

f.call(sword, id)

}

}

}

}

private fun doSomething(id: String) {

println(“Do Something in Annotation Processing $id ${System.currentTimeMillis()}”)

}

//测试：

main(){

testAnnoProcessing()

}

3. 反射

---

在Kotlin中我们有两种方式来实现反射功能。

一种是调用Java的反射包下的API

另外一种是 直接调用Kotlin语言提供的 kotlin.reflect包下面的API

不过因为反射功能的应用场景并非所有编程场景都会用到，所以Kotlin把 kotlin.reflect包放到了单独的 kotlin-reflect-1.1.xx.jar下面，也就是说我们如果要使用Kotlin的反射Api，还要去添加依赖。

3.1 类引用

我们先定义一个代码实例：

open class BaseContainer

class Container<T : Comparable> : BaseContainer {

val elements: MutableList

constructor(elements: MutableList) {

this.elements = elements

}

fun sort(): Container {

elements.sort()

return this

}

override fun toString(): String {

return “Container(elements = $elements)”

}

}

反射是在陨石时获取一个类引用。我们已经知道使用 ::class 可以获取到当前对象KClass对象。

val container = Container(mutableListOf(1, 3, 2, 5, 4, 7, 6))

val kClass = container::class

//如果是要使用Java中的类引用，就要使用javaClass

val jClass = container.javaClass

//或者使用KClass实例的.java属性

val jkClass = kClass.java

3.2 函数引用

例如，有一个简单地判断一个Int整数是否是奇数的函数：

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

//代码中调用

isOdd(4)

false

另外，在高阶函数中如果想把它当做一个参数来使用，可以使用 ::操作符

val nums = listOf(1, 2, 3)

val filteredNums = nums.filter(::isOdd)

println(filteredNums) //输出 [1,3]

这里的 ::isOdd 就是一个函数类型 (Int)->Boolean 值

3.3 属性引用

在Kotlin中，访问属性属于第一级对象，可以使用 "::"操作符

var one = 1

fun testReflectProperty() {

println(::one.get())

::one.set(2)

println(one)

}

表达式 ::one 等价于类型为KProperty的一个属性，它可以允许我们通过 get()函数获取值。

对于可以边属性 var one = 1，返回类型为 KMutableProperty的值，并且还有 set()方法

3.3 绑定函数和属性引用

val digitRegex = “\d+”.toRegex()

digitRegex.matches(“a”)

digitRegex.matches(“4”)

digitRegex.matches(“1”)

digitRegex.matches(“O”)

我们定义的 digitRegex.matches重复出现，比较显得样板化。

在Kotlin中，可以直接引用 digitRegex对象实例的matches() 方法，上面代码可以这样写：

val digitRegex = “\d+”.toRegex()

val isDigit = digitRegex::matches

isDigit(“a”)

isDigit(“4”)

isDigit(“1”)

isDigit(“O”)

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此我收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此我收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

[外链图片转存中…(img-xwlR3wiQ-1715680308083)]

[外链图片转存中…(img-PatPDUrn-1715680308085)]

[外链图片转存中…(img-0UFqlcHz-1715680308086)]

[外链图片转存中…(img-iZdcD2Dq-1715680308087)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！