Dagger2 @Qualifier

本文阅读需要五分钟
本文阅读需要Dagger2简单使用的基础
@Qualifier 英文含义限定词，它的作用和函数的重载很像。它告诉Dagger依赖需求方 创建数据的时候使用哪个依赖提供方。
我们将用一个例子说明
比如Theme包含一个themeName

public class Theme {
    String themeName;

    public Theme(String themeName) {
        this.themeName = themeName;
    }
}

我们需要提供两个Theme，provideDayTheme和provideNightTheme

@Module
public class ThemeModule {
    @Provides
    @ThemeDay
    Theme provideDayTheme() {
        return new Theme("day");
    }

    @Provides
    @ThemeNight
    Theme provideNightTheme() {
        return new Theme("night");
    }
}

我们在使用注入的时候

 @Inject 
 Theme theme;

Dagger是用provideDayTheme帮我们创建还是使用provideNightTheme呢？这明显是一个困局。
@Qualifier就是帮我们解决这个困局。
自定义一个ThemeNight 的注解

@Qualifier
public @interface ThemeNight {

}

自定义一个ThemeDay 的注解

@Qualifier
public @interface ThemeDay {
}

注意这里以前没有接触过注解的同学，可能会有些迷糊，我们之前用的注解都是在类，方法，属性上用的。这次我们的@Qualifier是用来给注解做注解的。对的没错，这个是@Qualifier就是用来自定义注解的。它的作用就是让你自定义的注解可以完成依赖需求方 知道数据是哪个依赖提供方提供的。

public class ThemeTest {
    @Inject
    @ThemeDay
    Theme dayTheme;
    @Inject
    @ThemeNight
    Theme nightTheme;

    public static void main(String[] arg) {
        ThemeTest themeTest = new ThemeTest();
        DaggerThemeComponent.create().inject(themeTest);
        System.out.println(themeTest.dayTheme.themeName);
        System.out.println(themeTest.nightTheme.themeName);
    }
}

在我们使用@Inject去注入 Theme dayTheme;又加了一个@ThemeDay的限定，Dagger就从ThemeModule 中去找是哪个@Provides提供者也加了@ThemeDay的限定。
我们上篇文章写过
@Module
Dagger2是怎么选择依赖提供的呢，规则是这样的：

步骤1：查找Module中是否存在创建该类的方法。
步骤2：若存在创建类方法，查看该方法是否存在参数
步骤2.1：若存在参数，则按从步骤1开始依次初始化每个参数
步骤2.2：若不存在参数，则直接初始化该类实例，一次依赖注入到此结束
步骤3：若不存在创建类方法，则查找@Inject注解的构造函数，看构造函数是否存在参数
步骤3.1：若存在参数，则从步骤1开始依次初始化每个参数
步骤3.2：若不存在参数，则直接初始化该类实例，一次依赖注入到此结束

这里就解释了为什么Dagger2使用注入对象的时候为什么先从Module的@Provides中找，然后再@Inject注解的构造函数，这个加载顺序更加符合开发者对构造新对象的需求顺序。