[译] 依赖注入在多模块工程中的应用-阿里云开发者社区

开发者社区> 云计算> 正文

[译] 依赖注入在多模块工程中的应用

简介: 总的来说,这不是一篇关于依赖注入的文章,也不是关于我们为什么选择库 X 而不是库 Y 的文章。 相反的,本文从依赖注入的角度介绍了我们对 Plaid 进行模块化实践的主要成果。

原文地址:Dependency injection in a multi module project
原文作者:Ben Weiss
译文出自:掘金翻译计划
本文永久链接:github.com/xitu/gold-m…
译者:Mirosalva
校对者:JasonZ,wenny


Plaid 应用中引入一个 DI 框架过程中我们学到的东西

image.png

总的来说,这不是一篇关于依赖注入的文章,也不是关于我们为什么选择库 X 而不是库 Y 的文章。
相反的,本文从依赖注入的角度介绍了我们对 Plaid 进行模块化实践的主要成果。

我们的设置

在前面的文章中,我写过 Plaid 应用模块化的整体过程。
一款拼接应用 Plaid — 整体到模块化: 模块化 Plaid 应用的初衷、过程和结果

让我以鸟瞰图的形式快速回顾一下 Plaid 的样子。

我们有一个包含主启动 activity 的 app 模块,同时也有一些依赖 app 模块的动态功能模块(DFM)。每一个 DFM 都包含至少一个与所讨论功能相关的 activity、代码和资源。

app 模块依赖一个包含了共享的代码和资源以及第三方库的 core 模块。
image.png

在我们开始模块化操作和以 Dagger 为主介绍依赖注入之前,先来熟悉下 Plaid 的相关类和函数:

class DesignerNewsInjector {

    fun providesApi(...): DesignerNewsService { ... }

}

虽然这是一个非常好的解决方案,但我们还是手工编写了大量的样板代码。
在任何需要注入的地方,我们都需要在合适的时机调用底层函数,大多数情况下不是在对象初始化时就是在 onCreate 方法中。

依赖注入的简要介绍

依赖注入基本上意味着你不用在你需要的地方创建它们,而是在别的地方创建。然后这些对象的引用可以被传递到需要使用它们的类中。

这点可以通过自己编写或者集成某个依赖注入库来实现,我们选择了集成 Dagger 2。多亏了 Dagger,为了获取一个可以使用的已初始化的 service,我们所有要做的就是如下内容:

@Inject lateinit var service: DesignerNewsService

所有对 service 的依赖可以变成 provides 函数的传参。我们为依赖注入需求选择了 Dagger 意味着我们的依赖图在编译阶段会被创建。下面的章节中要记住这一点。

我们在 Plaid 应用中集成 Dagger 的方式

当我们决定引入 Dagger 到 Plaid 应用时,我们已经学到了宝贵的一课,尤其是对模块化。

不要试图一次就覆盖太多内容。

这意味着花一些时间研究清楚实现一个新功能的最小必要范围是有意义的。我们接下来要讨论的 MVP,即在团队内部审视我们是否在向着正确的方向前进。坚持这种做法可以防止我们进行太大而无法高效利用的变更。这也允许我们在整个代码库中逐步推出更改,与此同时每个人的任务也可持续进行。
在 Plaid 应用内我们使用已验证后的 about 功能模块作为 Dagger 的练习模块。这里我们可以添加 Dagger 而不会干扰到其他模块或负载。你可以在这里查看初始提交。

依赖图解

当为一个单块应用引入依赖注入库时,通常整个应用有个单一的依赖图。
image.png

这可以使组件间共享依赖。在一些库中,依赖可以被设置作用域来避免冲突,或者为被注入对象提供一种特殊的实现。

模块化的怪异之处

对一个模块化的应用,尤其是使用动态功能模块的应用这却不起作用。让我们仔细地研究下应用和动态功能模块如何彼此依赖。一个动态功能模块知道 application 模块的存在。application 模块大致知道动态功能模块的存在,但是不能直接执行该模块的代码。对于依赖注入,这意味着整体图必须被分解成片。
对一个模块化应用,简单的依赖图通常大致长成下面这样。
image.png

更具体的是,Plaid 中组件规划图看起来像这样。
image.png

每个 DFM 都有它自己的组件,以组件所在的功能模块命名。app 模块中的 HomeComponent 组件就是如此。

还有一个包含共享依赖项的组件,它位于 core 库中并被称作 CoreComponent。CoreComponent 背后的主要思想是提供可被整个应用使用的对象。它结合了一些 Dagger 模块,这些模块位于 core 库并可以在整个应用中复用。

此外,由于依赖图具有方向性,因此只能通过以下方式共享 Dagger 组件:
DFM 图可以从 application 模块来访问 Dagger 组件。application 模块可以从它依赖的库中访问组件,但方向反过来则不行。

跨模块边界共享组件

为了共享 Dagger 组件,它们需要被整个应用访问到。在 Plaid 中我们决定使用 Application 类来让我们的 CoreComponent 变得可访问。

class PlaidApplication : Application() {

  private val coreComponent: CoreComponent by lazy {
    DaggerCoreComponent
      .builder()
      .markdownModule(MarkdownModule(resources.displayMetrics))
      .build()
  }

  companion object {

    @JvmStatic fun coreComponent(context: Context) =
      (context.applicationContext as PlaidApplication).coreComponent
  }
}

被实例化的 CoreComponent 组件现在可以从应用中任何具有 context 的地方来访问,通过调用 PlaidApplication.coreComponent(context) 的方式。
使用一个扩展函数可以使 this 更好地访问:

fun Activity.coreComponent() = PlaidApplication.coreComponent(this)

组件中的组件

为了把 CoreComponent 包含到另一个组件中,有必要在组件创建时提供它。让我们看一下在 SearchComponent` 中是如何做到的:

@Component(modules = [...], dependencies = [CoreComponent::class])
interface SearchComponent {

  @Component.Builder
  interface Builder {

    fun coreComponent(coreComponent: CoreComponent): Builder
    // modules
  }
}

在生成的 DaggerSearchComponent 做初始化时我们像这样设置了 `

CoreComponent:
DaggerSearchComponent.builder()
  .coreComponent(activity.coreComponent())
  // modules
  .build()
.inject(activity)

这里的技巧是把 CoreComponent 设置为 SearchComponent 的一个依赖:

@Component(
    modules = [SearchModule::class],
    dependencies = [CoreComponent::class]
)
interface SearchComponent : BaseActivityComponent<SearchActivity>

CoreComponent 是 SearchComponent 的一个依赖。当 CoreComponent 像上面那样被引用为 SearchComponent 的一个组件依赖时,所有的 CoreComponent 方法可以在 SearchComponent 中使用,或者在其他 Dagger 组件中使用,就好像他们变成注解 @Provides 标记的方法。
image.png

这样做的的一个好处是:在功能图中无需重复 @Modules ,却可以通过 CoreComponent 或其他与之绑定的模块来透明地提供出去。

例如,CoreDataModule 绑定在 CoreComponent 中,并提供 Retrofit 等。Retrofit 实例现在可以被任何与 CoreComponent 合并的组件访问到。

下一步要做什么

读完这篇文章,你可以看到模块化你的应用需要把依赖注入考虑进去。引入的功能模块边界通过分离的依赖图反映在依赖注入中。意识到这个限制可有助于为共享组件找到合适的位置。
你可以深入到代码中来查看我们如何使用 Dagger 解决 Plaid 中的依赖注入问题。

CoreComponent 是一个好的阅读开端,AboutComponent 也是,因为它没有太多的外部依赖。


作者:Mirosalva
链接:https://juejin.im/post/5cc15dae5188252dcf5d4c68
来源:掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
云计算
使用钉钉扫一扫加入圈子
+ 订阅

时时分享云计算技术内容,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。

其他文章