Dagger 2模块与子组件

Question

如果我想通过Dagger 2注入这个存储库，但是我希望它对于其他存储库实现是可替换的（我在避免使用“模块化”这个词），或者我希望它可以在其他组件上使用，那么我应该将它创建为存储库模块还是存储库子组件呢？

什么时候应该使用模块，什么时候应该使用子组件来实现模块化？

Answer 1

模块代表了一组相关的功能和绑定，可能就是您要找的。通过创建一个文档化的、可重用的模块，您封装了创建存储库的责任，允许其他开发人员或团队在不知道如何或在哪里创建存储库的情况下消费存储库。您甚至可以选择将存储库包的构造函数设置为私有的，这样您就可以控制如何使用它。

与Dagger 1不同，Dagger 2期望模块不一定是完整的：它们可以引用自己没有定义或指定的绑定。因此，如果您想要创建一个依赖于外部组件的可重用模块，您可能想要记录它需要从外部绑定的类型。（当然，您也可以使用module.includes自己指定，但这会阻止使用者在选择依赖项时使用您的模块。替换依赖项可能是测试策略的重要部分，例如对于使用假网络后端的集成测试。）

相反，子组件通常表示不同的作用域和生命周期。在Android应用程序中，这可能是服务、活动或片段的生存期，但您也可以定义自己的作用域：您也可以选择一些作用域来表示用户的登录作用域（即，在用户登录时使用相同的对象，但在用户注销或以其他人身份登录时使用新的对象）。

但是，这两种选择并不是非此即彼，特别是在使用子组件进行封装时。如果您的存储库需要许多您不希望从应用程序的其余部分注入的绑定，您可以选择将这些绑定绑定到仅包含在子组件中的模块中。看起来应该是这样的：

@Provides Repository provideRepository(RepositorySubcomponent subcomponent) {
  return subcomponent.getRepository();  // defined on the subcomponent
}

类似地，您可能还需要在子图中绑定特定的绑定。也许您的应用程序需要两个独立的存储库后端，具有两个独立的存储实例。这可能是创建可重用存储库的一个问题，因为同一个图不能为同一个绑定注入不同的后端。（这有时被称为“机器腿”问题，想象一个机器人使用相同的腿和膝盖，但左右脚不同。）对于子组件，您可以选择使后端成为构建器的一部分：

@Provides @Foo Repository provideFooRepository(
    RepositorySubcomponent.Builder builder,
    StoneTabletStorage stoneTabletStorage) {
  // Inject and use the builder instead, since we're passing in a required value.
  // In this example, you'd need to define a method on the builder,
  // @BindsInstance Builder storage(Storage storageImpl);
  return builder
             .storage(stoneTabletStorage)
             .build()
             .getRepository();
}

@Provides @Bar Repository provideBarRepository(
    RepositorySubcomponent.Builder builder,
    HolographicQubitStorage holographicQubitStorage) {
  return subcomponent
             .storage(holographicQubitStorage)
             .build()
             .getRepository();
}

...或为每个组件定义单独的子组件：

@Subcomponent(modules = {RepositoryModule.class, StoneTabletStorageModule.class})
public interface FooSubcomponent {
  Repository getFooRepository();
}

@Subcomponent(modules = {RepositoryModule.class, HolographicQubitStorageModule.class})
public interface BarSubcomponent {
  Repository getBarRepository();
}

您还可以通过在modules.subcomponents上列出子组件来组合这些技术，从而创建一个可重用的模块，该模块根据需要安装子组件。这允许子组件成为模块的实现细节，为您提供更大的灵活性来更改模块，同时保留其他开发人员和团队使用的绑定。