Dagger2 Android依赖注入学习笔记

前言

最近在用 MVP + RxJava + Retrofit 写项目，觉得相对于其他的开发框架，这的确是给我们带来了很多方便，但是在网上搜寻相关资料的时候，总是能看到 MVP + RxJava + Retrofit + Dagger 这样的搭配组合，那 Dagger 又是一个怎样的框架呢，我也去具体搜了搜，但看到一些文章带着“Dagger2从入门到放弃”这样意思的句子，就感觉Dagger2会很难吗，emmmm...行吧，好像是有点难理解，但是想着既然有那么多人用这个框架，必然有它的好处，于是花了些时间学习了一波。

Dagger2

Dagger2 ： A fast dependency injector for Android and Java. （官方给出的定义）

Dagger2是一个依赖注解框架，它的作用就是通过注解来实现组件之间的依赖，由此来达到更好的解耦，比如说，如果将 Dagger2 使用到我们的 MVP 框架中，那么我们就可以达到 V层 和 P层 的进一步解耦，从而使我们的项目有更好的维护性。

Dagger2 和 Butterknife 一样，都是在编译阶段利用Java注解通过APT（Annotation Processing Tool）自动生成Java代码，然后由我们自己写的代码进行调用，完成依赖注入，因此不用担心性能上的问题。那么如何来使用 Dagger2 呢？我们先来看一下使用 Dagger2 和不使用的区别。

对比

用简单的例子来说明。比如说我们有这样一个AAA类，没什么内容，只有一个get()方法

/**
 * @author chaochaowu
 * @Description : AAA
 * @class : AAA
 * @time Create at 6/12/2018 10:58 AM
 */

public class AAA {

 public AAA() {
 }

 public void get(){
  Log.e("AAA","has gotten.");
 }

}

我们需要在MainActivity用到这个类，因此MainActivity中变含有这个成员变量，有了这个成员变量aaa，我们就要对它进行实例化，因此会有以下的代码：

/**
 * @author chaochaowu
 * @Description : MainActivity
 * @class : MainActivity
 * @time Create at 6/12/2018 10:58 AM
 */
public class MainActivity extends AppCompatActivity {

 AAA aaa;

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

  aaa = new AAA();
  aaa.get();

 }
}

我们需要在 MainActivity 中声明aaa这个变量，然后会对其进行new一个实例，然后才能对其进行调用，调用它定义的方法。这样，AAA类对象的创建就和 MainActivity 耦合在了一起。如果使用 Dagger2 进行依赖注入呢

/**
 * @author chaochaowu
 * @Description : MainActivity
 * @class : MainActivity
 * @time Create at 6/12/2018 10:58 AM
 */
public class MainActivity extends AppCompatActivity {

 @Inject
 AAA aaa;

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

  DaggerMainActivityComponent.create().inject(this);

  aaa.get();

 }
}

代码就会变成这样。我们可以发现MainActivity里没有任何有关aaa的初始化赋值，但是它还是可以调用其get()方法。这样我们就达到了解耦合的目的。

这样一个简单的例子可能看不出 Dagger2 的好处，但是你可以想象一下，如果这个 Activity 里有很多个类似 AAA 这样的类的成员变量，它们都需要初始化，有的初始化还要传参数，那么，这个 Activity 就会变得臃肿，如果 AAA类 的初始化参数变了，不仅 AAA类 需要改，MainActivity 因为它与AAA类的耦合也要跟着改变，如果 AAA类 不止用在 MainActivity 中还用在了其他的 Activity 中，那么要改的东西变的可有点多咯，但是如果用上Dagger2，我们就可以很好的解决这个问题。

注解介绍

Dagger2中注解有：@Inject， @Component， @Module， @Provides， @Qulifier， @Scope， @Singleten 。而我们主要用到的是@Inject， @Component，@Module， @Provides 这四个，下面来介绍一下。

@Inject

Inject 主要用来标记需要依赖的变量，告诉Dagger需要为它提供依赖；inject 还被用来标记类的构造函数。当Dagger2碰到使用@Inject注解的变量时，会去寻找这个变量对应的被@Inject注解的构造函数，把实例构造出来，为变量提供依赖。

@Component

@Component用于标注接口，是依赖需求方（MainActivity）和依赖提供方（AAA）之间的桥梁。被Component标注的接口在编译时会生成该接口的实现类，类的名称为被@Component注解的类的名称前加上Dagger，我们通过调用这个实现类的方法来完成注入。

@Module

Module用于标注提供依赖的类。虽然我们有@Inject注解实现注入，但是@Inject只能注入构造函数为无参的类，要是构造函数是带参数的呢？那就要使用module注解来解决这个问题，又比如说，有很多的第三方库，我们对它的代码无法进行修改，也就不能对其构造函数加上@Inject注解，那么可咋办啊，@module注释可以很好的解决我们的问题。

@Provides

Provides是与Module一起使用的，@Provides用于标注Module所标注的类中的方法，该方法会在需要提供依赖时被调用，在方法内进行对象的初始化，返回对象依赖给标注了@Inject的变量。相当于一个有参数的@Inject。

我们来具体的使用一下。

构造函数无参的对象注入

用上面提到的 AAA类 进行依赖注入演示。

首先我们在 AAA类 的构造函数上加上 @Inject 注解（构造函数必须得是无参）

/**
 * @author chaochaowu
 * @Description : AAA
 * @class : AAA
 * @time Create at 6/12/2018 10:58 AM
 */

public class AAA {

 @Inject
 public AAA() {
 }

 public void get(){
  Log.e("AAA","has gotten.");
 }

}

然后创建一个 MainActivityComponent 接口并用 @Component 进行注解，然后Build一下项目，

/**
 * @author chaochaowu
 * @Description : MainActivityComponent
 * @class : MainActivityComponent
 * @time Create at 6/12/2018 11:03 AM
 */

@Component
public interface MainActivityComponent {
 void inject(MainActivity mainActivity);
}

Build之后apt会自动生成如下的代码

build后生成.png

我们利用其中的 DaggerMainActivityComponent 进行 MainActivity 与 AAA类 之间的桥梁搭建。如下代码

/**
 * @author chaochaowu
 * @Description : MainActivity
 * @class : MainActivity
 * @time Create at 6/12/2018 10:58 AM
 */
public class MainActivity extends AppCompatActivity {

 @Inject
 AAA aaa;

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

  DaggerMainActivityComponent.create().inject(this);

  aaa.get();

 }

}

至此，我们便完成了构造函数无参的对象的依赖注入。

构造函数含参的对象注入

相信很多的时候，我们要用的对象在构造的时候是需要参数的，那我们如何进行它们的依赖注入呢，这里我用 MVP 中的 Presenter 来进行演示。

/**
 * @author chaochaowu
 * @Description : MainActivity
 * @class : MainActivity
 * @time Create at 6/12/2018 10:58 AM
 */
public class MainActivity extends AppCompatActivity implements MainContract.View{

 MainContract.Presenter mPresenter;

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

  mPresenter = new MainPresenter(this);
  mPresenter.getData();

 }

}

上面的代码是没用 Dagger2 时的 Activity，在 MVP 框架中，由于 Presenter 需要与 View 进行交互，需要持有View的对象，因此在初始化的时候，需要在构造函数里传入View对象作为参数，可以看到代码中 mPresenter = new MainPresenter(this);

接下来我们对它进行依赖注入。首先看一下 Presenter,，Presenter不需要作出任何改变，我们可以看到它的构造函数带有一个参数View

/**
 * @author chaochaowu
 * @Description : MainPresenter
 * @class : MainPresenter
 * @time Create at 6/11/2018 2:22 PM
 */
public class MainPresenter implements MainContract.Presenter{
 MainContract.View mView;
 public MainPresenter(MainContract.View mView) {
  this.mView = mView;
 }

 @Override
 public void getData() {

 }
}

然后我们需要创建一个 MainActivityModule 类，并在该类名加上@Module注解，它含有一个成员变量 mView 需要在构造函数时赋值，我们之后会将这个变量给 Presenter 进行 Presenter 的构造，我们还需要写一个方法，并在其上添加@Provides注解，方法的名字其实没所谓可以随便取，但是为了代码的可读性，一般都以provide开头加上provide的东西的名字，我们在这个方法里返回我们所要提供依赖的对象，这里返回了一个 Presenter 对象，可以看到它在这里的构造，我们传入了参数 View。到这便完成了MainActivityModule 的定义，其实这个 MainActivityModule 作用就和之前的 构造函数无参中的 对无参构造函数 Inject 步骤的性质相同。

/**
 * @author chaochaowu
 * @Description : MainActivityModule
 * @class : MainActivityModule
 * @time Create at 6/11/2018 2:41 PM
 */
@Module
public class MainActivityModule {
 MainContract.View mView;

 public MainActivityModule(MainContract.View mView) {
  this.mView = mView;
 }
 @Provides
 public MainContract.Presenter providePresenter(){
  return new MainPresenter(mView);
 }
}

接下来和 构造函数无参的对象注入 中一样，我们需要定义一个 MainActivityComponent ，并用 @Component 进行注解，不一样的是需要在括号里加上参数 modules = {MainActivityModule.class} 如下代码。

/**
 * @author chaochaowu
 * @Description : MainActivityComponent
 * @class : MainActivityComponent
 * @time Create at 6/11/2018 2:45 PM
 */
@Component(modules = {MainActivityModule.class})
public interface MainActivityComponent {
 void inject(MainActivity mainActivity);
}

Build一下项目

build之后生成.png

这样我们就可以像上面一样，在Activity中调用DaggerMainActivityComponent 进行依赖注入。看一下Activity中的代码。

/**
 * @author chaochaowu
 * @Description : MainActivity
 * @class : MainActivity
 * @time Create at 6/12/2018 10:58 AM
 */
public class MainActivity extends AppCompatActivity implements MainContract.View{

 @Inject
 MainContract.Presenter mPresenter;

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

  DaggerMainActivityComponent.builder()
    .mainActivityModule(new MainActivityModule(this))
    .build()
    .inject(this);

  mPresenter.getData();

 }
}

可以看到这里 DaggerMainActivityComponent 调用的方法有所不同，其中调用了一个mainActivityModule() 方法，传入了一个 MainActivityModule 对象，该对象的初始化，我们又传入了一个this，也就是View，这个 View就是我们在之后创建 Presenter 时传入的参数 。

至此，我们就完成了构造函数有参的对象的依赖注入。其他有参的、第三方库的依赖注入也是通过这样的方式进行。

总结

Dagger2的使用，让我们代码的耦合度进一步降低了，这是一个优点，但是另一方面，使用了Dagger2你需要额外的去定义一些类，导致代码的数量也增加。个人觉得，在比较小的项目中，如果去使用，有点emmmm....多此一举？（划掉），但是如果一个项目比较大，代码本身也比较多，那么使用Dagger2所带来的优点，便可以显现了。所以说，是否在项目中使用 Dagger2 仁者见仁智者见智，不过作为一个学习的点，还是挺不错的，嗯。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。