Android Dagger2 从零单排(二) @Qualifier

  转发请注明出处：https://www.jianshu.com/p/b35a658bb1ba
  Dagger2作为Android界最具杀伤力的匕首，本系列文章将用最通俗的语言带领你揭开它的真面目。
  边缘OB：从零单排带你从低分局打到高分局，从First Blood(第一滴血)到Holy Shit(超越神的杀戮)，每盘Rampage(暴走)不在话下！
  Android Dagger2 从零单排(一) 基础注解
  Android Dagger2 从零单排(二) @Qualifier
  Android Dagger2 从零单排(三) @Scope
  Android Dagger2 从零单排(四) Dependencies与SubComponent

  在上一篇文章里面，我们介绍了Dagger2最基本的使用以及每个注解的作用，我们用上一篇留下的问题作为开篇：多个构造方法想要@Inject、多个@Provides方法返回同一数据类型，这种情况该如何注入？
  我们来介绍另外一个注解：@Qualifier
  我们称其为限定标识符，只能用于注解上。通俗点说，就是我们使用这个注解，自定义一个标识符注解来给我们所要区分的依赖打上记号，让Dagger2通过记号来获取依赖。
  例子一，没错，还是最简单的例子，还是领导视察民情，小秘上回告诉车场调度员要请个司机，隔壁老王又是车场调度员的关系户，如何才能让隔壁老王如愿以偿呢。
  我们先来定义一个标识符注解，注解类型使用@interface关键字：

@Qualifier
public @interface Sign {
}

  此时使用了@Qualifier创建了一个标识符注解@Sign，注意，不能注解在构造方法中，所以多构造方法与多个@Provides方法返回同一数据类型的处理方式是一样的，然后我们在例子中使用@Sign：

public class Bus {
    private String driver;
    public Bus() {
    }
    public Bus(String driver) {
        this.driver = driver;
    }
}

public class ParkingActivity extends Activity {
    @Sign
    @Inject
    Bus mBus;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_dagger);
        DaggerParkingComponent.create().inject(this);//DaggerParkingComponent类需要编译才会生成
        ((TextView) findViewById(R.id.text)).setText("属性注入成功 = " + mBus.toString());//重写Bus的toString()方法能看到打印出"隔壁老王"，注入成功
    }
}

@Component(modules = ParkingModule.class)
public interface ParkingComponent {
    void inject(ParkingActivity activity);
}

@Module
public class ParkingModule {
    @Provides
    public Bus provideBus() {
        return new Bus();
    }
    @Sign
    @Provides
    public Bus provideBusHasDriver() {
        return new Bus("隔壁老王");
    }
}

  在例子中可以看到，我们在要注解的属性mBus与提供依赖的方法provideBusHasDriver上各添加了一个注解@Sign，此时mBus有了标识，Dagger2只会提供对应标识的依赖，然后注入，如果把mBus的@Sign注释取消，Dagger2就会通过provideBus方法注入Bus。
  如果Bus的构造方法再加几个，此时又如何区分呢？其实，标识符也可以有自己的成员变量。(实际上是一个成员方法，说成员变量是为了方便理解)

@Qualifier
public @interface Sign {
    String value() default "";
}

  我们可以看成定义了一个String 类型的value成员变量，其默认值是空字符串，然后我们改变下@Sign的写法：

public class ParkingActivity extends Activity {
    @Sign("laoWang")
    @Inject
    Bus mBus;
    ...
}

@Module
public class ParkingModule {
    @Sign("noDriver")
    @Provides
    public Bus provideBus() {
        return new Bus();
    }
    @Sign("laoWang")
    @Provides
    public Bus provideBusHasDriver() {
        return new Bus("隔壁老王");
    }
}

  因为注入的mBus有@Sign("laoWang")标识，Dagger2只会选择老王为司机的车注入，哪天不想要老王了，只需要改变@Sign里面的字符串即可马上把老王踢了。
  对于这个成员变量，我有话要说：
  1.咋一看有没有纠结为什么要写成value？其实你想写啥就写啥，不过，使用value有个好处就是可以不用写属性名直接指定值，例如把value改成driver：

@Qualifier
public @interface Sign {
    String driver() default "";
}

@Sign(driver = "laoWang")

  2.能不能不设置默认值？能！每次使用的时候请为其指定值，否则报错，设置了默认值之后，使用时注解不指定值时，使用的是默认值。
  3.能加参数么？不能！只能以无形参的方法形式来声明。
  4.能不能有多个成员变量？能！多个成员变量并非要全部使用：

@Qualifier
public @interface Sign {
    String value() default "";
    String value2() default "";
}

@Sign("laoWang")//此时只使用了默认的value一个属性
@Sign(value2 = "laoLi")//此时只使用了value2一个属性
@Sign(value = "laoWang", value2 = "laoWang")//此时只使用了两个属性

  5.数据类型有没有要求？有！只能是基本数据类型、String、Enum、Class，包含其一维数组类型。
  例子二，其他情况的应用。
  (1)方法注入的应用：

    @Inject
    public void injectBus(@Sign("laoWang") Bus bus) {
        mBus = bus;
    }

  此时@Sign不能注解在方法上，必须注解在对应的注入参数中。
  (2)@Provides方法依赖关系的应用：

    @Sign("laoWang")
    @Provides
    public Bus provideBusHasDriver(@Sign("lw") String driver) {
        return new Bus(driver);
    }

    @Sign("lw")
    @Provides
    public String provideDriverW() {
        return "隔壁老王";
    }

  总结：
  标识符具有对应性，在需要依赖注入的地方有标识，则在提供依赖的地方也一定要有，否则报错。(不要跟我说，可以在提供的依赖注解标识，但是需要依赖注入的地方不注解标识，你看明明也正确，但对应不上！......我会打你的！)
  标识符的值具有唯一性，其实正确来说只能是相对唯一性，例子一中ParkingModule的提供Bus依赖的@Provides方法，@Sign都必须是唯一的，存在相同的情况则编译报错(除非你写了两个相同的@Sign提供依赖，但压根都没用到，这时候编译也不会报错也能运行，Dagger2机制不使用的自然不会监测！......但是我还是会打你的！)，而依赖注入的地方则不受限制。另外这个唯一性，只是对同一返回类型。例如在例子二@Provides方法依赖关系的应用中，我们把@Sign("lw")同样也写成@Sign("laoWang")，是完全没问题的。

  最后我想说，有一个现成的限定标识符是可以直接使用的：@Named

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

  比起我们的例子，多了两个注解@Documented和@Retention(RUNTIME)。
  @Documented官方解释是文档化，如果一个类型的声明是用Documented来注解的，则其注解将成为注解元素的公共API的一部分，其实没有什么卵用，加不加都可以。
  @Retention(RetentionPolicy.RUNTIME)这个注解到现在我还没研究出来到底要不要加，加的话给什么属性，我用上面的例子仔细的研究了Dagger2编译过后生成的所有类(这些原理后面会有介绍)，发现没有任何关于@Sign的生成类或者注释说明，为此我大胆猜测，@Qualifier标识符注解其实是在编译期间有用，是作为指引依赖之间的关联而存在的，运行时依赖注入与被依赖注入间的关系已经由Dagger2生成的类定义好，所以我觉得这个@Retention添加不添加没啥区别，不添加的情况，其默认是RetentionPolicy.CLASS，如果有误的话，欢迎留言指正。

  Demo源码截我 对应daggerTwo包名
  Dagger2 GitHub地址
  Dagger2 官网地址
  所有的测试实例均基于2.15版本。
  下一篇，我们来研究作用域：@Scope注解。