Dagger:Android上的依赖注入框架

* 你也可以去Github查看这片文章

10年积累的成都做网站、网站建设经验,可以快速应对客户对网站的新想法和需求。提供各种问题对应的解决方案。让选择我们的客户得到更好、更有力的网络服务。我虽然不认识你,你也不认识我。但先网站设计后付款的网站建设流程,更有玉溪免费网站建设让你可以放心的选择与我们合作。

简介

在开发程序的时候,会用到各种对象,很多对象在使用之前都需要进行初始化。例如你要操作一个SharedPreference,你需要调用getSharedPreferences(String name,int mode)来获取一个对象,然后才能使用它。而如果这个对象会在多个Activity中被使用,你就需要在每个使用的场景中都写下同样的代码。这不仅麻烦,而且增加了出错的可能。Dagger的用途就是:让你不需要初始化对象。换句话说,任何对象声明完了就能直接用。

原理

dagger是使用依赖注入的方式,使用Annotation给需要注入的对象做标记,通过inject()方法自动注入所有对象,从而完成自动的初始化。
示例代码:

 
 
 
  1. public class MainActivity extends Activity {  
  2.     // 通过@Inject对对象进行标记  
  3.     @Inject SharedPreferences sharedPreferences;  
  4.  
  5.     @Override 
  6.     protected void onCreate(Bundle savedInstanceState) {  
  7.         super.onCreate(savedInstanceState);  
  8.         setContentView(R.layout.activity_main);  
  9.  
  10.         // 注入依赖  
  11.         ObjectGraph.create(AppModule.class).inject(this);  
  12.  
  13.         // 获取name的值并输出  
  14.         System.out.println(sharedPreferences.getString("name", ""));  
  15.     }  
  16. }  

依赖注入(Dependency Injection):在类A中要用到一个B的对象(依赖),需要通过新建B的实例或其他一些主动的方式来获取对象,然后才能调用。而通过外部的方式自动将B的对象分配给A(注入),实现相对被动的获取对象,这个过程称为依赖注入。希望更多了解依赖注入可以自行Google。

使用方式

以一个简单的“老板和程序员”App为例。你想实现Boss对象的自动注入,那么首先你要告诉程序它要怎么初始化一个Boss。在dagger中,为Boss类的构造方法添加一个@Inject注解,程序就会在需要的时候找到这个被标记的构造方法并调用它,从而获取一个Boss对象。

 
 
 
  1. public class Boss {  
  2.     ...  
  3.  
  4.     @Inject 
  5.     public Boss() {  
  6.         ...  
  7.     }  
  8.  
  9.     ...  
  10. }  

需要注意的是,如果构造函数含有参数,Dagger会在构造对象的时候先去获取这些参数(不然谁来传参?),所以你要保证这些参数的构造方法也有@Inject标记,或者能够通过@Provides注解(下面会介绍)来获取到。

然后,在声明Boss对象的时候,在前面同样添加@Inject注解。程序会在依赖注入的过程中自动初始化被注解的对象。

 
 
 
  1. public class MainActivity extends Activity {  
  2.     @Inject Boss boss;  
  3.     ...  
  4. }  

***,创建ObjectGraph类并执行inject()方法并将当前MainActivity作为参数传入,Boss的对象就被注入到了MainActivity中。

 
 
 
  1. public class MainActivity extends Activity {  
  2.     @Inject Boss boss;  
  3.  
  4.     @Override 
  5.     protected void onCreate(Bundle savedInstanceState) {  
  6.         ObjectGraph.create(AppModule.class).inject(this);  
  7.     }  
  8.     ...  
  9. }  

到此为止,使用Dagger将一个Boss对象注入到MainActivity的流程就完成了。上面这段代码中出现了两个类:ObjectGraph和AppModule。其中ObjectGraph是由Dagger提供的类,可以简单理解为一个工具类,它的create函数中参数为所有的Module,本文不详述,如果有兴趣可以跟进我之后的Dagger详解。AppModule是一个自定义类,代码如下:

 
 
 
  1. @Module(injects = MainActivity.class)  
  2. public class AppModule {  
  3. }  

可以看到,AppModule是一个空类,只有一行注解。@Module注解表示,这个类是一个Module,Module的作用是提供信息,让ObjectGraph知道应该怎样注入所有的依赖。例如,上面这段代码中声明了可注入对象的信息:MainActivity.class(使用显式声明这样的看起来很麻烦、多此一举的方式和Dagger的原理有关,本文不详述)。

自定义依赖

对构造方法进行注解是很好用的实现依赖的途径,然而它并不适用于所有情况。

  • 接口(Interface)是没有构造方法的
  • 第三方库提供的类,它们的构造方法不能被注解
  • 有些类需要灵活选择初始化的配置,而不是使用一个单一的构造方法

对于这样的情况,可以使用@Provides注解来提供专用的初始化方法,实现自定义依赖。

 
 
 
  1. @Provides 
  2. Coder provideCoder(Boss boss) {  
  3.     return new Coder(boss);  
  4. }  

同样,@Provides注解的方法如果含有参数,它的所有参数也要保证能够被Dagger获取到。

所有带有@Provides注解的方法都需要被封装到带有@Module注解的类中:

 
 
 
  1. @Module 
  2. public class AppModule {  
  3.     @Provides 
  4.     Coder provideCoder(Boss boss) {  
  5.         return new Coder(boss);  
  6.     }  
  7. }  

#p#

单例

Dagger支持单例,实现方式也十分简单:

 
 
 
  1. // @Inject注解构造方法的单例模式  
  2. @Singleton 
  3. public class Boss {  
  4.     ...  
  5.  
  6.     @Inject 
  7.     public Boss() {  
  8.         ...  
  9.     }  
  10.  
  11.     ...  
 
 
 
  1. ```java  
  2. // @Provides注解提供初始化方法的单例模式  
  3. @Provides 
  4. @Singleton 
  5. Coder provideCoder(Boss boss) {  
  6.     return new Coder(boss);  
  7. }  

通过上面的方法添加@Singleton注解之后,对象只会被初始化一次,之后的每次都会被直接注入相同的对象。

Qualifier(限定符)

如果有两类程序员,他们的能力值power分别是5和1000,应该怎样让Dagger对他们做出区分呢?使用@Qualifier注解

首先,创建一个@interface:

 
 
 
  1. @Qualifier 
  2. @Documented 
  3. @Retention(RUNTIME)  
  4. public @interface Level {  
  5.   String value() default "";  

然后,为这两类程序员分别设置@Provides方法,并使用@Qualifier对他们做出不同的标记:

 
 
 
  1. @Provides @Level("low") Coder provideLowLevelCoder() {  
  2.     Coder coder = new Coder();  
  3.     coder.setName("战五渣");  
  4.     coder.setPower(5);  
  5.     return coder;  
  6. }  
  7.  
  8. @Provides @Level("high") Coder provideHighLevelCoder() {  
  9.     Coder coder = new Coder();  
  10.     coder.setName("大神");  
  11.     coder.setPower(1000);  
  12.     return coder;  
  13. }  

***,在使用的时候也用上相应的@Qualifier注解。

 
 
 
  1. @Inject @Level("low") Coder lowLevelCoder;  
  2. @Inject @Level("high") Coder highLevelCoder;  

编译时检查

实质上,Dagger会在编译时对代码进行检查,并在检查不通过的时候报编译错误(为什么?这和Dagger的原理有关,有兴趣的话可以关注我之后发布的Dagger详解)。检查内容主要有三点:

  1. 所有含有依赖注入的类,需要被显式 声明在相应的Module中。
  2. 一个Module中所有@Provides方法的参数都必须在这个Module种提供相应的@Provides方法,或者在@Module注解后添加“complete = false”注明这是一个不完整Module(即它会被其他Module所扩展)。
  3. 一个Module中所有的@Provides方法都要被它声明的注入对象所使用,或者在@Module注解后添加“library = ture”注明(即它是为了扩展其他Module而存在的)。

如果需要对Dagger有更多了解,可以参看官方文档,或者关注我之后的详解文章。

另外,我们公司友邻小区招聘Android开发一名,地址北京海淀紫竹桥。

我的Github地址:https://github.com/rengwuxian

本文出自:http://my.oschina.net/rengwuxian/blog/287892

分享题目:Dagger:Android上的依赖注入框架
本文URL:http://www.shufengxianlan.com/qtweb/news19/1369.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联