Dagger2 in Android(四).android 扩展库

问题

在之前我们讨论过,Dagger 在 Android 上普遍的结构是:定义一个全局的 AppComponent,其他组件依赖或继承它。假设现在有 AppComponent 与 ActivityComponent 两个,他们可能是这样编写的:

@Module(subcomponents = [ActivityComponent::class])
class AppModule(val context: Context) {

    @Provides
    @Singleton
    fun provideContext() = context
}

@Component(modules = [AppModule::class])
@Singleton
interface AppComponent {
    fun inject(app: MyApplication)
    
    fun activityComponent(): ActivityComponent.Builder
}
@Module
class ActivityModule {
    @Provides
    fun provideSp(context: Context) =
            context.getSharedPreferences("Cooker", Context.MODE_PRIVATE)
}

@SubComponent(modules = [ActivityModule::class])
interface ActivityComponent {
    
    fun inject(activity: MainActivity)

    @Subcomponent.Builder
    interface Builder {
        fun build(): ActivityComponent
    }
}

上面定义了这两个 Component 并且他们是包含关系。然后我们必须在 Appliction 中实例化 AppComponent 来保证单例:

class MyApplication: Application {
    lateinit var component: AppComponent
    override fun onCreate() {
        super.onCreate();
        component = DaggerAppComponent.builder().appModule(AppModule(this)).build();
    }
}

最后如果要在 Activity 中使用注入我们得这样写:

class MainAty : AppCompatActivity() {
    @Inject
    lateinit var sp: SharedPreferences

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        (application as MyApplication).component
            .activityComponent()
            .build()
            .inject(this)
}

这种做法有下面两个问题:

  • 每个 Activity 都必须创建一个 Component 实例。这些代码是重复的,会被复制粘贴到很多 Activity。这将很难重构,而且随着时间的推移,甚至都没人知道这段代码究竟是干什么的,成为传说中的「祖传代码」。
  • Activity 必须知道它所需的 Component 类型,这有悖于原则:被注入的类不应该关心依赖注入的细节。

解决

本节主要来源于 Dagger 官方文档

Dagger.android 是一个 Dagger 扩展库,用于解决上面问题,让 Dagger 在 Android 上面的使用更加顺畅。要使用 Dagger.android,首先需要引入,在第一节已经讨论过这个问题了,需要额外依赖下面三个东西:

implementation "com.google.dagger:dagger-android:$dagger_version"
implementation "com.google.dagger:dagger-android-support:$dagger_version"
kapt "com.google.dagger:dagger-android-processor:$dagger_version"

这里以向 MainActivity 中注入对象为例,看看 .android 扩展库如何简化使用。

  1. 首先需要在 AppComponent 中安装扩展库提供的 AndroidInjectionModule,这个 Module 提供了对 Android 系统组件的创建支持。例如 Activity、Fragment 等。
@Component(modules = [AppModule::class, AndroidInjectionModule::class]) // 注意这行
@Singleton
interface AppComponent {

    fun activityComponent(): ActivityComponent.Builder
}
  1. 让 Activity 所需的子 Component 实现 AndroidInjector<Activity> 接口。并且其 Builder 继承 AndroidInjector.Factory。(Builder 已经被标注为弃用)
@SubComponent(modules = [ActivityModule::class])
interface ActivityComponent : AndroidInjector<MainActivity> {

    @Subcomponent.Factory
    interface Factory : AndroidInjector.Factory<MainActivity> {} // 注意这里不用再写 build() 方法了
}
  1. 新创建一个 Module,来绑定 Subcomponent 的 Factory,并把它添加到 AppComponent 中。
@Module(subcomponents = [ActivityComponent::class])
abstract class ActivityBindModule {
    @Binds
    @IntoMap
    @ClassKey(MainAty::class)
    abstract fun bindMainAtyInjectorFactory(
        factory: ActivityComponent.Factory): AndroidInjector.Factory<*>
}

@Component(modules = [AppModule::class, AndroidInjectionModule::class, ActivityBindModule::class]) // 注意这行
@Singleton
interface AppComponent {

    fun activityComponent(): ActivityComponent.Builder
}

提示:

如果子 Component 以及其 Factory(Builder) 没有其他函数,或继承除了步骤2所提到的之外的类,那么可以用注解 @ContributesAndroidInjector 来简化#2#3两步。

只需在 Module 里添加一个抽象方法,返回对应的 Activity 类型,然后用 @ContributesAndroidInjector 来注解它,并指定要加入子 Component 的模块。如果子 Component 拥有 Scope,那么将对应的 Scope 注解也应用到这个抽象方法。

@Module(subcomponents = [LocalWatchFaceComponent::class])
abstract class ActivityBindModule {

    @ActivityScope
    @ContributesAndroidInjector(modules = [ActivityModule::class])
    abstract fun activityInjector(): MainAty
}

// 别忘记加入 AppComponent 当中了

提示:

如有多个 Activity 可以写入同一个 Bind 抽象类中,没必要分别写一个。

  1. Application 类实现 HasActivityInjector 接口,并且注入一个 DispatchingAndroidInjector<Activity> 类型的依赖作为 activityInjector() 函数的返回值。
class MyApplication: Application, HasActivityInjector {
    @Inject
    lateinit var dispatchingActivityInjector: DispatchingAndroidInjector<Activity>
    
    override fun activityInjector() = dispatchingActivityInjector
    
    lateinit var component: AppComponent
    override fun onCreate() {
        super.onCreate();
        component = DaggerAppComponent.builder().appModule(AppModule(this)).build();
    }
}
  1. 最后在 Activity 的 onCreate() 方法中,super.onCreate() 之前,调用 AndroidInjection.inject(this) 即可。
class MainAty : AppCompatActivity() {
    @Inject
    lateinit var sp: SharedPreferences

    override fun onCreate(savedInstanceState: Bundle?) {
        AndroidInjection.inject(this) // <----
        super.onCreate(savedInstanceState)
}

这样 Activity 中的注入被大大简化了,而且 Activity 不再需要知道 Component 的细节。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容