【Android】初识Dagger2--小白学习笔记

本文是自己的Dagger2学习总结,可能有很多误解和偏差,欢迎交流指正~

什么是Dagger2?

简单来说,Dagger2是一个通过注解的方式来实现依赖注入的框架。注解大家肯定都见过,我们常用的ButterKnife就是通过注解的方式来避免繁琐的findView,同时google释放的源码中也有诸多注解(@hide,@override,@param等等)。至于依赖注入,就是就是一种减少类与类之间耦合的手段。总结一下就是避免在一个类中直接new另一个类的实例,因为当另一个类因为业务调整需要修改时,其他类就可以避免做相应修改,减少代码的耦合程度和维护成本。语言表达能力有限,直接看code:

public class Zoo {
    Lion lion;
    Tiger tiger;

    public Zoo() {
        lion = new Lion();
        tiger = new Tiger();
    }

    public String showPerformance(){

        return lion.perform()+"  "+tiger.perform();
    }
}
public class Lion {

    public Lion() {
    }

    public String perform(){
        return "跳火圈";
    }
}
public class Tiger {

    public Tiger() {
    }

    public String perform(){
        return "舞蹈";
    }
}

我们花巨资新建了一个动物园,现在动物园里每周末会有狮子和老虎的节目表演,经过一段时间后,为了让动物更方便与游客互动,决定给动物起名字。所以我们的Lion、Tiger类需要做如下修改:

public class Lion {

    String name;

    public Lion(String name) {
        this.name=name;
    }

    public String perform(){
        return name+"跳火圈";
    }
}
public class Tiger {
    String name;

    public Tiger(String name) {
        this.name = name;
    }

    public String perform(){
        return name+"舞蹈";
    }
}

给动物起完名字之后,突然发现动物园的结构(构造方法)

    public Zoo() {
        lion = new Lion();
        tiger = new Tiger();
    }

也需要做修改,修改成

    public Zoo() {
        lion = new Lion("blink");
        tiger = new Tiger("dagger");
    }

这也就相当于我们给动物起了个名字,居然影响到了动物园,需要请工人重新设计装修动物园,这显然是不合理的。所以为了解除动物园与动物之间的耦合,我们需要做如下修改:

public class Zoo {
    Lion lion;
    Tiger tiger;

    public Zoo(Lion lion,Tiger tiger) {
        this.lion = lion;
        this.tiger = tiger;
    }

    public String showPerformance(){

        return lion.perform()+"  "+tiger.perform();
    }
}

我们将lion与tiger的赋值工作直接交给了构造函数的参数,同理我们也可以使用set方式,甚至通过为Lion、Tiger添加get方法来为zoo中的lion、tiger赋值,这样无论动物怎么换名字,都与我们的zoo结构无关,你只需要关心传入什么参数。
至此,对什么是依赖注入应该有了一个大体的理解。

简单使用Dagger2

使用前先为我们的as添加如下依赖配置:

Project级的gradle中添加

    classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'

Module级的gradle中添加

    apply plugin: 'com.neenbedankt.android-apt'
    apt 'com.google.dagger:dagger-compiler:2.0'
    compile 'com.google.dagger:dagger:2.0'
    provided 'javax.annotation:javax.annotation-api:1.2'

上面说了Dagger是一个通过注解的方式来实现依赖注入的框架,所以想要它为我们实现依赖注入,我们要先了解几个简单的注解。

  • 1.@Inject

  • 2.@Module

  • 3.@Provides

  • 4.@Component

老规矩先大体说下上述每个注解的作用,接着直接show code!

  • @Inject 注解在某个具体的变量上,表示该变量需要Dagger2帮我们来实例化;注解在某个类的构造方法上,表示我们在需要该实例的时候,Dagger2框架会自动寻找到标注有@Inject注解的构造,并将其实例化提供给我们

  • @Module @Module专门用来管理向外界提供依赖的类,@Module可以给不能修改源码的类提供依赖,需要与@Provides配合使用。

  • @Provides 在@Module注解的类中,我们通过@Provides注解可以向外界提供依赖注入的对象。

  • @Component 连接依赖方和提供依赖方之间的匕首,当我们定义好了依赖方和提供依赖方之后,还需要通过@Component注解作为一种媒介,使得Dagger2框架能正常工作。

先看下@Inject的使用:

先用@Inject标注构造方法

public class Doggie {

    @Inject
    public Doggie() {
    }

    public String yelp(){
        return "汪汪汪";
    }
}
public class Cat {

    @Inject
    public Cat() {
    }

    public String yelp(){
        return "喵喵喵";
    }
}

接着直接在MainActivity中标注相关变量,看能不能获取到实例

    @Inject
    Doggie doggie;
    @Inject
    Cat cat;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Log.d(TAG,"doggie :"+doggie.yelp());
        Log.d(TAG,"cat :"+cat.yelp());
    }

run一下试试~直接nullpoint崩了,少了最重要的"插入匕首"的那步!那就要通过@Component自己锻一把注入的匕首:

  @Component
  public interface DaggerComponent {
      void inject(MainActivity mainActivity);
  }

要手动rebuild一哈,as才会帮我自动编译生成DaggerComponent类,从而才能接着完成注入。

   DaggerDaggerComponent.create().inject(this);

看一下运行Log:

01-01 16:00:22.449 21066-21066/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-01 16:00:22.449 21066-21066/com.blink.lucky.dagger2 D/blink: cat :喵喵喵

@Module && @Provides完成依赖注入:

首先要创建一个专门向外界提供依赖对象的Module类

@Module
public class MyModule {

    @Provides
    public Doggie providerDoggie(){
        Log.d("blink","doggie created by module");
        return new Doggie();
    }

    @Provides
    public Cat providerCat(){
        Log.d("blink","cat created by module");
        return new Cat();
    }
}

接着要修改下我们的Component类,通过添加(modules = MyModule.class)属性,让Dagger2从MyModule类中获取提供的依赖对象。

@Component (modules = MyModule.class)
public interface DaggerComponent {
    void inject(MainActivity mainActivity);
}

运行Log

01-01 16:30:34.071 8309-8309/com.blink.lucky.dagger2 D/blink: doggie created by module
01-01 16:30:34.072 8309-8309/com.blink.lucky.dagger2 D/blink: cat created by module
01-01 16:30:34.073 8309-8309/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-01 16:30:34.073 8309-8309/com.blink.lucky.dagger2 D/blink: cat :喵喵喵

通过分析log我们也能得出一个很重要的规则,注解了@Inject的对象,会优先寻找@Module类中是否有@Provides返回对应类型的对象,次优先寻找@Inject注解的构造方法为我们提供所依赖的对象。

上面是最简单的单重依赖,接下来我们看下多重依赖(比如说Doggie类里又依赖其他类)的话要怎么修改代码:

我们为Doggie添加一个Kind的依赖类,来表示他是什么类型的小狗,需要注意不能直接new DogKind,我们把它注入进构造函数:

public class Doggie {

    DogKind dogKind;
    @Inject
    public Doggie(DogKind dogKind) {
        this.dogKind = dogKind;
    }

    public String yelp(){
        return "汪汪汪";
    }
}
public class DogKind {

    public DogKind(String kind) {
        Log.d("blink","我是"+kind);
    }

}

一定要在Module类中向外提供DogKind:

    @Provides
    public DogKind providerDogkind() {
        return new DogKind("柴犬");
    }

最后Inject后,直接看log结果:

01-02 10:05:54.768 3255-3255/com.blink.lucky.dagger2 D/blink: 我是柴犬
01-02 10:05:54.768 3255-3255/com.blink.lucky.dagger2 D/blink: doggie created by module
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: cat created by module
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-02 10:05:54.769 3255-3255/com.blink.lucky.dagger2 D/blink: cat :喵喵喵

到这里,双重依赖的原理也就显而易见了,就是不断依赖注入,然后通过Dagger框架帮我们去解析@Provides 或 @Inject注解,为我们实例化对象。

Dagger2进阶
  • @Qulifier和@Scope

@Qulifier表示限定注解,当我们的Module类中,有多个相同返回类型的方法时,Dagger2自然无法分辨需要通过哪个@Provides来提供依赖变量(Dagger2会根据Module中标记了@Provide的方法的返回值来确定由谁为这个变量提供实例),这时候@Qulifier就能登场了。我们通过@Qulifier自定义一个注解,来手动地为Dagger2框架指明,当返回类型相同时,通过哪个@Provides来提供依赖变量。

首先定义一个注解:

@Qualifier//限定符
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomType {
    String value() default "";//默认值为""
}

接着在Module中,通过为@CustomType注解写入不同的value,来为Dagger2指明方向:

    @Provides
    @CustomType
    public Doggie providerUnnamedDoggie () {
        return new Doggie();
    }

    @Provides
    @CustomType ("name")
    public Doggie providerNamedDoggie () {
        return new Doggie("嘻嘻");
    }

最后,就能愉快地使用了~:

    @CustomType
    Doggie doggie;

    @Inject
    @CustomType ("name")
    Doggie doggie2;

贴一下log,发现确实根据不同限定符为我们实例化了两条小狗:

01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: 我是一条小狗~
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: 我是一条叫嘻嘻的小狗~
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: doggie :汪汪汪
01-02 13:51:51.105 7148-7148/com.blink.lucky.dagger2 D/blink: doggie2 :汪汪汪

@Scope
Dagger2通过@Scope注解来实现局部单例,当我们需要同一类变量时,@Scope让依赖方向我们提供同一个单例,栗子:

同样,先定义一个注解

@Scope
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomScope {
}

接着在Moudle类中,我们需要Dagger2为我们提供同一只小猫,所以在providerCat()方法上添加@CustomScope注解

    @Provides
    @CustomScope
    public Cat providerCat(){
        Log.d("blink","cat created by module");
        return new Cat();
    }

另外有一点需要注意,因为@Scope是局部的单例注解,即仅在Component的生命周期内提供单例,所以我们需要在Component 接口中做一下修改:

@CustomScope
@Component (modules = MyModule.class)
public interface DaggerComponent {
    void inject(MainActivity mainActivity);
}

使用(Cat使用了@Scope注解,Doggie未使用):

    @Inject
    Cat cat;
    @Inject
    Cat cat2;

    @Inject
    Doggie doggie_1;
    @Inject
    Doggie doggie_2;

    Log.d("blink","cat ?=  cat 2 "+ (cat==cat2));
    Log.d("blink","doggie_1 ?=  doggie_2 "+ (doggie_1==doggie_2));

运行后的log如下

01-02 15:53:23.014 25597-25597/com.blink.lucky.dagger2 D/blink: cat ?=  cat 2 true
01-02 15:53:23.014 25597-25597/com.blink.lucky.dagger2 D/blink: doggie_1 ?=  doggie_2 false

这里再额外补充下Component的生命周期:

DaggerDaggerComponent.create().inject(this);

其实这句话就展示了Component的所有生命周期,
DaggerDaggerComponent.create() -- 创建

.inject(this); -- 注入,可以理解为状态活跃中

最后当onCreate()结束后 -- 我们的Component也一并被销毁了,周期结束

我们可以这样验证下:

    Cat tmpCat;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        DaggerDaggerComponent.create().inject(this);
        Log.d("blink","cat ?=  cat 2 "+ (cat==cat2));
        tmpCat = cat;
        Log.d("blink","doggie_1 ?=  doggie_2 "+ (doggie_1==doggie_2));
        //Log.d(TAG,"doggie :"+doggie.yelp());
        //Log.d(TAG,"doggie2 :"+doggie2.yelp());
        //Log.d(TAG,"cat :"+cat.yelp());
    }

    @Override
    protected void onResume() {
        super.onResume();
        DaggerDaggerComponent.create().inject(this);
        Log.d("blink","tmpCat:"+tmpCat.yelp());
        Log.d("blink","tmpCat ?=  cat 2 "+ (tmpCat==cat2));
    }
01-02 16:35:54.652 2717-2717/com.blink.lucky.dagger2 D/blink: tmpCat:喵喵喵
01-02 16:33:50.294 31204-31204/com.blink.lucky.dagger2 D/blink: tmpCat ?=  cat 2 false

通过上述Log我们可以发现,在onResume时候,上一个Component的周期显然结束了,所以此时onResume的两个cat虽然是单例的,但是与onCreate中的单例cat是两个不同的对象!

@Singleton
有局部单例肯定也会有全局单例,这就是@Singleton的作用了。使用方法和@Scope完全一致:首先通过@Singleton自定义一个注解,接着在Moudle类中,通过自定义的@Singleton注解标记相关Provides方法,最后在Component匕首接口中添加@Singleton描述,使用后,就能得到全局单例的变量了!这里就不添重复代码了。

Over~~

你可能感兴趣的:(【Android】初识Dagger2--小白学习笔记)