Dagger2神器入门(四)

前序

Dagger2神器入门(一)
Dagger2神器入门(二)
Dagger2神器入门(三)
在上面的一系列文章中,我们了解了
1)什么是依赖注入?
2)如何使用Dagger2进行依赖注入?
3)为什么要使用Dagger2?
......如果没有弄清楚这些问题,可以翻看之前的blog。那么这一章主要是来看看依赖注入的其他注解。

其他注解概览

我们经常使用的@Inject其实是在javax.inject注解包中,而我们的@Component,@Module和@Provides注解都在dagger2的包中。这一章节我们主要来看看javax.inject中的其他未使用的注解。
首先先上一个包的截图:

Dagger2神器入门(四)_第1张图片
javax-inject.jpeg

如图:除了我们经常使用的@Inject注解之外,还有诸如@Named,@Qualifier等其他注解。下面,我们通过例子来了解一下@Named,@Qualifier注解是如何使用?

@Qualifier

我们在上一节中了解到,@Inject只能作用于一个构造器;

@Inject  can apply to at most one constructor per class。

如果一个类有很多构造器,而我们想使用他们,而不是仅仅一个,该如何做呢?那么接下来我们就接着上面的例子:

public class Leather {
  public Leather(){
      Log.d(Config.TAG,"new Leather()");
  }

  public Leather(String color){
      Log.d(Config.TAG,"new Leather() color:"+color);
    }
 }

如上面代码,我们的Leather有2个构造器,一个是默认无参构造器,一个是带参数构造器;那么我们如何在@Inject的时候去选择性的使用其中的任何一个构造器呢?

我们知道,所有的依赖提供都来自于CarModule类,那么我们就要在Module类中做文章;在此之前我们首先要了解下@Qualifier注解是什么?如何使用?最后才通过demo去看看效果。

官方@Qualifier是一个修饰器,这样说肯定也很懵逼,我们还是通过大家熟悉的代码来展现吧。我们一般按照下面方式使用依赖注入

@Inject
Leather leather;

这样的注解就能达到自动初始化的目的,然而这只能在一个类中初始化一个构造器;那么我们现在加上@Qualifier注解,来修饰一下,这样就能达到一个类存在多个构造器时,通过修饰器来限定初始化哪个类。与其说是修饰器,不如说是限定符。如果这样解释还是不明白,那我们来看一个demo。

首先我们自定义一个注解

@Qualifier  
@Documented  
@Retention(RetentionPolicy.RUNTIME)
public @interface LeatherColor {
    String color() default "white";
}

我们使用@Qualifier来修饰注解。

另话:其实关于注解这块内容还是有很多可讲的,包括如何自定义注解,注解的工作机制等等,希望后期有时间能够慢慢输出,毕竟是一字一字码出来的,而不是随便网上copy。

上面我们自定义一个注解@LeatherColor,如何使用呢?在需要使用Leather的地方通过@Inject注入,我们现在是在Car类中

 @LeatherColor(color = "black")
 @Inject
 Leather leather;

就是这么简单,自定义完之后在你需要@Inject的地方添加限定即可。那这么做就完了?肯定不是的,我们还需要在我们提供依赖的地方做下改动

  @Provides
  public Leather provideLeather(){
      return new Leather();
  }
 @LeatherColor(color = "black")
 @Provides
 public Leather provideIntLeather()  {
    return new Leather("black");
  }

这样,在遇到(color = "black")的时候,就会初始化类 new Leather("black"),看看运行效果?

07-07 10:07:49.208 9160-9160/? D/TAG: new Leather() color:black
07-07 10:07:49.208 9160-9160/? D/TAG: new Engine()
07-07 10:07:49.209 9160-9160/? D/TAG: new Seat()
07-07 10:07:49.209 9160-9160/? D/TAG: new Wheel()
07-07 10:07:49.209 9160-9160/? D/TAG: new Car()

总结一下上面使用步骤:
1 首先使用@Qualifier自定义注解,在这个例子中我们自定义的是@LeatherColor
2 然后在@Inject的地方添加自定义注解限制;如 @LeatherColor(color="black")
3 最后在提供依赖的Module类中添加相关依赖限制;在这个例子中,如果我们@Inject注解带有@LeatherColor并且它的color="black",就会执行
new Leather("black"),否则就会执行默认provides。

到这里我们基本了解了@Qualifier注解的基本使用,那么接下来我们看看@Named注解;

@Named

如果了解了@Qualifier注解之后,那么对于这个注解,就很轻松了。直接上源码

@Qualifier
@Documented
@Retention(RUNTIME)
public @interface Named {
    /** The name. */
    String value() default "";
}

可以看出,这个注解和我们自定义的注解一样?不过还是有区别的。简单说下
@Named 是基于@Qualifier的注解,不过只能传递字符串
@Qualifier 包括但不限于字符串,如枚举等。
他们的功能是一样的,在这里就不举例说明了。

总结

通过上面的demo,不知道各位是不是发现了一个Dagger2的局限性?具体是什么局限呢?在这里先不说明白,在下一章的时候会和大家讨论讨论。期待吧......

你可能感兴趣的:(Dagger2神器入门(四))