深入实践KOTLIN元编程

目　录　Contents
前言
**部分　元编程的基础知识
第1章　元编程概述2
1.1　元编程的需求背景2
1.2　元编程的基本概念4
1.2.1　元编程的定义5
1.2.2　元编程的分类5
1.3　元编程的学习方法6
1.3.1　培养兴趣6
1.3.2　付诸行动6
1.3.3　善用工具7
1.3.4　多读源代码8
1.4　常用项目的调试环境配置8
1.4.1　Java编译器8
1.4.2　Kotlin编译器11
1.4.3　IntelliJ社区版13
1.4.4　Jetpack Compose编译器插件19
1.5　本章小结21
第2章　元数据概述22
2.1　基本概念22
2.1.1　语法结构23
2.1.2　编译产物23
2.2　注释23
2.2.1　注释的结构化23
2.2.2　文档生成24
2.3　注解25
2.3.1　注解的概念25
2.3.2　源代码可见的注解26
2.3.3　二进制可见的注解27
2.3.4　运行时可见的注解30
2.4　Kotlin的元数据31
2.4.1　Kotlin JVM中的@Metadata
　　　注解31
2.4.2　Kotlin JVM模块中的元数据35
2.4.3　klib中的元数据37
2.5　Kotlin的语法树39
2.5.1　Kotlin的语法定义40
2.5.2　基于IntelliJ平台接口的抽象语
　　　法树41
2.5.3　新一代语法树FIR42
2.5.4　连接前后端编译器的IR43
2.5.5　Java和Kotlin的符号树45
2.6　Kotlin的编译产物47
2.6.1　JVM47
2.6.2　JavaScript48
2.6.3　Native48
2.7　本章小结49
第二部分　元编程的技术实践
第3章　运行时的反射52
3.1　Java反射52
3.1.1　基本功能52
3.1.2　解除访问限制53
3.1.3　动态代理54
3.1.4　对注解的支持55
3.1.5　对方法参数名的支持56
3.1.6　访问Kotlin代码57
3.2　Kotlin反射58
3.2.1　基本功能59
3.2.2　类引用的获取61
3.2.3　属性引用和函数引用65
3.2.4　typeOf67
3.2.5　dynamic类型69
3.2.6　属性委托70
3.3　案例：Retrofit的接口实现72
3.3.1　Retrofit基本用法72
3.3.2　GitHubService实例的创建73
3.3.3　函数参数与请求参数的
　　　　　 对应关系74
3.3.4　泛型类型的反序列化74
3.3.5　案例小结75
3.4　案例：使用反射实现DeepCopy75
3.4.1　案例背景75
3.4.2　需求分析76
3.4.3　案例实现78
3.4.4　小试牛刀79
3.4.5　案例小结79
3.5　案例：使用dynamic类型为
　　　Kotlin JS实现DeepCopy80
3.5.1　案例背景80
3.5.2　需求分析80
3.5.3　案例实现83
3.5.4　案例小结83
3.6　本章小结84
第4章　源代码生成85
4.1　直接输出目标代码85
4.1.1　一个简单的例子85
4.1.2　标准库的代码生成87
4.2　案例：为Kotlin添加Tuple类型88
4.2.1　案例背景88
4.2.2　需求分析90
4.2.3　案例实现91
4.3　使用模板引擎生成目标代码93
4.3.1　Anko中的代码生成93
4.3.2　使用模板引擎渲染目标代码95
4.4　案例：为Java静态方法生成
　　Kotlin扩展函数（模板引擎）96
4.4.1　案例背景96
4.4.2　需求分析96
4.4.3　案例实现98
4.4.4　代码优化101
4.5　使用代码生成框架生成目标代码104
4.5.1　JavaPoet104
4.5.2　KotlinPoet109
4.6　案例：为Java静态方法生成
　　Kotlin扩展函数（KotlinPoet）114
4.6.1　类型的映射114
4.6.2　实现代码生成116
4.6.3　泛型参数的支持118
4.7　本章小结121
第5章　编译时的符号处理122
5.1　符号的基本概念122
5.1.1　Java的符号122
5.1.2　Kotlin的符号124
5.1.3　符号与语法树节点的关系和
　　　区别125
5.2　处理器的基本结构125
5.2.1　APT的基本结构125
5.2.2　KSP的基本结构130
5.2.3　APT与KSP的结构差异131
5.2.4　处理器的配置文件132
5.3　深入理解符号和类型132
5.3.1　获取修饰符133
5.3.2　通过名称获取符号133
5.3.3　获取符号的类型134
5.3.4　通过类型获取符号138
5.3.5　判断类型之间的关系139
5.3.6　获取注解及其参数值141
5.4　案例：基于源代码生成模块的
　　符号文件144
5.4.1　案例背景144
5.4.2　案例实现：APT版本145
5.4.3　案例实现：KSP版本147
5.5　深入理解符号处理器148
5.5.1　如何使用APT处理Kotlin
　　　符号148
5.5.2　符号的有效性验证150
5.5.3　处理器的轮次和符号的延迟
　　　处理150
5.5.4　处理器对增量编译的支持151
5.5.5　多模块的符号处理154
5.6　案例：使用符号处理器实现
　　DeepCopy156
5.6.1　案例背景156
5.6.2　需求分析156
5.6.3　案例实现：APT版本157
5.6.4　案