Dagger2学习笔记

Dagger2学习要点理解：

Qualifier（限定符，就是解决依赖注入迷失问题的，即对获取对象的筛选或限定）;
Scope（作用域，其实只是起到提醒和管理的作用）；
Singleton（单例，Scope的特殊衍生注解，也只是起到提醒和管理的作用）;

Qualifier创建的两个不同的实例的使用举例：

@Qualifier
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface PoetryQualifier {
    String value() default "";
}

@Module
public class AModule {

    @PoetryQualifier("A")
    @AScope
    @Provides
    public Poetry getPoetry(){
        return new Poetry("万物美好");
    }

    @PoetryQualifier("B")
    @AScope
    @Provides
    public Poetry getOtherPoetry(){
        return new Poetry("我在中间");
    }
}

//在Activity中使用方式，匹配Module中同样注解的实例
@PoetryQualifier("B")
@Inject
Poetry mPoetryB;

创建类实例有2种维度：
通过用Inject注解标注的构造函数来创建（以下简称Inject维度）
通过工厂模式的Module来创建（以下简称Module维度）
并且创建类实例级别Module维度要高于Inject维度。
Scope注解，可用来限定通过Module和Inject方式创建实例的生命周期能够与目标类的生命周期相同，其实就是起到一个提醒和管理的作用。
要保证ApplicationComponent只有一个实例，要求在app的Application中实例化ApplicationComponent。而Singleton本身是没有创建单例的能力的，只不过Singleton有以下作用：
- 代码可读性，即起到提醒作用，好让程序猿更好的了解Module中创建的类实例是单例的。
- 更好的管理ApplicationComponent和Module之间的关系，保证ApplicationComponent和Module是匹配的。若ApplicationComponent和Module的Scope是不一样的，则在编译时报错。
组织Component之间的关系：
- 依赖方式
  一个Component是依赖于一个或多个Component，用dependencies属性实现；
- 包含方式
  一个Component是包含一个或多个Component的，被包含的Component还可以继续包含其他的Component，用SubComponent属性实现；
- 继承方式
  官网未提到该方式，其不是解决类实例共享的问题，而是从更好的管理、维护Component的角度，把一些Component共有的方法抽象到一个父类中，然后子Component继承。
值得注意的是：
1. 不管是依赖方式还是包含方式，都必须要有Scope的衍生注解（自定义的Scope注解）标注这些Component，并且这些注解不能一样，这样即是为了体现出Component之间的组织方式不同（如：被依赖的Component使用Singleton表示Activity的生命周期，而另一个Component则要使用其他 Scope的衍生注解来标记），其实这也是为了防止报错（我测试时报的错误是这样的：Error:(33, 12) 错误: This @Singleton component cannot depend on scoped components:@Singleton com.cxtx.chefu.app.basemvp.AppComponent）。
2. 使用包含方式时，Component中可以不写获取该对象的方法，@inject直接能从标记@Provides的方法中找到所需的对象；而在使用依赖方式时，不能只靠Module中的@Provides标识，还需要在Component中写出要获得该对象的方法，只有这样该对象才能被@inject找到，否则也会报如下错误：
```
Error:(12, 34) 错误: 找不到符号
符号:   类 DaggerAppComponent
位置: 程序包 com.cxtx.chefu.app.basemvp

Error:(45, 8) 错误: com.cxtx.chefu.app.basemvp.ServiceApi cannot be provided without an @Provides-annotated method.
com.cxtx.chefu.app.basemvp.ServiceApi is injected at
com.cxtx.chefu.app.home.enterprise_oil.manager.drivers.DriviersPresenter.<init>(serviceApi, …)
com.cxtx.chefu.app.home.enterprise_oil.manager.drivers.DriviersPresenter is injected at
com.cxtx.chefu.app.home.enterprise_oil.manager.drivers.EnterpriseDriversActivity.presenter
com.cxtx.chefu.app.home.enterprise_oil.manager.drivers.EnterpriseDriversActivity is injected at
com.cxtx.chefu.app.basemvp.ActivitiesComponent.inject(activity)

注意看这句话：Error:(45, 8) 错误: com.cxtx.chefu.app.basemvp.ServiceApi cannot be provided without an @Provides-annotated method.
```