Android:Dagger2系列2 实例解析（更新完毕）

上一篇：Android：Dagger2系列1 初识
下一篇：Android：Dagger2系列3 深入探究(更新ing)

这篇文章会分享一下实际应用中的Dagger2如何使用，以及Dagger2通过apt插件如何给我们生成代码，以及生成的代码之间的关联。

下面说一下模拟的业务场景：

主界面MainActivity通过MainPresenter去请求一个接口，并返回数据。这里用的是MVP+Retrofit2+RxJava,如果不熟悉可以先不管，因为不会涉及太多，而这篇内容主要分享的是Dagger2。
如果mvp不清楚的可以点击 mvp google 写法；RxJava和Retrofit后期我也会分享出来（知道的略过），欢迎关注！！！

先看下关于Dagger部分的包目录结构：

google官方demo 是按照业务来分包的，个人比较喜欢按照组件来分。

目录结构.png

首先我需要一个全局的网络请求对象IRetrofitRequest放在Application,并且是单例的。所以写了一个RetrofitModule提供IRetrofitRequest实例。

代码块1：

@Singleton
@Component(modules = {AppModule.class, RetrofitModule.class})
public interface AppComponent {
    IRetrofitRequest request();
    Context getContext();
}

其中request();方法返回的IRetrofitRequest对象需要上面代码块1：依赖的RetrofitModule类中进行实例化：如下代码

代码块2：

@Module
public class RetrofitModule {
    @Provides
    @Singleton
    public IRetrofitRequest getService() {
        OkHttpClient httpClient = new OkHttpClient.Builder()
                .connectTimeout(30, TimeUnit.SECONDS)//设置请求超时时间
                .retryOnConnectionFailure(true)//设置出现错误进行重新连接
                .build();
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(UrlConst.URL)
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .client(httpClient)
                .build();
        return retrofit.create(IRetrofitRequest.class);
    }
}

代码块2：中提供的IRetrofitRequest 实例对象必须要用@Provides标注，该对象是单例的所以用@Singleton标注，这里为什么用这两个注解标注之后就能实现为AppComponent提供单例的实例，稍后会进行Dagger2生成的代码解析。
当然一个Component类可以依赖多个Module，如代码块1：中还依赖了AppModule，AppModule中提供了在Component方法名是getContext()的实例对象，如下代码：

代码块3：

@Module
public class AppModule {
    private Context context;
    public AppModule(Context context) {
        this.context = context;
    }
    @Provides
    public Context getContext() {
        return context;
    }
}

如代码块2和3所示，所有的被Component依赖的Module都必须用@Module注解标注。因为Dagger2需要这些标注通过apt插件自动生成代码。
在AppComponent中提供的IRetrofitRequest单例对象如何在Application中使用呢？

代码块4：

public class App extends Application {
    private static AppComponent appComponent;
    @Override
    public void onCreate() {
        super.onCreate();
        appComponent = DaggerAppComponent.builder()
                .appModule(new AppModule(getApplicationContext()))
                .retrofitModule(new RetrofitModule())
                .build();
    }
    public static AppComponent getComponent() {
        return appComponent;
    }
}

代码块4：中的DaggerAppComponent是Dagger2帮我们自动生成的，只要编译一下就可以自动生成：


编译.png

AppComponent需要初始化依赖的两个Module(AppModule和RetrofitModule),这里生成的DaggerAppComponent是通过构建者模式进行初始化的。

.appModule(new AppModule(getApplicationContext()))
.retrofitModule(new RetrofitModule())

最后创建的AppComponent就提供了IRetrofitRequest全局单例对象，整个app的网络访问都可以通过该对象进行调用。

AppComponent后期拓展：

一个全局的变量现在统一都可以放在AppComponent中进行管理，这个demo中有网络请求的一个单例接口对象，一个是全局的Context对象。后期肯定会有其他的都可以放在AppModule中进行实例化，或者单独再写一个Module依赖到AppComponent中。

在MainActivity中如何进行使用：

这里用的是mvp开发模式，所以需要一个Presenter：MainActivityPresenter，需要传递一个参数，用于操作MainActivity界面:MainActivityContract.View，而这个MainActivityPresenter谁来提供呢？当然是Component通过依赖的Module来提供，看看MainActivity的Component和Module。

代码块5：

@ActivityScope
@Component(dependencies = AppComponent.class, modules = {MainActivityModule.class})
public interface MainActivityComponent {
    void inject(MainActivity mainActivity);
}

代码块6：

@Module
public class MainActivityModule {
    private MainActivityContract.View view;
    public MainActivityModule(MainActivityContract.View view) {
        this.view = view;
    }
    @ActivityScope
    @Provides
    public MainActivityPresenter getMainActivityPresenter() {
        return new MainActivityPresenter(view);
    }
}
这里的代码块5和6,你会发现我们在MainActivityModule 里提供了MainActivityPresenter实例，但是在MainActivityComponent接口里并没有写上提供MainActivityPresenter的方法，另外还多了一个void inject(MainActivity mainactivity),这里跟AppComponent中的（代码块1）有区别是咋回事？等会解释。

再看MainActivity代码：

代码块6:

public class MainActivity extends BaseActivity implements MainActivityContract.View {
    @Inject
    MainActivityPresenter presenter;
    @Inject
    SecondActivityPresenter secondActivityPresenter;
    @Bind(R.id.textView)
    TextView textView;
    @Bind(R.id.textView2)
    TextView textView2;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.bind(this);
        presenter.start();
        secondActivityPresenter.set();
    }
    @Override
    public void providers() {//该方法是BaseActivity中onCreate()中调用的抽象方法
        DaggerMainActivityComponent.builder()
                .mainActivityModule(new MainActivityModule(this))
                .appComponent(App.getComponent())
                .build()
                .inject(this);
    }
    @OnClick({R.id.textView, R.id.textView2})
    public void onClick(View view) {
        switch (view.getId()) {
            case R.id.textView:
                startActivity(new Intent(this, SecondActivity.class));
                break;
            case R.id.textView2:
                break;
            default:
                break;
        }
    }
    @Override
    public void showSuccess() {
        T.show(this, "成功");
    }
    @Override
    public void showFailed() {
        T.show(this, "失败");
    }
}
先解释一下providers()方法：该方法是BaseActivity中onCreate()中调用的抽象方法。

注意看代码中的

@Inject
MainActivityPresenter presenter;

注意1：但是在整个MainActivity中却找不到初始化的过程，再看providers()方法中的代码，跟App中有区别的是，我这里并没有写成

  MainActivityComponent mainActivityComponent = DaggerMainActivityComponent.builder()
                .mainActivityModule(new MainActivityModule(this))
                .appComponent(App.getComponent())
                .build();

注意2：还有的区别是多了一个

.inject(this);

原因：

1：因为在App中我并没有哪个对象的声明用了@Inject注解进行标注，而且App中的AppComponent实例对象需要给其他Activity或者类使用。
2：在该demo中的MainActivity，我们不需要其他地方用到MainActivityComponent对象，我们只是在MainActivity用到MainPresenter对象，我们可以不用通过MainActivityComponent中的某一个方法获得MainPresenter对象，我们在用@Inject标注MainActivityPresenter presenter的时候需要把在哪里声明的外部类(这里是MainActivity)注入到MainComponent中，就是上面(代码块5)说过的没有提供返回MainPresenter的方法却多了一个void inject(MainActivity mainactivity)；这里的返回值是void的inject方法名可以是任意的，但是最好写成inject（官方写法）。

最后只要调用了providers()方法，我们的MainPresenter presenter对象就已经被初始化了，这个时候就可以通过presenter.start()去调用网络接口请求数据了；

只要我们配置了以上的Component,Module，编译之后Dagger2就会通过apt插件生成一系列代码。

那么一系列代码到底是怎样的？到底是怎样工作的呢？

先看下生成的代码目录结构：

Dagger2通过apt生成的代码目录结构.png

可以看到生成的代码包名还是跟自己代码中的一样，生成的代码的类名也有一定的规则。

看看这些代码是根据什么注解生成的：

  • 用@Component注解标注的xxxComponent类会生成DaggerxxxComponent类
  • 用@Module注解标注的xxxModule中用@Provides注解标注的每个方法都会生成一个类，这个类是一个工厂模式，提供对象实例，比如：
@Module
public class AAModule{
    @ActivityScope
    @Providespublic 
    BB getBB() {
        return new BB();
    }
}

getBB()方法就会生成AAModule_GetBBFactory类。

  • 如果一个类的构造函数用了@Inject注解标注：例如：
public class CC{
    @Inject
    public CC() {
    }
}

就会生成CC_Factory类。

  • 如果一个类中有用@Inject注解标注对象声明他就会生成：比如demo中的MainActivity;
public class MainActivity extends BaseActivity implements MainActivityContract.View {   
     @Inject
     MainActivityPresenter presenter;
}

Dagger2就会自动生成MainActivity_MembersInjector。

看看这些代码之间的关联

Dagger2 自动生成的代码关联分析图.jpg

分析图箭头的结尾是DaggerMainActivityComponent，也就是最后暴露给我们的就是DaggerMainActivityComponent这个类，其它帮助我们生成的代码都可以不用关心。

分析图或许会有疏漏和不对，基本情况应该就是这样，更多细节性的代码可以查看项目gitlab： demo

上一篇：Android：Dagger2系列1 初识
下一篇：Android：Dagger2系列3 深入探究(更新ing)

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 205,033评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,725评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,473评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,846评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,848评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,691评论 1赞 282
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,053评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,700评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,856评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,430评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,034评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2赞 343

推荐阅读更多精彩内容

  • Dagger2 最清晰的使用教程
    部分内容参考自：[Android]使用Dagger 2依赖注入 - DI介绍（翻译）[Android]使用Dagg...
    AItsuki阅读 47,231评论 66赞 356
  • Dagger2从入门到放弃再到恍然大悟
    写在前面：我目前就职于阿里巴巴-菜鸟，团队目前缺人，招聘java和客户端开发，招聘对象为：社招和19届毕业的校招生...
    littleKang阅读 115,368评论 93赞 745
  • 别让时光偷了你上扬的嘴角
    不知道你们的身边有没有这么一种人，莫名其妙的他就给你吊脸子，好像突然之间你欠了他五百万。你刚毕业，他总是嘲笑你...
    伊筱葵阅读 429评论 0赞 1
  • 小微小说：归
    （一）树归树 林归林 也不知道怎么了，这几天的天气异常得很。整日里，天都是灰蒙蒙的，好像被一个大闷盖儿盖住了似的，...
    落在枝头阅读 524评论 0赞 0
  • 每天1000字很难吗？
    每天1000字，把它分解开来，如果一句话十个字的话平均，也就是，每天说100句话，然后把它写下来，1000字的任务...
    倔强的挑夫阅读 354评论 0赞 0