【Android】初识Dagger2--小白学习笔记
本文是自己的Dagger2学习总结，可能有很多误解和偏差，欢迎交流指正~
什么是Dagger2？
简单来说，Dagger2是一个通过注解的方式来实现依赖注入的框架。注解大家肯定都见过，我们常用的ButterKnife就是通过注解的方式来避免繁琐的findView,同时google释放的源码中也有诸多注解（@hide,@override,@param等等）。至于依赖注入，就是就是一种减少类与类之间耦合的手段。总结一下就是避免在一个类中直接new另一个类的实例，因为当另一个类因为业务调整需要修改时，其他类就可以避免做相应修改，减少代码的耦合程度和维护成本。语言表达能力有限，直接看code：
public class Zoo {
Lion lion;
Tiger tiger;
public Zoo() {
lion = new Lion();
tiger = new Tiger();
}
public String showPerformance(){
return lion.perform()+" "+tiger.perform();
}
}
public class Lion {
public Lion() {
}
public String perform(){
return "跳火圈";
}
}
public class Tiger {
public Tiger() {
}
public String perform(){
return "舞蹈";
}
}
我们花巨资新建了一个动物园，现在动物园里每周末会有狮子和老虎的节目表演，经过一段时间后，为了让动物更方便与游客互动，决定给动物起名字。所以我们的Lion、Tiger类需要做如下修改：
public class Lion {
String name;
public Lion(String name) {
this.name=name;
}
public String perform(){
return name+"跳火圈";
}
}
public class Tiger {
String name;
public Tiger(String name) {
this.name = name;
}
public String perform(){
return name+"舞蹈";
}
}
给动物起完名字之后，突然发现动物园的结构（构造方法）
public Zoo() {
lion = new Lion();
tiger = new Tiger();
}
也需要做修改，修改成
public Zoo() {
lion = new Lion("blink");
tiger = new Tiger("dagger");
}
这也就相当于我们给动物起了个名字，居然影响到了动物园，需要请工人重新设计装修动物园，这显然是不合理的。所以为了解除动物园与动物之间的耦合，我们需要做如下修改：
public class Zoo {
Lion lion;
Tiger tiger;
public Zoo(Lion lion,Tiger tiger) {
this.lion = lion;
this.tiger = tiger;
}
public String showPerformance(){
return lion.perform()+" "+tiger.perform();
}
}
我们将lion与tiger的赋值工作直接交给了构造函数的参数，同理我们也可以使用set方式，甚至通过为Lion、Tiger添加get方法来为zoo中的lion、tiger赋值，这样无论动物怎么换名字，都与我们的zoo结构无关，你只需要关心传入什么参数。
至此，对什么是依赖注入应该有了一个大体的理解。
简单使用Dagger2
使用前先为我们的as添加如下依赖配置：
Project级的gradle中添加
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'
Module级的gradle中添加
apply plugin: 'com.neenbedankt.android-apt'
apt 'com.google.dagger:dagger-compiler:2.0'
compile 'com.google.dagger:dagger:2.0'
provided 'javax.annotation:javax.annotation-api:1.2'
上面说了Dagger是一个通过注解的方式来实现依赖注入的框架，所以想要它为我们实现依赖注入，我们要先了解几个简单的注解。
-
1.@Inject
-
2.@Module
-
3.@Provides
-
4.@Component
老规矩先大体说下上述每个注解的作用，接着直接show code!
-
@Inject 注解在某个具体的变量上，表示该变量需要Dagger2帮我们来实例化；注解在某个类的构造方法上，表示我们在需要该实例的时候，Dagger2框架会自动寻找到标注有@Inject注解的构造，并将其实例化提供给我们
-
@Module @Module专门用来管理向外界提供依赖的类，@Module可以给不能修改源码的类提供依赖，需要与@Provides配合使用。
-
@Provides 在@Module注解的类中，我们通过@Provides注解可以向外界提供依赖注入的对象。
-
@Component 连接依赖方和提供依赖方之间的匕首，当我们定义好了依赖方和提供依赖方之后，还需要通过@Component注解作为一种媒介，使得Dagger2框架能正常工作。
先看下@Inject的使用：
先用@Inject标注构造方法
public class Doggie {
@Inject
public Doggie() {
}
public String yelp(){
return "汪汪汪";
}
}
public class Cat {
@Inject
public Cat() {
}
public String yelp(){
return "喵喵喵";
}
}
接着直接在MainActivity中标注相关变量，看能不能获取到实例
@Inject
Doggie doggie;
@Inject
Cat cat;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Log.d(TAG,"doggie :"+doggie.yelp());
Log.d(TAG,"cat :"+cat.yelp());
}
run一下试试~直接nullpoint崩了，少了最重要的"插入匕首"的那步！那就要通过@Component自己锻一把注入的匕首：
@Component
public interface DaggerComponent {
void inject(MainActivity mainActivity);
}
要手动rebuild一哈，as才会帮我自动编译生成DaggerComponent类，从而才能接着完成注入。
DaggerDaggerComponent.create().inject(this);
看一下运行Log:
01-01 16:00:22.449 21066-21066/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-01 16:00:22.449 21066-21066/com.blink.lucky.dagger2 D/blink: cat :喵喵喵
@Module && @Provides完成依赖注入：
首先要创建一个专门向外界提供依赖对象的Module类
@Module
public class MyModule {
@Provides
public Doggie providerDoggie(){
Log.d("blink","doggie created by module");
return new Doggie();
}
@Provides
public Cat providerCat(){
Log.d("blink","cat created by module");
return new Cat();
}
}
接着要修改下我们的Component类，通过添加（modules = MyModule.class）属性，让Dagger2从MyModule类中获取提供的依赖对象。
@Component (modules = MyModule.class)
public interface DaggerComponent {
void inject(MainActivity mainActivity);
}
运行Log
01-01 16:30:34.071 8309-8309/com.blink.lucky.dagger2 D/blink: doggie created by module
01-01 16:30:34.072 8309-8309/com.blink.lucky.dagger2 D/blink: cat created by module
01-01 16:30:34.073 8309-8309/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-01 16:30:34.073 8309-8309/com.blink.lucky.dagger2 D/blink: cat :喵喵喵
通过分析log我们也能得出一个很重要的规则，注解了@Inject的对象，会优先寻找@Module类中是否有@Provides返回对应类型的对象，次优先寻找@Inject注解的构造方法为我们提供所依赖的对象。
上面是最简单的单重依赖，接下来我们看下多重依赖（比如说Doggie类里又依赖其他类）的话要怎么修改代码：
我们为Doggie添加一个Kind的依赖类，来表示他是什么类型的小狗，需要注意不能直接new DogKind,我们把它注入进构造函数：
public class Doggie {
DogKind dogKind;
@Inject
public Doggie(DogKind dogKind) {
this.dogKind = dogKind;
}
public String yelp(){
return "汪汪汪";
}
}
public class DogKind {
public DogKind(String kind) {
Log.d("blink","我是"+kind);
}
}
一定要在Module类中向外提供DogKind：
@Provides
public DogKind providerDogkind() {
return new DogKind("柴犬");
}
最后Inject后，直接看log结果：
01-02 10:05:54.768 3255-3255/com.blink.lucky.dagger2 D/blink: 我是柴犬
01-02 10:05:54.768 3255-3255/com.blink.lucky.dagger2 D/blink: doggie created by module
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: cat created by module
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: cat :喵喵喵
到这里，双重依赖的原理也就显而易见了，就是不断依赖注入，然后通过Dagger框架帮我们去解析@Provides 或 @Inject注解，为我们实例化对象。
Dagger2进阶
- @Qulifier和@Scope
@Qulifier表示限定注解，当我们的Module类中，有多个相同返回类型的方法时，Dagger2自然无法分辨需要通过哪个@Provides来提供依赖变量（Dagger2会根据Module中标记了@Provide的方法的返回值来确定由谁为这个变量提供实例），这时候@Qulifier就能登场了。我们通过@Qulifier自定义一个注解，来手动地为Dagger2框架指明，当返回类型相同时，通过哪个@Provides来提供依赖变量。
首先定义一个注解：
@Qualifier//限定符
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomType {
String value() default "";//默认值为""
}
接着在Module中，通过为@CustomType注解写入不同的value，来为Dagger2指明方向：
@Provides
@CustomType
public Doggie providerUnnamedDoggie () {
return new Doggie();
}
@Provides
@CustomType ("name")
public Doggie providerNamedDoggie () {
return new Doggie("嘻嘻");
}
最后，就能愉快地使用了~：
@CustomType
Doggie doggie;
@Inject
@CustomType ("name")
Doggie doggie2;
贴一下log,发现确实根据不同限定符为我们实例化了两条小狗：
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: 我是一条小狗~
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: 我是一条叫嘻嘻的小狗~
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: doggie2 :汪汪汪
@Scope
Dagger2通过@Scope注解来实现局部单例，当我们需要同一类变量时，@Scope让依赖方向我们提供同一个单例，栗子：
同样，先定义一个注解
@Scope
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomScope {
}
接着在Moudle类中，我们需要Dagger2为我们提供同一只小猫，所以在providerCat()方法上添加@CustomScope注解
@Provides
@CustomScope
public Cat providerCat(){
Log.d("blink","cat created by module");
return new Cat();
}
另外有一点需要注意，因为@Scope是局部的单例注解，即仅在Component的生命周期内提供单例，所以我们需要在Component 接口中做一下修改：
@CustomScope
@Component (modules = MyModule.class)
public interface DaggerComponent {
void inject(MainActivity mainActivity);
}
使用（Cat使用了@Scope注解，Doggie未使用）：
@Inject
Cat cat;
@Inject
Cat cat2;
@Inject
Doggie doggie_1;
@Inject
Doggie doggie_2;
Log.d("blink","cat ?= cat 2 "+ (cat==cat2));
Log.d("blink","doggie_1 ?= doggie_2 "+ (doggie_1==doggie_2));
运行后的log如下
01-02 15:53:23.014 25597-25597/com.blink.lucky.dagger2 D/blink: cat ?= cat 2 true
01-02 15:53:23.014 25597-25597/com.blink.lucky.dagger2 D/blink: doggie_1 ?= doggie_2 false
这里再额外补充下Component的生命周期：
DaggerDaggerComponent.create().inject(this);
其实这句话就展示了Component的所有生命周期，
DaggerDaggerComponent.create() -- 创建
.inject(this); -- 注入，可以理解为状态活跃中
最后当onCreate()结束后 -- 我们的Component也一并被销毁了，周期结束
我们可以这样验证下：
Cat tmpCat;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
DaggerDaggerComponent.create().inject(this);
Log.d("blink","cat ?= cat 2 "+ (cat==cat2));
tmpCat = cat;
Log.d("blink","doggie_1 ?= doggie_2 "+ (doggie_1==doggie_2));
//Log.d(TAG,"doggie :"+doggie.yelp());
//Log.d(TAG,"doggie2 :"+doggie2.yelp());
//Log.d(TAG,"cat :"+cat.yelp());
}
@Override
protected void onResume() {
super.onResume();
DaggerDaggerComponent.create().inject(this);
Log.d("blink","tmpCat:"+tmpCat.yelp());
Log.d("blink","tmpCat ?= cat 2 "+ (tmpCat==cat2));
}
01-02 16:35:54.652 2717-2717/com.blink.lucky.dagger2 D/blink: tmpCat:喵喵喵
01-02 16:33:50.294 31204-31204/com.blink.lucky.dagger2 D/blink: tmpCat ?= cat 2 false
通过上述Log我们可以发现，在onResume时候，上一个Component的周期显然结束了，所以此时onResume的两个cat虽然是单例的，但是与onCreate中的单例cat是两个不同的对象！
@Singleton
有局部单例肯定也会有全局单例，这就是@Singleton的作用了。使用方法和@Scope完全一致：首先通过@Singleton自定义一个注解，接着在Moudle类中，通过自定义的@Singleton注解标记相关Provides方法，最后在Component匕首接口中添加@Singleton描述，使用后，就能得到全局单例的变量了！这里就不添重复代码了。
