第9章 注解与依赖注入框架

在《第9章 注解与依赖注入框架》中，本页依据刘望舒《Android进阶之光》独立重构，不复制原文。版本锁定电子工业出版社2017年7月首版、492页、ISBN 9787121315305；正式结构为11章、190个章/节/小节节点。

在《第9章 注解与依赖注入框架》中，原书处在Android 5.0至7.0、Java与Support Library时代，包含AsyncTask、Volley、otto、RxJava早期版本、ButterKnife、Dagger 2和Data Binding。课程先复现历史机制，再以AndroidX、协程/Flow、现代架构组件作迁移对照。

从可观察行为开始

注解处理器、控制反转、依赖注入、对象图、作用域构成本页的分析词汇。先预测一次输入会穿过哪些对象、线程、队列、View或语言边界，再运行正常与失败样本；没有版本和原始证据的“源码原理”不能复查。

本单元主线是从注解分类、定义和处理器进入IoC与依赖注入实现，并解析ButterKnife和Dagger 2。交互管线逐项选择目录节点，反例实验切换正常、配置变化、线程竞争、所有者销毁和版本漂移，证据门要求目录、行为、线程、生命周期与迁移全部通过。

最小实现与边界

@Component(modules = [NetworkModule::class])
interface AppComponent {
    fun inject(activity: MainActivity)
}
 
@Provides
@Singleton
fun provideApi(client: OkHttpClient): Api = Retrofit.Builder().client(client).build().create(Api::class.java)

在《第9章 注解与依赖注入框架》中，实现后用固定输入记录输出、线程名、生命周期、异常和资源释放。再构造错误输入、取消、旋转、后台切前台及低版本设备，验证便利框架没有隐藏所有权问题。

data class AndroidProbe(
    val apiLevel: Int,
    val ownerActive: Boolean,
    val callbackThread: String,
    val resultStable: Boolean
)
check(probe.ownerActive && probe.resultStable)

证据解释

第一份证据是行为基线。固定Android版本、依赖版本、构建类型、输入数据和页面生命周期，完整记录“从注解分类、定义和处理器进入IoC与依赖注入实现，并解析ButterKnife和Dagger 2”从入口到结果的顺序。除了成功输出，还要保存回调线程、对象身份、队列或订阅状态以及释放日志；否则无法判断升级后的差异来自业务代码、框架实现还是测试环境。

第二份证据是反例。针对“把依赖注入等同于隐藏new，未定义对象图所有者、作用域与生成代码的可检查边界”构造至少一个可重复失败：在配置变化、快速重复输入、网络超时、后台切换或所有者销毁时观察错位、重复、泄漏和迟到回调。反例必须写明预期拒绝条件；只展示正常路径会掩盖框架最重要的所有权边界。

第三份证据是源码定位。先锁定仓库标签和库版本，再从公开入口沿实际调用追踪，不跨版本拼接类名。每次跨线程、跨进程或跨Java/Native边界，都记录调用方、被调用方、数据形态、错误返回和资源归属。注解保留策略、处理器输入输出、生成源码、对象图、作用域、循环依赖和编译失败样例应能让另一位读者在相同版本上重建同一条链。

在《第9章 注解与依赖注入框架》中，第四份证据是迁移对照。现代API解决的问题可能相同，但取消、缓存、状态恢复、线程和错误语义未必一致。迁移时保持输入和验收不变，一次只替换一个组件；新旧结果不一致时先解释差异，再决定适配或回退，不能用“新版推荐”跳过历史行为验证。

迁移账本

原书节点: 第9章 注解与依赖注入框架
历史基线: Android 5.0—7.0 / Java / Support Library
现代候选: 一次只替换一个API或框架
不变量: 业务结果、线程、生命周期、错误与资源释放
证据: 注解保留策略、处理器输入输出、生成源码、对象图、作用域、循环依赖和编译失败样例
回退: 任一不变量失败即恢复历史实现

本章回顾

从一个真实输入复盘：它由谁接收、在哪个线程执行、状态和对象归谁所有、何时取消或释放、低版本与异常路径如何表现。然后用注解保留策略、处理器输入输出、生成源码、对象图、作用域、循环依赖和编译失败样例重放；无法复现的结论退回实验阶段。

复习与独立交接

← 上一页：第8章 函数响应式编程 · 下一页：第10章 应用架构设计 →

原版目录概念补充核对

以下条目补齐官方目录中容易被示例主线掩盖的概念。它们不重复罗列目录，而是明确每项概念的机制、适用边界和验收证据。

9.1 注解：机制、边界与证据

第9章 注解与依赖注入框架中的9.1 注解跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.1.1 注解分类：机制、边界与证据

第9章 注解与依赖注入框架中的9.1.1 注解分类跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.1.2 定义注解：机制、边界与证据

第9章 注解与依赖注入框架中的9.1.2 定义注解跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.1.3 注解处理器：机制、边界与证据

第9章 注解与依赖注入框架中的9.1.3 注解处理器跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.2 依赖注入的原理：机制、边界与证据

第9章 注解与依赖注入框架中的9.2 依赖注入的原理跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.2.1 控制反转与依赖注入：机制、边界与证据

第9章 注解与依赖注入框架中的9.2.1 控制反转与依赖注入跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.2.2 依赖注入的实现方式：机制、边界与证据

第9章 注解与依赖注入框架中的9.2.2 依赖注入的实现方式跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.3 依赖注入框架：机制、边界与证据

第9章 注解与依赖注入框架中的9.3 依赖注入框架跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.3.1 为何使用依赖注入框架：机制、边界与证据

第9章 注解与依赖注入框架中的9.3.1 为何使用依赖注入框架跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.3.2 解析ButterKnife：机制、边界与证据

第9章 注解与依赖注入框架中的9.3.2 解析ButterKnife跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.3.3 解析Dagger2：机制、边界与证据

第9章 注解与依赖注入框架中的9.3.3 解析Dagger2跨越源码注解、生成代码、对象图与生命周期，框架隐藏的创建顺序仍需可追踪。保存生成源码和依赖图，比较缺失绑定、作用域错配与重复创建，确认编译诊断和对象身份符合合同。

9.4 本章小结：机制、边界与证据

第9章 注解与依赖注入框架中的9.4 本章小结应固定 Android 5.0–7.0、Java 与旧 Support Library 语境，写出输入、状态、线程、生命周期和失败结果。以最小实现和单变量反例保存日志、状态快照与迁移差异。