Dagger2的轻松愉悦解析

　　Dagger2，依赖注入框架，一个刚接触时感受麻烦，用久了就会“嘴上说不要，身体却很诚实”的开发润滑剂(◐‿◑)。（本文为拖更而生）

1、Dagger2 介绍

一、为何使用dagger2

 谁用谁知道Σ(￣。￣ﾉ)ﾉ，如丝般顺滑，奶不死的Dagger2 ，主要优点体如今：

• 解决项目中多实例依赖建立问题，如：new A(new B(new C()))。
• 更好的对象生命周期依赖和管理，如经过@Scope规范实例的生命周期。
• 规范代码，提升解耦能力，加强代码的拓展能力，如类的依赖、建立、复用、拓展都经过@Component、@Module、@Inject的规范实现。
• 最重要的是：代码看起来比较装逼！

困了吗？困了咱们就开始咯

二、简单原理介绍

 Dagger2 能够理解为一套开发规范，遵照这套规范编写的代码，经过Dagger2 的运行时注解，在编译时自动生成模版代码，已达到注入和复用的目的。

 自动生成的代码，通常存在路径build\generated\source\apt下。那么了解完这套模版规范，Dagger2 将再也不神秘，“深刻浅出”“指日可待”(˶‾᷄ ⁻̫ ‾᷅˵)啊。

关于运行时注解不了解的可查阅：《Android注解快速入门和实用解析》

2、Dagger2 剖析

 让咱们循环渐进的开始吧。

 首先看下图，Dagger2中主要的三个注解是 ：@Inject、@Component、@Module。

 它们是最基础，也是使用最多注解，咱们将从它们身上开始“摸索”Σ(￣。￣ﾉ)ﾉ。

• 由 @Inject 指向须要构成注入的类和环境。
• 由 @Module 提供生成对象所需的参数。（通常是在 @Inject 注解的对象，其构造函数没法添加 @Inject时使用。）
• 由 @Component 做为中间桥梁链接注入对象和工厂。

主要关系图

一、Inject

 一切的“插入”从它开始！@Inject指定须要注入的类和环境，以下方图2，TasksActivity 中 mTasksPresenter 是被Inject注解的对象，同时TasksPresenter 的构造函数也被Inject注解。

 内部成员被 @Inject 注解时，如 mTasksPresenter，Dagger2 就会找 TasksPresenter 中被 @Inject 注解的构造函数，若是找到了，便对其构建注入。

 那么问题来了！这时候若是 TasksPresenter 的构造方法为空构造方法，便万事大吉。惋惜现实老是那么骚！图中 TasksPresenter 的构造函数有参，须要 tasksRepository 和 tasksView 两个参数，那即是后面的@Module的用武之地，它将提供“后门注入”支持。

我是图2

 既然知道 @Module 的做用，咱们先继续往下走，构造方法被注解的类，会生成一个继承Factory的类，如 TasksPresenter 生成 TasksPresenter_Factory , 以下图3，这是由Dagger2的自动编译生成的，这个工厂用于提供实例化类，其中的get()方法即是在注入时被调用。

 固然，你彻底能够不关心这些。可是了解这些，有时候能够更愉悦的装逼(-_^)，因此我选择憋着往下看。

图三图三

 继续深刻，以下图四，在被 @Inject 注解的内部参数或方法，会生成对应的继承MembersInjector的类， 如 TasksActivity_MembersInjector。在它调用.inject(this);时，实际上就是调用了上面 TasksPresenter_Factory 的 get() 方法注入进去的。

 看到没，这不就联系起来了么，城市套路深啊，并且还很滑！(˶‾᷄ ⁻̫ ‾᷅˵)

图四赛高

二、Module

 上面说过，由于构造方法包含参数，而所包含的参数，其构造方法没法被 @Inject 注解，这时候就须要 @Module 提供“后门”。

 举个栗子：类A的构造方法须要类B，但类B的构造方法没法添加 @Inject 注解。这时候经过 @Module ，在内部使用 @Provides注解的以provide开头的方法，这些方法就是所提供注入所需的依赖，如图5。

如图5

 一样是自动生成模版代码，@Module 注解的类中，每个 @Provides修饰的方法，都会生成一个工厂类，如图六下生成：TasksModule_ProvideTasksViewFactory ，经过get()方法提供注入时所需的参数。

 这时候回到图四，能够看到这些get()方法，即是在 TasksPresenter_Factory 的 get() 被调用时使用　看到没，这不又联系起来了么，套路套路啊！(˶‾᷄ ⁻̫ ‾᷅˵)。

图六六六六六

三、Component

 作了那么多，总得用起来吧。Component 就是将 @Inject 和 @Module 联系起来的桥梁，从 @Module 中获取依赖，并将依赖注入给 @Inject 注解的参数。

 如图七，@Component 接口指定了使用的 Module 和依赖的 Component。是的，Component依赖，这样更有利于代码的复用。

　　
　　

图七

@Component的接口的内部方法简单可分为：

• 若是是void就必须有注入环境类。
• 若是参数为空，就必须有返回类。返回类必须有 @Inject 提供构造方法类，或者引用的 @Module 有 @Provide提供的。

 一样的套路，TaskComponent会生成 DaggerTaskComponent 类，这个类即是咱们须要使用的对象，如图八图九，能够看到上面生成的对象，都是在其中被使用，最后经过咱们定义好的 inject() 方法，以下方代码实现注入效果。

//注入咯注入咯
DaggerTasksComponent.builder()
        .tasksRepositoryComponent(((ToDoApplication) getApplication()).getTasksRepositoryComponent())
        .tasksPresenterModule(new TasksPresenterModule(tasksFragment)).build()
        .inject(this);复制代码

图爸

图舅

 怎么样，这样的套路清晰了么？(˶‾᷄ ⁻̫ ‾᷅˵)，简单总结起来其实以下方这样，须要咱们动手的，其实并很少：

• 使用 @Inject 注解须要注入的参数和方法。
• 使用 @Module 提供构造方法中没法注解的参数。
• 使用 @Component 连起起来，而且调用注入。

四、关联总结

　　来简单总结下生成模版的关系，不感兴趣的能够略过···吧(#ﾟДﾟ)：

• 注解构造方法，生成的 TasksPresenter_Factory ，内部经过 create 方法 建立Factory，经过get方法 提供 TasksPresenter 对象。

• TasksModule_ProvideTasksViewFactory ，由Module中@Provide注解的方法生成，内部经过 create 方法建立，经过 get 方法提供 TasksPresenter_Factory 在建立 TasksPresenter 须要的参数。

• TasksComponent生成DaggerTasksComponent 初始化时 ，经过 TasksModule_ProvideTasksViewFactory做为参数建立了 TasksPresenter_Factory , 在TasksActivity_MembersInjector 中，经过injectMembers 方法，利用 TasksPresenter_Factory 的 get 实现注入。

• DaggerTasksComponent 中外部提供Builder设置方法，和依赖的Component与module数量有关。若是依赖的未被使用，会有@deprecated提示。

总结图

3、稍微再“深刻”

一、Scope

 让咱们再稍微深刻一点去了解Dagger2吧，生命周期是值得关心的。好比内置的 @Singleton 注解，字面上就是单例的意思，可是实际上直接使用 @Singleton 并不会有单例的效果。

图十@Singleton注解的class

 @Singleton其实是一种规范注解，它属于 @Scope 注解的一种，正如字面上所示，它表明着单例的生命周期，事实上 @Scope 是一种做用域注解，经过Component、Module一其配种使用，才能达到做用域的效果。

 如上图十，下图11，12中， TasksRepository、TasksRepositoryComponent 、TasksRepositoryModule 都被 @Singleton 注解了，可是这并不表明着他们就是单例，只是经过注解限定做用域，而且在字面上代表了它们单例。

图11

图12

 真正的单例效果, 是下图13中在 ToDoApplication 中 DaggerTasksRepositoryComponent 的建立。粗俗点说，就是由于Application中的 mRepositoryComponent 对象只有一个，因为做用域 @Scope 的做用，那么getTasksRepository() 获取的TasksRepository 达到了单例的效果。

图13

 这里理解下来，以下方代码，咱们建立一个@ActivityScoped 的Scope注解，限定注入对象 TasksPresenter 的生命周期是和Activity相关的，而后咱们在 TasksActivity 中，调用 DaggerTasksComponent 注入。由于 DaggerTasksComponent 在 TasksActivity 中惟一，因此 TasksPresenter 在Activity中也惟一。

@Documented
@Scope
@Retention(RetentionPolicy.RUNTIME)
public @interface ActivityScoped {
}
········
@ ActivityScoped
public class TasksRepository  implements TasksDataSource{
  ···
}
·······
public class TasksActivity extends AppCompatActivity {

    @Inject TasksPresenter mTasksPresenter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.tasks_act);

        // Create the presenter
        DaggerTasksComponent.builder()
                .tasksRepositoryComponent(((ToDoApplication) getApplication()).getTasksRepositoryComponent())
                .tasksPresenterModule(new TasksPresenterModule(tasksFragment)).build()
                .inject(this);

    }复制代码

 上面这段看起来是否是不少余？有点废话？

 可是确也是最好理解的，若是换个方法，好比把 @Inject TasksPresenter mTasksPresenter; 写在Fragment，DaggerTasksComponent 在Activity构建，而后在多个Fragment的onCreateView调用inject(this)呢？

 很明显注入的mTasksPresenter对象就是Activity生命周期，而和Fragment生命周期无关，而且因为Dagger2内部的限定，Scope能够更好的规范Module和Component的生命周期。

 还有更多的场景和规范要求，这里就不一一展开了，有兴趣深刻了解的可谷歌之。（确定不是由于懒得展开！！）

倦了倦了

二、Qualifier

 简单的理解，它就是一个Tag标记的做用。

 以下方代码，咱们定义了Remote和Local两种@Qualifier 注解，在Module中，提供的 TasksDataSource经过Remote和Local两种Tag区分，这样在注入的时候，也能够经过Tag指定注入参数。

 很好理解吧！这里就不展开了，一展开了又是一堆····╮(╯▽╰)╭，是时候收尾了，你（wo）也须要休息休息了。

//类型一
@Qualifier
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Remote {
}
······
//类型二
@Qualifier
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Local {
}
······
//提供时区分类型
@Module
abstract class TasksRepositoryModule {

    @Singleton
    @Local
    abstract TasksDataSource provideTasksLocalDataSource(TasksLocalDataSource dataSource);

    @Singleton
    @Remote
    abstract TasksDataSource provideTasksRemoteDataSource(FakeTasksRemoteDataSource dataSource);
}
······
//根据类型注入
 @Inject
 TasksRepository(@Remote TasksDataSource tasksRemoteDataSource,
            @Local TasksDataSource tasksLocalDataSource) {
        mTasksRemoteDataSource = tasksRemoteDataSource;
        mTasksLocalDataSource = tasksLocalDataSource;
 }复制代码

最后推荐下相关的demo

• android-architecture : todo-mvp-dagger2 分支中有详细的demo演示。

• LazyRecyclerAdapter :我的在这个开源项目包含有Dagger2在java和kotlin中的使用demo。

熟悉的口味