本篇文章为大家展示了Android中怎么利用Dagger2实现依赖注入,内容简明扼要并且容易理解,绝对能使你眼前一亮,通过这篇文章的详细介绍希望你能有所收获。
1. Dagger2 基础
注解讲解:
@Module这个annotation修饰的类专门用来提供依赖
@Provides这个annotation修饰的方法用在Module类里
@Inject用来annotation一个依赖(可以是构造方法、field或者一般的方法)
@Component连接@Module和注入的桥梁
这些名词看起来非常抽象。下面稍微解释一下。依赖反射并没有什么神奇的地方。只不过是我们需要单独写初始化依赖的地方由其他的框架代替了。这个依赖关系也有我们常写的代码转移到了“配置文件”中。
在很久以前,依赖注入的框架就是这样处理依赖注入的:读取配置文件的依赖关系,然后用反射的方法初始化被依赖对象并赋值给调用依赖的对象。比如,我们之前在悟空类中初始化金箍棒:
public class Wukong { private Jingubang jingubang; public Wukong(){ // 依赖 this.jingubang = Jingubang(); } }
后来有了使用配置文件的依赖注入(这里都是虚构的文件格式):
<xml> <com.xiyou.Wukong> <dependency field="jingubang"> <com.xiyou.Jingubang /> </dependency> </com.xiyou.Wukong> </xml>
在悟空使用金箍棒的时候,依赖注入框架自动初始化好了金箍棒,并赋值给了悟空。
现在使用Dagger2。这里就有不得不说的牛X的地方了。因为是在Android里能用的资源没有后端那么多。尤其反射消耗比较大!所以Dagger为了满足移动开发节约资源的需要,没有使用反射实现依赖注入。而是在编译的时候同时生成依赖注入的相关代码。生成代码的根据就是前文中说明的那些注解(annotation)以及使用这些annotation的类、接口。
总结起来就一句话,Dagger把你需要在悟空类里写的金箍棒类的初始化代码都根据注解替你自动生成了!只不过这种生成的代码比明晃晃的使用new初始化的方法更加复杂一些。
Dagger2 开发步骤
把大象装冰箱一共分几步:
定义依赖和被依赖的对象的类,悟空类和金箍棒类。“悟空类”和“金箍棒类”的构造函数用@Inject注解修饰。
定义一个@Module注解的类,一般叫做XXXModule。里面写的@Provides注解修饰的方法。这些@Provides方法返回“悟空类”和“金箍棒类”对象。比如@Provides Wukong provideWukong(){ return new Wukong(); }
创建一个interface,并用@Component注解修饰。一般叫做XXXComponent。里面写一个注入方法:void inject(Wukong wk);。这里Wukong只是一个例子。任何你准备要注入的类都可以代替上面参数的Wukong类。
在需要注入的地方写@Inject的field。
***,Dagger会根据上面的内容和***的@Component接口生成一个DaggerXXXComponent的类型,使用这个类型来实现注入。上面的1到3步可以理解为依赖的配置。***的XXXComponent代替古老的Reflect方式实现注入。
***步的@Inject修饰的构造函数和`@Module`的`provideXXX`方法二者可以省略一个。
Dagger可以根据其中的任意一种配置创建依赖的对象。都写上等于有了双保险。
上文提到过多次。Dagger 2厉害的地方就在于这个库完全不用反射,而是用在编译期生成代码的方式实现的依赖注入。这个特点导致在Android Studio配置的时候需要做一些额外的工作。
这里假设你已经创建了一个新的Android应用项目。下面打开build.gradle文件,我们一步一步的来完成Dagger2的配置。
3. Android Studio的配置
***步
apply plugin: 'kotlin-android' // 非必须 apply plugin: 'kotlin-android-extensions' // 必须!!!
为什么要加一个新的plugin呢?这个是为后面使用的kapt和provided提供支持的。gradle本身不支持这两个操作。
第二步
buildscript { ext.kotlin_version = '1.0.1-2' repositories { mavenCentral() } dependencies { classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" classpath "org.jetbrains.kotlin:kotlin-android-extensions:$kotlin_version" } }
第三步
dependencies { // ...其他略... compile 'com.google.dagger:dagger:2.2' kapt 'com.google.dagger:dagger-compiler:2.2' provided 'javax.annotation:jsr250-api:1.0' }
dagger, 我们要用的正主。
dagger-compiler, 用来生成代码。
java.annotation, 提供Dagger意外的注解
***,同步Gradle。
使用Dagger 2
下面就是Dagger一展身手的时候了。
首先,我们已经有悟空和金箍棒了。代码如下:
悟空:
import javax.inject.Inject; /** * Created by uncle_charlie on 6/4/2016. */ public class Wukong { @Inject JinGuBang jinGuBang; @Inject public Wukong() { } public String useJinGuBang() { return this.jinGuBang.use(); } }
金箍棒:
import javax.inject.Inject; /** * Created by uncle_charlie on 6/4/2016. */ public class JinGuBang { @Inject public JinGuBang() { } public String use() { return "user Jing gu bang"; } }
悟空对金箍棒有依赖,所以金箍棒属性有@Inject注解修饰。
因为两个类都需要Dagger创建,所以在构造函数上都有@Inject注解。
第二步 创建@Module类
创建@Module注解的类,并在其中添加@Provides注解修饰的方法。这些方法创建被依赖的对象。
import dagger.Module; import dagger.Provides; /** * Created by uncle_charlie on 6/4/2016. */ @Module public class XiYouModule { @Provides // @Singleton Wukong provideWukong() { return new Wukong(); } @Provides // @Singleton JinGuBang provideJinGuBang() { return new JinGuBang(); } }
@Singleton注解表明,这个被依赖的对象在应用的生命周期里只有一个实例。
这个里的@Provides方法和前一步说到的@Inject注解的构造函数两个可以只写一个。
第三步 @Component接口,连接@Module和@Inject
@Module和@Provides方法提供了被依赖的对象。@Inject在@Component接口出现的地方则是指明了需要注入的地方(一般是一个field)。@Component接口就是用来把他们连接起来的。
import android.app.Activity; import javax.inject.Singleton; import dagger.Component; /** * Created by uncle_charlie on 6/4/2016. */ @Component(modules = {XiYouModule.class}) @Singleton public interface XiYouComponent { void inject(Wukong wk); void inject(Activity a); }
其中inject()方法里使用的对象,就是包含@Inject的field的需要注入的对象。
在这个接口中也可以不用inject()方法,而使用provideXXX()方法后面会有更多介绍。
注意:@Component接口一定要在直接中指明@Module类型
第四步 使用@Component接口获取对象
经过前面的步骤,依赖和被依赖对象关系都已经配置好了。下面就来获取被依赖对象来注入依赖对象。
public class MainActivity extends AppCompatActivity { private static final String TAG = "##MainActivity"; @Inject Wukong wukong; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); TextView welcomeTextView = (TextView) findViewById(R.id.welcome_textview); // 1 XiYouComponent xiYouComponent = DaggerXiYouComponent .builder() // 2 .xiYouModule(new XiYouModule()) .build(); xiYouComponent.inject(this); // 3 welcomeTextView.setText(wukong.useJinGuBang()); } }
首先主要到属性@Inject Wukong wukong;已经在MainActivity 声明了。这里表明一个依赖关系:这个activity依赖于悟空,并准备注入悟空对象。
Dagger2会在编译器自动生成依赖注入的代码,所以在添加上面的代码之前需要编译一下。DaggerXiYouComponent就是Dagger根据我们的XiYouModule类生成的代码。
在这一步给DaggerXiYouComponent的builder添加XiYouModule的实例。如果这个Module只需要用到无参构造函数的话可以用一种省略用法:create()方法。可以简写为:
DaggerXiYouComponent .builder() // 2 //.xiYouModule(new XiYouModule()) //.build() .create();
Component接口的对象调用inject(this)方法之后注入即完成。所以可以直接使用@Inject Wukong wukong;属性来调用方法:welcomeTextView.setText(wukong.useJinGuBang());***在activity中显示方法返回的文字。
上述内容就是Android中怎么利用Dagger2实现依赖注入,你们学到知识或技能了吗?如果还想学到更多技能或者丰富自己的知识储备,欢迎关注亿速云行业资讯频道。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。