当复仇者联盟遇上Dagger2、RxJava和Retrofit的巧妙结合
最近,许多文章、框架和 android 社区中的讨论都出现关于测试和软件架构方面的内容,就像上次Droidcon Spain上所说的,我们专注于做出健壮的程序而不是去开发特性功能。这些现象也意味着 Android 框架和当前 Android 社区的日渐成熟。
如果你是一名 Android 开发者,而到现在你还没听过Dagger 2、RxJava、Retrofit这些名词的话你就错过了一些东西了,这个(文章)系列将会把一些关注点放在怎么用一种清晰架构去综合使用这些框架。
我刚开始的想法是仅仅写一篇文章的,但是看到这些框架中有大量的内容所以我最终决定写一个最少 3 篇的系列文章。
一如既往,所有的代码都放在了Github,所有的建议、错误提交和评论都欢迎,我可能没那么多时间去回答所有问题,先说声抱歉 :)
依赖注入与 Dagger 2
弄懂这个框架的工作机制花费了一些时间,所以我将会根据我所学习到的内容用更加清晰的方式写出来。
Dagger 2是基于依赖注入模式的。
看下下面的代码片段:
1 2 3 4 5 6 7 8 9 10 11 12 | //Thorisawesome.Hehasahammer! publicclassThorextendsAvenger{ privatefinalAvengerWeaponmyAmazingHammer; publicThor(AvengerWeaponanAmazingHammer){ myAmazingHammer=anAmazingHammer; } publicvoiddoAmazingThorWork(){ myAmazingHammer.hitSomeone(); } } |
雷神(Thor)需要一个复仇者武器(AvengerWeapon)
才能正确工作,依赖注入的基本思想是,如果雷神不是通过构造器创建他自己的复仇者武器
而是在内部自己创建了出来那么他就不能得到很多的优势。如果雷神自己创建出雷锤将会增加耦合度。
复仇者武器(AvengerWeapon)
可以是一个接口,根据我们的逻辑可以有不同的实现和注入方式。
在 Android 中,因为框架已经设计好了,我们并不总是能访问构造器,Activity
和Fragment
就是这样的例子。
这些依赖注入器框架像http://google.github.io/dagger/、Dagger、Guice可以给我们带来便利。
使用Dagger 2我们可以把之前的代码改写成这样:
1 2 3 4 5 6 7 8 | //Thorisawesome.Hehasahammer! publicclassThorextendsAvenger{ @InjectAvengerWeaponmyAmazingHammer; publicvoiddoAmazingThorWork(){ myAmazingHammer.hitSomeone(); } } |
我们没有直接访问雷神的构造方法,注入器使用了几个指令去创建了雷神的雷锤
1 2 3 4 5 6 7 | publicclassThorHammerextendsAvengerWeapon(){ @InjectpublicAvengerWeapon(){ initGodHammer(); } } |
@Inject
注解用于告诉 Dagger 2 构造器有用于创建雷神的雷锤。
Dagger 2
Dagger 2由 Google 开发和维护,是Square的Dagger项目的分支。
首先必须配置注解处理器,android-apt
插件就是负责这个角色,允许使用注解处理器而不将其插入到最后的 .apk 中。处理器还配置由该处理器所产生的源代码。
build.gradle
(项目的根目录中)
1 2 3 4 | dependencies{ ... classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4' } |
build.gradle
(你的 android module 中)
1 2 3 4 5 6 | applyplugin: 'com.neenbedankt.android-apt' dependencies{ ... apt 'com.google.dagger:dagger-compiler:2.0' } |
组件(Components)、模块(modules)和复仇者
模块负责提供依赖,组件负责注入它们(依赖)。
这是一个例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | @Module publicclassAppModule{ privatefinalAvengersApplicationmAvengersApplication; publicAppModule(AvengersApplicationavengersApplication){ this .mAvengersApplication=avengersApplication; } @Provides@Singleton AvengersApplicationprovideAvengersAppContext(){ return mAvengersApplication; } @Provides@Singleton RepositoryprovideDataRepository(RestRepositoryrestRepository){ return restRepository; } } |
这个就是主模块,我们感兴趣的是它的依赖存在于程序的生命周期中,一个通用的上下文和一个取回信息的仓库。
很简单,对吧?
我们在 Dagger 2 中所说的@Provides
注解,如果有需要则必须会创建其依赖。因此如果我们没有给一个特别的依赖指定一个提供者(provider),Dagger 2 将会去寻找有@Inject
注解的构造方法。
组件使用模块去完成依赖注入,看看这个模块的组件:
1 2 3 4 5 6 | @Singleton@Component(modules=AppModule.class) publicinterfaceAppComponent{ AvengersApplicationapp(); RepositorydataRepository(); } |
这个模块并不由任何的 activity 或者 fragment 去调用,而是通过更复杂的模块,以提供这些需要得到的依赖
1 2 | AvengersApplicationapp(); RepositorydataRepository(); |
组件必须暴露它们的依赖给图(该模块提供的依赖关系),也即是这个模块提供的依赖关系必须对其它组件是可见的,其它的组件有把当前这个组件作为依赖,如果这些依赖关系是不可见的,Dagger 2 将不会注入这些要求的依赖。
下面是我们的依赖关系树:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 | @Module publicclassAvengersModule{ @Provides@Activity List<Character>provideAvengers(){ List<Character>avengers= new ArrayList<>(6); avengers.add( new Character( "IronMan" ,R.drawable.thumb_iron_man,1009368)); avengers.add( new Character( "Thor" ,R.drawable.thumb_thor,1009664)); avengers.add( new Character( "CaptainAmerica" ,R.drawable.thumb_cap,1009220)); avengers.add( new Character( "BlackWidow" ,R.drawable.thumb_nat,1009189)); avengers.add( new Character( "Hawkeye" ,R.drawable.thumb_hawkeye,1009338)); avengers.add( new Character( "Hulk" ,R.drawable.thumb_hulk,1009351)); return avengers; } } |
这个模块将会用于一个特别的 activity 的依赖注入,实际上就是负责绘画的复仇者名单:
1 2 3 4 5 6 7 8 9 10 11 12 13 | @Activity @Component( dependencies=AppComponent.class, modules={ AvengersModule.class, ActivityModule.class } ) publicinterfaceAvengersComponentextendsActivityComponent{ voidinject(AvengersListActivityactivity); List<Character>avengers(); } |
再次,我们暴露出我们的依赖:List<Character>
给其它的组件,在这种情况下出现了一个新方法:void inject (AvengersListActivity activity)
。在此方法被调用时,这些依赖关系将可被消耗,将会被注入给AvengerListActivity
。
结合所有
我们的类AvengersApplication
,将负责提供应用到其他组件的组件,注意,仅仅提供组件而不会用于注入依赖。
再次提醒的是Dagger 2是在编译时生成必要的元素,如果你没有构建项目你是找不到DaggerAppComponent
类的。
Dagger 2 从你的组件中生成的类的格式:Dagger$${YourComponent}.
。
AvengersApplication.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | publicclassAvengersApplicationextendsApplication{ privateAppComponentmAppComponent; @Override publicvoidonCreate(){ super .onCreate(); initializeInjector(); } privatevoidinitializeInjector(){ mAppComponent=DaggerAppComponent.builder() .appModule( new AppModule( this )) .build(); } publicAppComponentgetAppComponent(){ return mAppComponent; } } |
AvengersListActivity.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 | publicclassAvengersListActivityextendsActivity implementsAvengersView{ @InjectView(R.id.activity_avengers_recycler) RecyclerViewmAvengersRecycler; @InjectView(R.id.activity_avengers_toolbar) ToolbarmAvengersToolbar; @Inject AvengersListPresentermAvengersListPresenter; @Override protectedvoidonCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); setContentView(R.layout.activity_avengers_list); ButterKnife.inject( this ); initializeToolbar(); initializeRecyclerView(); initializeDependencyInjector(); initializePresenter(); } privatevoidinitializeDependencyInjector(){ AvengersApplicationavengersApplication= (AvengersApplication)getApplication(); DaggerAvengersComponent.builder() .avengersModule( new AvengersModule()) .activityModule( new ActivityModule( this )) .appComponent(avengersApplication.getAppComponent()) .build().inject( this ); } |
当initializeDependencyInjector()
中执行到.inject(this)
中时Dagger 2就会开始工作并提供必要的依赖关系,请记住Dagger 2在注入时是严格执行的,我要说的意思是组件必须是完全相同的组件类,此组件类负责调用inject()
方法。
AvengersComponent.java
1 2 3 4 5 6 | ... publicinterfaceAvengersComponentextendsActivityComponent{ voidinject(AvengersListActivityactivity); List<Character>avengers(); } |
否则,依赖关系将不会被解决。在如下情况,presenter 与由 Dagger 2 提供的复仇者一起初始化:
1 2 3 4 5 6 7 8 9 10 11 12 | publicclassAvengersListPresenterimplementsPresenter,RecyclerClickListener{ privatefinalList<Character>mAvengersList; privatefinalContextmContext; privateAvengersViewmAvengersView; privateIntentmIntent; @InjectpublicAvengersListPresenter(List<Character>avengers,Contextcontext){ mAvengersList=avengers; mContext=context; } |
Dagger 2将会解决这个 presenter,因为其有@Inject
注解。该构造方法的参数由 Dagger 2 解决,因为它知道怎么去构建它,这得益于这个模块中的@Provides
方法。
总结
像Dagger 2这样,使用好了依赖注入器,其力量是无可争辩的,想象下根据该框架提供的 API 级别你可以有不同的策略,其可能性是无止境的。
资源
-
Chiu-Ki Chan–Dagger 2 + Espresso + Mockito
-
Fernando Cejas–Tasting Dagger 2 on Android
-
Google Developers–Dagger 2, A new type of dependency injection
-
Mike Gouline–Dagger 2, Even sharper, less square
更多相关文章
- Unity与Android对比学习之生命周期方法
- [Android]新手入门:Intent的介绍和常见用法总结
- Android基本组件之图像视图等余下组件(自用)
- 四大组件之Activity小结
- 浅谈Android四大组件之ContentProvider
- 关于Android多进程
- .Net 转战 Android(安卓)4.4 日常笔记(9)--常用组件的使用方法[附
- Intent filter 关于Action、Category属性详解---附带实例源码
- android开发教程(十一)——android应用程序基础