背景知识

Dagger2 是一个由 Google （之前是 Square）维护的开源依赖注入框架。我曾两次试图学习 Dagger 最终被乱七八糟的名词弄得晕头转向，连个 demo 都没写出来就放弃了。所以本文也会重点解释 Dagger 的各个名词，只有熟悉了它们的作用，才能顺畅无阻地使用，也才能看懂别人的 demo。

虽然标题叫 Dagger2 in Android，但是前几节都是 Dagger 通用的基础知识，与 Android 没有关系。

本系列使用 Kotlin 语言，其与 Java 100% 兼容，仅仅是语法不同而已，不会造成太大影响。Kotlin 最终依然会被编译成 jvm 字节码。

例如 java 定义函数： public String getName() {return "David"}

kotlin 版本：fun getName(): String {return "David"}，甚至可以更简洁：fun getName() = "David"

依赖注入

那么首先我们得先清楚什么是依赖注入。依赖注入是实现控制反转（IoC）的一个方案。 那什么叫控制反转？别急，我尽量用最通俗的方式解释所涉及的所有概念。

通常在面向对象语言中，一个类往往依赖其他类，一个对象依赖其他对象。那么最直接的方案就是 new 一个出来。这很好理解，我依赖计算机，所以我就自己造一个出来。那么造出的计算机当然是我自己控制的，这就是“控制正转”。那么反转就是，我需要计算机，但是我不自己造，而是厂家造好之后交给我。这就是控制反转。因为我不再控制计算机的生产，此时厂家就叫做 IoC 容器，它负责生产维持对象，而我只负责拿来用。所以 IoC 不是技术，而是思想，利用这种思想可以降低对象间的耦合，提高代码重用率。 倘若计算机的配置发生了变更，在之前每个人都要自己更新图纸，但是现在只需要厂家更新就好了，我总可以拿到最新款的计算机。

为了实现控制反转，有很多方案，常见的有 依赖注入、依赖查找、服务定位器。这里我们讲依赖注入。

其实依赖注入不是什么新东西，我们天天都在用。依赖注入有三种常见的手段：构造函数、Setter、注解。举个厨师的例子：厨师依赖炉子。那么代码可以这么写：

// 通过构造函数注入炉子
class Chef(val stove: Stove) {
}

// 通过 Setter 注入
class Chef() {
    var stove: Stove
    
    // 其实 Kotlin 默认实现了 setter，为了更加清晰我手动写了一个。
    fun setStove(stove: Stove) {
        this.stove = stove
    }
}

看到没，依赖注入就在我们身边，我们一直都在用。厨师需要炉子，但他不自己造炉子，而是别人造好后传给他用，也就是「注入」。

Dagger 优势

既然完全可以通过构造函数注入，那为什么要 dagger 呢？当然是因为 dagger 更方便哈哈。

继续厨师的例子，我们知道炉子必须依赖燃料。那么为了得到一个厨师，我们必须先后得到一个燃料、炉子，看下面的代码：

class Stove(val fuel: Fuel) {}

class Fuel(){}

// 创建一个厨师
val fuel = Fuel()
val stove  = Stove(fuel)
val chef = Chef(stove)

看到没，为了得到一个厨师，我们需要创建一堆东西。如果你觉得还不够，其实厨师还依赖菜刀，燃料还依赖天然气。总有一天你会不耐烦。

事实上，有时候2个厨师可以共用1个炉子，而3个炉子可以共用1瓶燃料。这些问题 Dagger 通通可以优雅地解决。怎么样 是不是有点感觉了<(￣︶￣)↗

进入主题

引入 Dagger

Dagger 可以通过多种方式引入，详见 README。作为 Android 我们可以使用 Gradle 声明依赖（kotlin）：

dependencies {
    def dagger_version = "2.23.1"
    implementation "com.google.dagger:dagger:$dagger_version"
    kapt "com.google.dagger:dagger-compiler:$dagger_version"
    
    // 如果需要使用 Android 的特有 Dagger 功能，还要引入下面的库
    implementation "com.google.dagger:dagger-android:$dagger_version"
    implementation "com.google.dagger:dagger-android-support:$dagger_version"
    kapt "com.google.dagger:dagger-android-processor:$dagger_version"
}

@Inject

@Inject 是我们接触到的第一个 Dagger 注解。它有两个作用：① 标注哪些东西需要注入。② 标注这些东西怎么创建。

假设 Dagger 是后勤管理部，那么作为厨师，你必须告诉 Dagger 需要哪些东西，然后还要告诉他这些怎么造，这样 Dagger 才能注入给你。所以厨师和炉子（简单起见忽略燃料）我们可以这样改写：

// 告诉 Dagger 炉子可以通过一个无参的构造函数造出来
class Stove @Inject constructor() {}

class Chef() {
    @Inject // 告诉 Dagger 我需要一个炉子
    val stove: Stove
}

就是这么简单。现在 Dagger 已经知道我们需要什么、这个东西怎么创建了。这里我把厨师称为目标类，也就是「炉子要往哪注入」，这就是目标。

@Component

之前我们已经让厨师和炉子建立了无形的联系。但是要真正获得炉子，但是还得让这个联系直接一点。毕竟之前那都是泛泛而谈，针对具体的一个厨师（实例）我们得具体操作。这个桥梁就是 @Component。Component 将具体连接厨师所依赖的炉子，和炉子的构造函数。

Component 是一个注解类，且是一个接口或抽象类。因此必须对一个接口标记 @Component 才能获得一个 Component。它将获得一个目标类实例的引用（也就是一个活生生的厨师），然后查找这个类所依赖的类（询问厨师你需要啥）。得到答案之后它会去查找是否有已知的构造函数（之前 @Inject 标注过的），然后实例化并注入到目标类（造个炉子交给厨师）。

根据上面的解释，我们可以轻松写出一个 Component：

@Component
interface MainComponent {
    // 定义一个函数，以便拿到目标类实例的引用
    fun inject(chef: Chef)
}

其实到目前为止我们已经实现一个完整的依赖注入了：告诉 Dagger 厨师需要炉子、告诉炉子应该怎么造，并且建立了一个直接的桥梁。

恭喜！(。⌒∇⌒)

@Module

这又是什么鬼呢？我们来想想，如果厨师也不会造炉子咋办。 反应到项目中就是，我们引入了第三方库，这个库没有在构造函数上标记 @Inject，总不能修改源码自己加上吧。这时候就要 Module 出场拉。Module 相当于给第三方库套一层封装，给他从外面包裹一个能够通知 Dagger 的创建方法。比如厨师不会造炉子，但是他知道去哪买，那么这也是OK的。

按照这个思路我们修改一下厨师炉子的代码：

// 现在去掉炉子的 @Inject 代表厨师不会造炉子
// 假设炉子是第三方库，我们无权添加 @Inject
class Stove(){}

@Module
class MainModule() {
    // 虽然我不会造，但我可去 [MainModule] 这个商店买
    provideStove():Stove {
        return Stove()
    }
}

Module 就像工厂模式，里面提供了各种创建实例的方法。

现在我们必须让 @Component 知道 Module（商店）的存在。非常简单：

// 直接传入 Mudoule 类数组就好啦
@Component(modules = [MainModule::class])
interface MainComponent {
    fun inject(chef: Chef)
}

然后有一个新问题，之前利用 @Inject 标注了类的构造方法，现在 @Module 只标注了一个商店，并没有指明某个具体的类（炉子）到底怎么获得。就好像现在后勤管理处知道去家乐福可以买个炉子，但是不知道具体在哪个区域。

[注] 一个 Module 可以被多个 Component 引用。因为有可能多家超市都卖炉子。

@Provides

Provides 将最终解决第三方库的问题。我们把 Module 中所有创建实例的函数都用 Provides 标注。那么这些函数就是会 Dagger 所识别然后选择一个返回值类型匹配的进行调用。

现在对于厨师依赖的第三方炉子，Dagger 将这样处理：首先桥梁告诉他有个商店(MainModule)可能有炉子，于是到商店筛选所有货架(Provides)，找到匹配的商品带回来即可。

@Module
class MainModule() {
    @Provides // 加上一个注解表明这个函数可以提供一个炉子（或其他物品）
    provideStove():Stove {
        return Stove()
    }
}

---

到目前为止，我们已经了解了 Dagger 的基础内容。我们已经学会了如何通知 Dagger 所需的依赖、依赖类如何创建，以及对于第三方提供的类该如何包装并使 Dagger 识别。

希望厨师的类比能帮助你更好地理解相关概念。下面我们将继续学习其他注解