以下内容为原创，欢迎转载，转载请注明
来自天天博客：http://www.cnblogs.com/tiantianbyconan/p/6266442.html

在Dagger 2中Activities和Subcomponents的多绑定

原文：http://frogermcs.github.io/activities-multibinding-in-dagger-2

几个月前，在MCE^3会议中，Gregory Kick在他的演讲中展示了一个提供Subcomponents（比如，为Activity）的新概念。新的方式给我们带来了一个创建不使用AppComponent对象引用（以前时Activities Subcomponents的工厂）的方式。为了让它成为现实，我们不得不等到了新的Dagger release版本：version 2.7。

问题

在Dagger 2.7之前，创建Subcomponent（比如，AppComponent的subcomponent MainActivityComponent）我们必须要在父Component中声明它的工厂：

@Singleton
@Component(
    modules = {
        AppModule.class
    }
)
public interface AppComponent {
    MainActivityComponent plus(MainActivityComponent.ModuleImpl module);

    //...
}

多亏Dagger理解这个声明，MainActivityComponent能够访问从AppComponent的依赖。

有了这个，MainActivity中的注入看起来如下：

@Override
protected ActivityComponent onCreateComponent() {
    ((MyApplication) getApplication()).getComponent().plus(new MainActivityComponent.ModuleImpl(this));
    component.inject(this);
    return component;
}

这个代码的问题在于：

Activity依赖于AppComponent（通过((MyApplication) getApplication()).getComponent())返回 - 我们是否想要去创建Subcomponent，我们需要去访问父Component的对象）。
AppComponent必须要去声明所有Subcomponents（或者它们的builders），比如：MainActivityComponent plus(MainActivityComponent.ModuleImpl module);。

Modules.subcomponents

从Dagger 2.7开始，我们有了一个新的方法来声明subcomponents的父级。@Module注解有一个可选的subcomponents属性，它可以得到subcomponents类的列表，它们应该是安装此module组件的子component。

Example：

@Module(
        subcomponents = {
                MainActivityComponent.class,
                SecondActivityComponent.class
        })
public abstract class ActivityBindingModule {
    //...
}

ActivityBindingModule在AppComponent中被安装。这表示MainActivityComponent和SecondActivityComponent两者都是AppComponent的Subcomponents。

Subcomponents的声明在这种方法中不需要明确地在AppComponent中进行声明（就像本章开头的代码）。

Activities的多绑定

让我们来看看我们怎么样使用Modules.subcomponents来构建Activities多绑定并且摆脱AppComponent对象传入Activity（这在这个演讲中也解释到）。我将只浏览代码中最重要的部分。整个实现已在Github中可用：Dagger2Recipes-ActivitiesMultibinding。

我们的app包含两个屏幕：MainActivity和SecondActivity。我们想要去给它们两者提供Subcomponents且并不传入AppComponent对象。

让我们从为所有Activity Components builders构建一个基本的接口来开始：

public interface ActivityComponentBuilder<M extends ActivityModule, C extends ActivityComponent> {
    ActivityComponentBuilder<M, C> activityModule(M activityModule);
    C build();
}

Subcomponents：MainActivityComponent的例子看起来如下：

@ActivityScope
@Subcomponent(
        modules = MainActivityComponent.MainActivityModule.class
)
public interface MainActivityComponent extends ActivityComponent<MainActivity> {

    @Subcomponent.Builder
    interface Builder extends ActivityComponentBuilder<MainActivityModule, MainActivityComponent> {
    }

    @Module
    class MainActivityModule extends ActivityModule<MainActivity> {
        MainActivityModule(MainActivity activity) {
            super(activity);
        }
    }
}

现在我们可以使用Subcomponents builders的Map来得到每一个Activity类的意图builder。让我们如下使用Multibinding特性：

@Module(
        subcomponents = {
                MainActivityComponent.class,
                SecondActivityComponent.class
        })
public abstract class ActivityBindingModule {

    @Binds
    @IntoMap
    @ActivityKey(MainActivity.class)
    public abstract ActivityComponentBuilder mainActivityComponentBuilder(MainActivityComponent.Builder impl);

    @Binds
    @IntoMap
    @ActivityKey(SecondActivity.class)
    public abstract ActivityComponentBuilder secondActivityComponentBuilder(SecondActivityComponent.Builder impl);
}

ActivityBindingModule在AppComponent中被安装。就如它被解释的那样，多亏MainActivityComponent和SecondActivityComponent将会是AppComponent的Subcomponent。

现在我们可以注入Subcomponents builder的Map（比如，注入到MyApplication class）：

public class MyApplication extends Application implements HasActivitySubcomponentBuilders {

    @Inject
    Map<Class<? extends Activity>, ActivityComponentBuilder> activityComponentBuilders;

    private AppComponent appComponent;

    public static HasActivitySubcomponentBuilders get(Context context) {
        return ((HasActivitySubcomponentBuilders) context.getApplicationContext());
    }

    @Override
    public void onCreate() {
        super.onCreate();
        appComponent = DaggerAppComponent.create();
        appComponent.inject(this);
    }

    @Override
    public ActivityComponentBuilder getActivityComponentBuilder(Class<? extends Activity> activityClass) {
        return activityComponentBuilders.get(activityClass);
    }
}

我们创建了HashActivitySubcomponentBuilders接口作为额外的抽象（因为builders的Map不一定是注入到Appliction类的）：

public interface HasActivitySubcomponentBuilders {
    ActivityComponentBuilder getActivityComponentBuilder(Class<? extends Activity> activityClass);
}

然后最后在Activity class中进行注入的实现：

public class MainActivity extends BaseActivity {

    //...

    @Override
    protected void injectMembers(HasActivitySubcomponentBuilders hasActivitySubcomponentBuilders) {
        ((MainActivityComponent.Builder) hasActivitySubcomponentBuilders.getActivityComponentBuilder(MainActivity.class))
                .activityModule(new MainActivityComponent.MainActivityModule(this))
                .build().injectMembers(this);
    }
}

它非常类似于我们的第一个实现，但如上，最重要的事是我们不再传入ActivityComponent对象到我们的Activities中。

用例example —— instrumentation tests mocking

除了解耦和解决循环依赖（Activity <-> Application），这不是一个大的问题，尤其是在较小的项目/团队中，让我们思考一个这个实现有帮助的真实用例 —— 在instrumentation testing中的mocking依赖。

目前在Android Instrumentation测试中mocking依赖最著名的方式之一是使用DaggerMock（Github 项目地址）。虽然DaggerMock是一个强大的工具，但是非常难理解它面具之下是怎么工作的。其中有一些反射代码不容易被追踪。

在Activity中直接构建Subcomponent，而不需要访问AppComponent类给了我们一个方式来测试单独的Activity并从我们app的其它部分解耦。

听起来很酷，现在我们来看下代码。

在我们的instrumentation test中使用Applicaton类：

public class ApplicationMock extends MyApplication {

    public void putActivityComponentBuilder(ActivityComponentBuilder builder, Class<? extends Activity> cls) {
        Map<Class<? extends Activity>, ActivityComponentBuilder> activityComponentBuilders = new HashMap<>(this.activityComponentBuilders);
        activityComponentBuilders.put(cls, builder);
        this.activityComponentBuilders = activityComponentBuilders;
    }
}

putActivityComponentBuilder()方法给我们一个对给定Activity类替换ActivityComponentBuilder的实现的方法。

现在来看下我们Espresso Instrumentation Test例子：

@RunWith(AndroidJUnit4.class)
public class MainActivityUITest {

    @Rule
    public MockitoRule mockitoRule = MockitoJUnit.rule();

    @Rule
    public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class, true, false);

    @Mock
    MainActivityComponent.Builder builder;
    @Mock
    Utils utilsMock;

    private MainActivityComponent mainActivityComponent = new MainActivityComponent() {
        @Override
        public void injectMembers(MainActivity instance) {
            instance.mainActivityPresenter = new MainActivityPresenter(instance, utilsMock);
        }
    };

    @Before
    public void setUp() {
        when(builder.build()).thenReturn(mainActivityComponent);
        when(builder.activityModule(any(MainActivityComponent.MainActivityModule.class))).thenReturn(builder);

        ApplicationMock app = (ApplicationMock) InstrumentationRegistry.getTargetContext().getApplicationContext();
        app.putActivityComponentBuilder(builder, MainActivity.class);
    }

一步一步来：

我们提供了MainActivityComponent.Builder的Mock和所有我们必须要mock的依赖（在本例中只是Utils）。我们mockedBuilder返回一个MainActivityComponent的一个自定义实现，它用于注入MainActivityPresenter（其中使用了mocked Utils）。
然后我们的MainActivityComponent.Builder替换了在MyApplication（28行）中被注入的原始Builder：app.putActivityComponentBuilder(builder, MainActivity.class);
最后测试 —— 我们mockUtil.getHardcodedText()方法。注入过程发生在Activity被创建（36行）：activityRule.launchActivity(new Intent());接着在最后我们使用Espresso来检验结果。

以上就是全部。如你所见，几乎一切都发生在MainActivityUITest类中，而且代码相当简单和可读。

源码

如果你想自己去测试这个实现，源码与工作例子展示怎么去创建Activities Multibinding和在Instrumentation Tests中mock依赖见Github：Dagger2Recipes-ActivitiesMultibinding

感谢阅读！

作者

Miroslaw Stanek

Head of Mobile Development @ Azimo

[Android]使用Dagger 2依赖注入 - DI介绍（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/5092083.html

[Android]使用Dagger 2依赖注入 - API（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/5092525.html

[Android]使用Dagger 2依赖注入 - 自定义Scope（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/5095426.html

[Android]使用Dagger 2依赖注入 - 图表创建的性能（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/5098943.html

[Android]Dagger2Metrics - 测量DI图表初始化的性能（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/5193437.html

[Android]使用Dagger 2进行依赖注入 - Producers（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/6234811.html

[Android]在Dagger 2中使用RxJava来进行异步注入（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/6236646.html

[Android]使用Dagger 2来构建UserScope（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/6237731.html

[Android]在Dagger 2中Activities和Subcomponents的多绑定（翻译）:

http://www.cnblogs.com/tiantianbyconan/p/6266442.html

[Android]在Dagger 2中Activities和Subcomponents的多绑定（翻译）

在Dagger 2中Activities和Subcomponents的多绑定

问题

Modules.subcomponents

Example：

Activities的多绑定

用例example —— instrumentation tests mocking

源码

作者

热门文章

最新文章

相关课程

相关电子书

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

[Android]在Dagger 2中Activities和Subcomponents的多绑定（翻译）

在Dagger 2中Activities和Subcomponents的多绑定

问题

Modules.subcomponents

Example：

Activities的多绑定

用例example —— instrumentation tests mocking

源码

作者

热门文章

最新文章

相关课程

相关电子书