美文网首页
史上最适合新手的Dagger2教程(三)模型与单例

史上最适合新手的Dagger2教程(三)模型与单例

作者: Eternity岚 | 来源:发表于2018-07-27 09:15 被阅读0次

    Dagger2系列教程目录:

    史上最适合新手的Dagger2教程(一)基本注入

    史上最适合新手的Dagger2教程(二)对象注入

    史上最适合新手的Dagger2教程(三)模型与单例

    史上最适合新手的Dagger2教程(四)带参注入

    史上最适合新手的Dagger2教程(五)命名、限定与延时加载

    上节课的代码中,我们遇到一个问题:使用@Inject注入每次都会new一个无参的新对象。

    而在需要使用某一对象,或是单例的情况下,这个注入方式显然是不可取的。

    本节课就来讲解Dagger2如何以单例模式注入对象。

    我们拿大名鼎鼎的OkHttp3为例,它的构建方法是这样的:

    OkHttpClient okHttpClient = new OkHttpClient();
    

    记得添加网络权限:

    <uses-permission android:name="android.permission.INTERNET"/>
    

    用过OKHttp的都知道,这个实例在整个APP运行过程中只要使用一个,多了会造成严重的性能损耗和大量的GC。

    然而,OkHttp的代码不是自己写的,不能直接修改其源码,因此肯定没办法像以往的注入方式一样直接在构建方法上使用@Inject。

    这个时候,就轮到模型(@Module)闪亮登场了~

    Module!!!

    1.建立模型(@Module)

    模型(@Module)的作用就是在不修改对象源代码的情况下,将其装入注入器(@Component)。

    我们现在就为OkHttp创建一个模型,使用@Module注解将它标记起来:

    @Module
    public class OkHttpModule {
    }
    

    2.创建提供者(@Provides)

    Provides,顾名思义——提供者,他用于给Dagger2标记提供参数以及对象的方法

    我们在上述模型中,创建一个提供对象的方法,并用@Provides标记起来:

    @Module
    public class OkHttpModule {
        @Provides
        public OkHttpClient okHttpClientProvider() {
            return new OkHttpClient(); 
       }
    }
    

    3.单例标记(@Singleton)

    因为OkHttp的实例需要用到单例模式,这里就轮到@Singleton登场了,

    Singleton,翻译过来就是独身的,这个注释是用来标记使用单例模式的提供者(Provides)以及注入器(Component)

    @Module
    public class OkHttpModule {
         @Singleton//单例标记
         @Provides
        public OkHttpClient okHttpClientProvider() {
            return new OkHttpClient();
        }
    }
    

    需要注意的是,Singleton只对一次inject()有效,如果你需要在整个APP中做一个单例,记得只能在Application中inject()!切记!切记!切记!

    4.创建单例模型注入器(@Component)

    这个注解是不是很熟悉~如果还不熟悉的话,请回顾第一节课!

    这里的注入器和第一节的不同,需要指定它的提供者模型(modules = OkHttpModule.class),并标记他是一个单例注入器(@Singleton):

    @Singleton//注意:写在Component的上面
    @Component(modules = OkHttpModule.class)
    public interface OkHttpComponent {
         void inject(BaseApplication baseApplication);
    }
    

    5.构建项目,生成注入器

    Make一下Project,喝口冰阔落。

    6.使用模型注入器

    不带参数的对象,注入器使用起来是一模一样的,都是DaggerXXXComponent.create().inject(this);

    public class BaseApplication extends Application {
            @Inject
            OkHttpClient okHttpClient;
    
            @Override
            public void onCreate() {
                super.onCreate();
    
                //注入对象
                DaggerOkHttpComponent.create().inject(this);
    
                /**
                 以下为OkHttp使用,与Dagger2无关
                 */
                Request request = new Request.Builder().url("https://www.baidu.com/s?wd=世界上最帅的人").build();
                okHttpClient.newCall(request).enqueue(new Callback() {
                    @Override
                    public void onFailure(Call call, IOException e) {
                        Log.e("result", "查无此人");
                    }
    
                    @Override
                    public void onResponse(Call call, final Response response) throws IOException {
                        Log.e("result", response.body().string());
                    }
                });
            }
        }
    

    这样一来,就以Dagger2的方式创建了单例OkHttpClient。

    那么话说回来,如果不需要单例模式怎么办呢?

    如果不需要单例模式,去掉注入器和提供者上的@Singleton注释就好了~

    7.踏坑

    有些同学就要问了,那在注入的时候,直接注入Activity岂不是复用性更高吗~

    @Singleton
    @Component(modules = OkHttpModule.class)
    public interface OkHttpComponent {
        //这里直接注入Activity
        void inject(Activity activity);
    }
    

    那我们现在就开始以这种方式踏坑~

    空指针异常

    啥玩意儿啊,我明明@Inject了啊,所有代码都准确无误啊!

    告诉你,崩溃的原因是:Dagger2是强类型注入的。

    我们来看下当你使用Activity注入时,Dagger2生成的代码:

    public final class DaggerOkHttpComponent implements OkHttpComponent {
    
        ......
    
       @Override
      public void inject(Activity activity) {}
    

    看到没,inject方法是空的!空的!空的!

    而使用MainActivity注入时:

    public final class DaggerOkHttpComponent implements OkHttpComponent {
    
         ...... 
    
      @Override
      public void inject(MainActivity mainActivity) {
        injectMainActivity(mainActivity);
      }
    

    这个时候才有代码。

    我不知道这个是目前Dagger2的Bug,还是作者为了让你“优雅的编程”,故意这样设计的,

    总而言之,在写注入器的时候,一定要按强类型进行注入!【毕竟帮不帮你注入是Dagger2说了算

    那么关于Dagger2单例模式注入就到这里。

    下节课我们讲解Dagger2如何注入一个带参数的对象

    相关文章

      网友评论

          本文标题:史上最适合新手的Dagger2教程(三)模型与单例

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