Dagger2神器入门(四)

作者: 黑马有点白986 | 来源:发表于2017-07-11 18:04 被阅读1927次

    前序

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

    其他注解概览

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

    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写完可以写下模块化开发么 想学下:smile:
        世道无情:@小腊月 哦哦 比较期待哈:smile:
        黑马有点白986:@世道无情 最近没写了,后期会慢慢展开。
      • sweetying:楼主啥时候更新啊,去年7月份的,到现在还没更新啊?:joy:
        黑马有点白986:@妖孽那里逃 很久没更新了
      • 冉桓彬:美团面试结果咋样?
      • burro630:是我dagger2看的最明白的一篇。感谢分享!:pray:
        黑马有点白986:@burro630 客气客气,好久没更新了
      • SinFeeLoo:请问博主知道@Binds的用法吗
        黑马有点白986:@SinFeeLoo 首先抱歉回复晚了,最近较忙无法及时回复,见谅~
        @Binds是替代绑定的一种方案。使用该注解的方法必须满足以下条件
        1 抽象方法
        2 必须有单个参数
        具体可以参考官方文档。
      • developerYk:写的很好,很容易理解。感谢美女作者分享。
        johnzz:美女程序员都是聪明的那一批,哇哈哈。:stuck_out_tongue:
        黑马有点白986:@toStringy 感谢,能帮到您是我最大的幸运
      • PonyNo1:哇 美女程序员:+1:
      • 4b01863fd657:支持一下 细水长流的文字 才是好文字
        黑马有点白986:感谢支持:smiley:

      本文标题:Dagger2神器入门(四)

      本文链接:https://www.haomeiwen.com/subject/cwpyhxtx.html