Dagger2 这次入门就不用放弃了

2024-08-22 15:08
文章标签 入门 放弃 不用 这次 dagger2

本文主要是介绍Dagger2 这次入门就不用放弃了，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Dagger2 这次入门就不用放弃了

前言

之前也研究过很多次Dagger2这东西了，可能以后RxJava+Retrofit+MVP+Dagger2是Android发展的主流框架，看了Dagger2的实现代码，有点不明所以。上网也有很多文章介绍依赖注入、Dagger2的组件等等那些，这样这样这样什么组件呀、模块呀、注入呀。但是感觉对于入门来说那些文章都没有说到点子上，具体怎么用这个核心点而且应该怎么写代码？为什么这样写，并没有很明确的说明。我来回看了几遍代码之后，总结出了一点经验，不知道说的对不对。

没有了解过Android MVP结构的同学可能不利于阅读。

为什么使用Dagger2

对于这个问题我也困惑了很久，Java代码就是这样写，并没有考虑过依赖注入是什么鬼，并且依赖注入有什么不好。这篇文章详细介绍了依赖注入,感兴趣的可以传送过去看看。

简单来说，依赖注入就是为了控制反转和解耦的，这些高深的名词儿可能一时也不懂。不要紧，我举个栗子就能明白了，请看代码：

class A{}class B{A a;public B(){a = new A();}
}

上面的代码很简单，class B持有一个class A的对象，然后假如根据业务需求需要修改A类的某些实现，这样的话就需要修改B类中的创建A对象的方式。假想一下，当你的代码规模达到一定的程度的时候，需要改一部分代码，牵一而发动全身，需要改的代码量多，而且容易出错。还有一个不好的情况就是，当要对A进行单元测试的时候，就要测试B，这样的耦合可能不是程序员希望看见的。Dagger2就是为了解决这样的问题而出现的。这里只是一个简单的例子，可能描述依赖注入的原理不是很清晰，如果不是很了解的话可以从网上搜索出很多文章。

Dagger2的配置

  • 目录添加apt支持，apt是用于自动生成代码来进行依赖注入的。

项目中的build.gradle添加：

dependencies {classpath 'com.android.tools.build:gradle:2.1.0'classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'// NOTE: Do not place your application dependencies here; they belong// in the individual module build.gradle files}
  • 在module的build.gradle添加：
apply plugin: 'com.neenbedankt.android-apt'android{...}dependencies {provided 'org.glassfish:javax.annotation:10.0-b28'compile 'com.google.dagger:dagger:2.5'compile 'com.google.dagger:dagger-compiler:2.5'
}

例子

这里通过一个例子来向Activity注入一些成员变量。(例子代码来自网上),来说明Dagger2的基本使用。

例子使用的是MVP模式，内容是通过注入一个Presenter，然后通过Presenter来设置TextView显示内容为user.name;

其中User的代码如下：

public class User {public String name;public User(String name) {this.name = name;}
}

Presenter的代码：

public class DaggerPresenter {DaggerActivity activity;User user;public DaggerPresenter(DaggerActivity activity, User user) {this.user = user;this.activity = activity;}public void showUserName() {activity.showUserName(user.name);}
}

现在的场景是有一个DaggerActivity，里面持有一个DaggerPresenter的成员，我们该如何使用Dagger2来注入这个成员呢？

第一步：编写Module

我这里编写了一个ActivityModule，代码如下：

@Module
public class ActivityModule {private DaggerActivity activity;public ActivityModule(DaggerActivity activity) {this.activity = activity;}@Providespublic DaggerActivity provideActivity() {return activity;}@Providespublic User provideUser() {return new User("user form ActivityModule");}@Providespublic DaggerPresenter provideDaggerPresenter(DaggerActivity activity, User user) {return new DaggerPresenter(activity, user);}
}

首先这里编写有一些规则的，类需要用@Module注解来标示，可以看到我这个AcitivtyModule中定义了一个构造函数，需要传进来一个DaggerActivity对象。

首先我们需要明确一个点，就是Module的作用是用来提供生成依赖对象的，比如我要注入DaggerPresenter，那么这个Module的作用就是需要生成一个DaggerPresenter的对象，来让Dagger2注入到DaggerActivity中。

所以我们这里需要编写一个函数provideDaggerPresenter,这个函数可以从上面的代码看出，我们需要对这个函数使用@Provides注解，然后，我们这里需要传入两个参数，一个DaggerActivity，一个User对象。那么，这两个参数从何而来呢?

细心的同学可能会发现，我上面的代码中还定义了两个函数，分别为provideUser和provideActivity，大家猜出点什么没有(嘿嘿)，这里provideDaggerPresenter的两个参数就是通过这两个函数来获取的。如果没有声明这两个函数的话，可能编译期间会报错哟。通过上述内容，各位同学应该明白了Module应该如何编写了吧。

编写Module有以下几个注意点：

  • 类需要用@Module来标明注解
  • 这里有一点规则，用@Provides注解的函数需要以provide开头，然后后面接什么内容都可以，看自己喜欢，事实上，经过我的测试，我把provideActivity()改成provideA()同样是可以注入成功的，所以大家可以知道，这里是根据返回值类型来标识的，方法名并不重要，只需要保证以provide开头即可。
第二步：编写ActivityComponent

请看代码：

@Component(modules = ActivityModule.class)
public interface ActivityComponent {void inject(DaggerActivity daggerActivity);
}

这里的代码够少吧，哈哈，我们编写的这个Component需要用@Component注解来标识，同时声明了modules为上面编写的ActivityComponent,然后提供了一个方法，叫做inject，用来在Activity中注入。(这里为什么要写一个方法叫做inject我暂时还没弄清楚，改名字是可以的，但是参数类型不能改，并且一定要指定module=ActivityModule才能注入)，这里我们暂且理解为提供一个方法来注入对象吧。

第三步：AndroidStudio -> Build -> Make Project

写到这里的时候就可以Make Project了，完成之后apt会自动生成一个以Dagger开头的Component，比如，我们上面写的是ActivityComponent,生成了类名就为DaggerActivityComponent。这个类我们可以直接使用。

第四步，注入Activity中

在第三步中已经生成了一个DaggerActivityComponent了，我们在Activity的onCreated函数中编写如下代码：

 DaggerActivityComponent.builder().activityModule(new ActivityModule(this)).build().inject(this);

可以看到我们首先调用这个了类的builder(),然后调用一些方法。这些方法也有一些规律噢，比如我们的ActivityComponent指定的module是ActivityModule，DaggerActivityComponent就会有一个名为activityModule的方法，我们需要调用它，并传入参数，这里我们直接new了一个ActivityModule进去。

好了，到此为止，我们已经使用Dagger2形成了关联，我们还需要注入Presenter。在Activity中：

@Inject
DaggerPresenter presenter;

我们直接使用注解@Inject就可以对这个成员进行注入了。

下面是我的Activity的完整代码：

public class DaggerActivity extends AppCompatActivity {private static final String TAG = "DaggerActivity";TextView text;@InjectDaggerPresenter presenter;@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_dagger);text = (TextView) findViewById(R.id.text);inject();presenter.showUserName();//Log.i(TAG, "client = " + (client == null ? "null" : client));}private void inject() {DaggerActivityComponent.builder().activityModule(new ActivityModule(this)).build().inject(this);}public void showUserName(String name) {text.setText(name);}
}

上面的代码运行起来的结果就是在DaggerActivity的TextView中显示了一串字符串"user form ActivityModule",虽然例子简单，但是基本上实现了简单依赖注入，希望对于Dagger2的入门有点启发。

好啦，现在我们的项目又有新需求了，我们希望提供一个全局的OkHttpClient和Retrofit对象来进行网络请求，他的生命周期是和APP一致的，这个时候我们就需要定制AppComponent了。

首先我们按照老规矩，第一步先编写Module,一下是ApiModule：

@Module
public class ApiModule {public static final String END_POINT = "http://www.baidu.com";@Provides@SingletonOkHttpClient provideOkHttpClient() {OkHttpClient client = new OkHttpClient.Builder().connectTimeout(60 * 1000, TimeUnit.MILLISECONDS).readTimeout(60 * 1000, TimeUnit.MILLISECONDS).build();return client;}@Provides@SingletonRetrofit provideRetrofit(OkHttpClient client) {Retrofit retrofit = new Retrofit.Builder().client(client).baseUrl(END_POINT).build();return retrofit;}@Provides@SingletonUser provideUser(){return new User("name form ApiProvide");}}

请注意，我这里的provide方法额外添加了一个@SingleTon注解，这里说明是全局单例的对象，而且我这里改动了一小部分代码，把ActivityModule的provideUser移动到这里来了,我这里是为了演示依赖过程。

接下来编写AppComponent了：

@Singleton
@Component(modules = {ApiModule.class})
public interface AppComponent {OkHttpClient getClient();Retrofit getRetrofit();User getUser();
}

这里的AppComponent提供了3个方法，分别用来暴露OkHttpClient、Retrofit和User对象的，这里暂且不提为什么要暴露，大家别急，继续往下看。

第三部就是Make Project了，之后就会生成一个叫做DaggerAppComponent的类，之后我们在MyApplicaiotn中实例化这个Component:

public class MyApplication extends Application {AppComponent appComponent;@Overridepublic void onCreate() {super.onCreate();appComponent = DaggerAppComponent.builder().apiModule(new ApiModule()).build();}public AppComponent getAppComponent() {return appComponent;}}

这里别忘了在AndroidManifest中设置为自定义的MyApplicaiton哦。上面的代码很简单，我们只是实例化了一个AppComponent,然后提供了一个方法用于获取这个Component。

然后我们需要修改一下ActivityComponent，改成下面这样：

@ActivityScope
@Component(modules = ActivityModule.class,dependencies = AppComponent.class)
public interface ActivityComponent {void inject(DaggerActivity daggerActivity);
}

改动的地方呢是添加了一个@ActivityScope然后，添加了一个dependencies = AppComponent.class。没错，Component之间也可以依赖的。

解释一下这个ActivityScope，这里查询了网上的资料之后，据说是可以和Activity的生命周期绑定，没有声明这个注解的话编译会报异常。我暂时无法对这个Scope理解清晰，不做评论。

@Scope
public @interface ActivityScope {
}

最后一步啦，改动DaggerActivity：

public class DaggerActivity extends AppCompatActivity {private static final String TAG = "DaggerActivity";TextView text;@InjectDaggerPresenter presenter;@InjectOkHttpClient client;@InjectRetrofit retrofit;@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_dagger);text = (TextView) findViewById(R.id.text);inject();presenter.showUserName();Log.i(TAG, "client = " + (client == null ? "null" : client));Log.i(TAG, "retrofit = " + (retrofit == null ? "null" : retrofit));}private void inject() {AppComponent appComponent = ((MyApplication) getApplication()).getAppComponent();DaggerActivityComponent.builder().appComponent(appComponent).activityModule(new ActivityModule(this)).build().inject(this);}public void showUserName(String name) {text.setText(name);}
}

可以看到我这里添加了两个注入，分别注入了一个OkHttpClient和一个Retrofit对象，然后在注入的时候也把AppComponent也添加进来了。然后我们先看运行结果，后面我会解释一下整个依赖关系。

运行结果：

Log输出：

    07-13 12:24:46.433 12424-12424/com.sample I/DaggerActivity: client = okhttp3.OkHttpClient@3c53402d07-13 12:24:46.433 12424-12424/com.sample I/DaggerActivity: retrofit = retrofit2.Retrofit@1cce3962

然后在手机上运行的话，TextView会显示"name from ApiProvide",从结果看来我们已经成功注入了这3个对象。

现在估计大家有些疑问。

  • 首先我们看回ActivityComponent：
@Module
public class ActivityModule {private DaggerActivity activity;public ActivityModule(DaggerActivity activity) {this.activity = activity;}@Providespublic DaggerActivity provideActivity() {return activity;}@Providespublic DaggerPresenter provideDaggerPresenter(DaggerActivity activity, User user) {return new DaggerPresenter(activity, user);}
}

这里的provideUser方法已经去掉了，那么根据我前面说的话，那我们需要从哪里获取这个User对象呢。我们看回前面的：

@ActivityScope
@Component(modules = ActivityModule.class,dependencies = AppComponent.class)
public interface ActivityComponent {void inject(DaggerActivity daggerActivity);
}

可以看到这个ActivityComponent是依赖AppComponent的，AppComponent中定义了3个方法：

     OkHttpClient getClient();Retrofit getRetrofit();User getUser();

分别用来提供这三个对象的，这样就可以解释清楚了，他们存在依赖关系，就像我们对象之间的继承一样，值得注意的是这三个方法也是根据返回值类型来识别的，他们会分别找到AppComponent中的module(ApiModule)中的provide方法来获取对象。

这里我们发现一个有趣的现象，首先我们提供这三个方法可以被Activity的成员变量注入(可以看到，我们成功的注入的OkHttpClient和Retrofit)，同时也可以让被依赖的Component(ActivityComponent)所使用.

如果我们不把这三个对象声明在AppComponent中,在编译的过程中就会报异常。在专业术语好像叫做:暴露给子图？

结论

我这里只是对于怎么使用Dagger2来了一个流程，并且做出了一些通俗化的解释。听到很多人说这个Dagger2入门困难，可能是因为需要理解完Dagger2通过APT生成的代码的流程才能完全理解吧。但是我们通常学习一个框架是学会怎么使用，使用过了之后，才会对它的原理进行了解，然而Dagger2的使用起来也并不简单，对于一个没有接触过Dagger1，又没有了解过依赖注入的概念的人来说，一下子需要看明白还是有点难度的。我也是经历了很多次入门到放弃，感觉自己现在也是理解的不太清晰，其实都是猜的（嘿嘿）。总之这篇文章的着重点是为了让大家知道如何使用Dagger2，并没有解释过内部的原理，但是希望这些东西能带给一些想入门Dagger2又感觉难以理解的人一点点启发吧。

Demo源码：https://github.com/Jamlh/Sample/tree/master/app/src/main/java/com/sample/dagger

这篇关于Dagger2 这次入门就不用放弃了的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1096622。

相关文章

Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
数论入门整理（updating）

数论入门整理（updating）

一、gcd lcm 基础中的基础，一般用来处理计算第一步什么的，分数化简之类。 LL gcd(LL a, LL b) { return b ? gcd(b, a % b) : a; } <pre name="code" class="cpp">LL lcm(LL a, LL b){LL c = gcd(a, b);return a / c * b;} 例题：
阅读更多...
Java 创建图形用户界面（GUI）入门指南（Swing库 JFrame 类）概述

Java 创建图形用户界面（GUI）入门指南（Swing库 JFrame 类）概述

概述 基本概念 Java Swing 的架构 Java Swing 是一个为 Java 设计的 GUI 工具包，是 JAVA 基础类的一部分，基于 Java AWT 构建，提供了一系列轻量级、可定制的图形用户界面（GUI）组件。 与 AWT 相比，Swing 提供了许多比 AWT 更好的屏幕显示元素，更加灵活和可定制，具有更好的跨平台性能。 组件和容器 Java Swing 提供了许多
阅读更多...
【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站，手机流量可以访问IPV6网络的服务，为什么不在电脑搭建Home Assistant（hass），来控制你的设备呢？@智能家居 @万物互联
阅读更多...
poj 2104 and hdu 2665 划分树模板入门题

poj 2104 and hdu 2665 划分树模板入门题

题意： 给一个数组n（1e5）个数，给一个范围（fr， to， k），求这个范围中第k大的数。 解析： 划分树入门。 bing神的模板。 坑爹的地方是把-l 看成了-1........ 一直re。 代码： poj 2104： #include <iostream>#include <cstdio>#include <cstdlib>#include <al
阅读更多...
MySQL-CRUD入门1

MySQL-CRUD入门1

文章目录 认识配置文件client节点mysql节点mysqld节点 数据的添加(Create)添加一行数据添加多行数据两种添加数据的效率对比 数据的查询(Retrieve)全列查询指定列查询查询中带有表达式关于字面量关于as重命名 临时表引入distinct去重order by 排序关于NULL 认识配置文件 在我们的MySQL服务安装好了之后, 会有一个配置文件, 也就
阅读更多...
音视频入门基础：WAV专题（10）——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

音视频入门基础：WAV专题（10）——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

一、引言 从文章《音视频入门基础：WAV专题（6）——通过FFprobe显示WAV音频文件每个数据包的信息》中我们可以知道，通过FFprobe命令可以打印WAV音频文件每个packet（也称为数据包或多媒体包）的信息，这些信息包含该packet的pts、dts： 打印出来的“pts”实际是AVPacket结构体中的成员变量pts，是以AVStream->time_base为单位的显
阅读更多...
C语言指针入门 《C语言非常道》

C语言指针入门 《C语言非常道》

C语言指针入门 《C语言非常道》 作为一个程序员，我接触 C 语言有十年了。有的朋友让我推荐 C 语言的参考书，我不敢乱推荐，尤其是国内作者写的书，往往七拼八凑，漏洞百出。 但是，李忠老师的《C语言非常道》值得一读。对了，李老师有个官网，网址是： 李忠老师官网 最棒的是，有配套的教学视频，可以试看。 试看点这里 接下来言归正传，讲解指针。以下内容很多都参考了李忠老师的《C语言非
阅读更多...
MySQL入门到精通

MySQL入门到精通

一、创建数据库 CREATE DATABASE 数据库名称; 如果数据库存在，则会提示报错。 二、选择数据库 USE 数据库名称; 三、创建数据表 CREATE TABLE 数据表名称; 四、MySQL数据类型 MySQL支持多种类型，大致可以分为三类：数值、日期/时间和字符串类型 4.1 数值类型 数值类型 类型大小用途INT4Bytes整数值FLOAT4By
阅读更多...
【QT】基础入门学习

【QT】基础入门学习

文章目录 浅析Qt应用程序的主函数使用qDebug()函数常用快捷键Qt 编码风格信号槽连接模型实现方案 信号和槽的工作机制Qt对象树机制 浅析Qt应用程序的主函数 #include "mywindow.h"#include <QApplication>// 程序的入口int main(int argc, char *argv[]){// argc是命令行参数个数，argv是
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2