在上一篇博客中总结了依赖注入的原理与实现方式。 依赖注入的原理
依赖注入就是将调用者需要的另一个对象实例不在调用者内部实现,而是通过一定的方式从外部传入实例,解决了各个类之间的耦合。
那么这个外部,到底指的是哪里,如果指的是另一个类,那么,另一个类内部不就耦合了。能不能有一种方式,将这些构造的对象放到一个容器中,具体需要哪个实例时,就从这个容器中取就行了。那么,类的实例和使用就不在有联系了,而是通过一个容器将他们联系起来。实现了解耦。这个容器,便是Dagger2。
Dagger2是Google出的依赖注入框架。肯定有小伙伴疑问,为什么会有个 2 呢。该框架是基于square开发的dagger基础上开发的。
Dagger2的原理是在编译期生成相应的依赖注入代码。这也是和其他依赖注入框架不同的地方,其他框架是在运行时期反射获取注解内容,影响了运行效率。
使用Dagger2之前需要一些配置,该配置是在Android Studio中进行操作。
在工程的build.gradle文件中添加android-apt插件(该插件后面介绍)
buildscript { .... dependencies { classpath 'com.android.tools.build:gradle:2.1.0' // 添加android-apt 插件 classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' } } 123456789101112 123456789101112在app的中的build.gradle文件中添加配置
apply plugin: 'com.android.application' // 应用插件 apply plugin: 'com.neenbedankt.android-apt' android { compileSdkVersion 23 buildToolsVersion "23.0.2" defaultConfig { applicationId "com.mahao.alex.architecture" minSdkVersion 15 targetSdkVersion 23 versionCode 1 versionName "1.0" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } } dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) testCompile 'junit:junit:4.12' compile 'com.android.support:appcompat-v7:23.3.0' // dagger 2 的配置 compile 'com.google.dagger:dagger:2.4' apt 'com.google.dagger:dagger-compiler:2.4' compile 'org.glassfish:javax.annotation:10.0-b28'// 添加java 注解库 } 1234567891011121314151617181920212223242526272829303132333435 1234567891011121314151617181920212223242526272829303132333435以上两个配置就可以了。
android-apt是Gradle编译器的插件,根据其官方文档,主要两个目的:
编译时使用该工具,最终打包时不会将该插件打入到apk中。
能够根据设置的源路径,在编译时期生成相应代码。
在导入类库时,
compile 'com.google.dagger:dagger:2.4' apt 'com.google.dagger:dagger-compiler:2.4' 123 123dagger是主要的工具类库。dagger-compiler为编译时期生成代码等相关的类库。
在android-apt的文档中,也推荐使用这种方式。因为,编译时期生成代码的类库在运行期并不需要,那么将其分为两个库,(运行类库dagger)和(编译器生成代码类库(dagger-compiler)),那么在打包时,就不需要将dagger-compiler打入其中(用不到),减小APK 的大小。
Dagger2的使用,需要大量的学习成本,不是很能够容易的上手并使用。该博客将从简单入手,尽可能的使用简单的例子演示Dagger2的功能。
一个东西需要先会用,然后才更好的学习原理。该篇博客的目的主要是讲解如何使用。后面会有专门的分析源码的博客。
在之前的分析中,通过Dagger2的目的是将程序分为三个部分。 - 实例化部分:对象的实例化。类似于容器,将类的实例放在容器里。 - 调用者:需要实例化对象的类。 - 沟通桥梁:利用Dagger2中的一些API 将两者联系。
先看实例化部分(容器),在此处是Module。
@Module //提供依赖对象的实例 public class MainModule { @Provides // 关键字,标明该方法提供依赖对象 Person providerPerson(){ //提供Person对象 return new Person(); } } 12345678910111213 12345678910111213沟通部分Component
@Component(modules = MainModule.class) // 作为桥梁,沟通调用者和依赖对象库 public interface MainComponent { //定义注入的方法 void inject(MainActivity activity); } 12345678 12345678使用者Actvity中调用。
public class MainActivity extends AppCompatActivity{ @Inject //标明需要注入的对象 Person person; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 构造桥梁对象 MainComponent component = DaggerMainComponent.builder().mainModule(new MainModule()).build(); //注入 component.inject(this); } } 123456789101112131415161718 123456789101112131415161718看一下Person类
public class Person { public Person(){ Log.i("dagger","person create!!!"); } } 123456789 123456789最后结果不在演示。其过程如下:
创建Component(桥梁),并调用注入方法。 // 构造桥梁对象 MainComponent component = DaggerMainComponent.builder().mainModule(new MainModule()).build(); //注入 component.inject(this); 12345 12345 查找当前类中带有@Inject的成员变量。 @Inject //标明需要注入的对象 Person person; 123 123 根据成员变量的类型从Module中查找哪个有@Provides注解的方法返回值为当前类型。 @Provides // 关键字,标明该方法提供依赖对象 Person providerPerson(){ //提供Person对象 return new Person(); } 123456 123456
在使用过程出现了很多注解:
@Module:作为实例对象的容器。@Provides:标注能够提供实例化对象的方法。@Component:作为桥梁,注入对象的通道。@Inject:需要注入的方法如上使用有一种变通,修改MainModule和Person类。
@Module //提供依赖对象的实例 public class MainModule { /* @Provides // 关键字,标明该方法提供依赖对象 Person providerPerson(){ //提供Person对象 Log.i("dagger"," from Module"); return new Person(); } */ } 123456789101112131415 123456789101112131415 public class Person { @Inject // 添加注解关键字 public Person(){ Log.i("dagger","person create!!!"); } } 123456789 123456789将Module中的providePerson()方法注释,在Person中添加@Inject注解,依然能够实现。
逻辑如下: - 先判断Module中是否有提供该对象实例化的方法。 - 如果有则返回。结束。 - 如果没有,则查找该类的构造方法,是否有带有@Inject的方法。如过存在,则返回。
假如,对于同一个对象,我们需要注入两次,如下方式
public class MainActivity extends AppCompatActivity{ @Inject Person person; @Inject Person person2; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 构造桥梁对象 MainComponent component = DaggerMainComponent.builder().mainModule(new MainModule()).build(); //注入 component.inject(this); // 打印两个对象的地址 Log.i("dagger","person = "+ person.toString()+"; person2 = "+ person2.toString()); } } 1234567891011121314151617181920212223 1234567891011121314151617181920212223看一下结果:
person = com.mahao.alex.architecture.dagger2.Person@430d1620; person2 = com.mahao.alex.architecture.dagger2.Person@430d17c8 12 12可见两个对象不一致。也就是说创建了两个对象。
可以在提供实例化对象的方法上添加@Singleton注解
@Provides // 关键字,标明该方法提供依赖对象 @Singleton Person providerPerson(){ return new Person(); } 1234567 1234567同时,对于MainComponent也需要添加注解,不添加会无法编译
@Singleton @Component(modules = MainModule.class) // 作为桥梁,沟通调用者和依赖对象库 public interface MainComponent { //定义注入的方法 void inject(MainActivity activity); } 1234567 1234567此时在Log,会发现两个对象的地址一样,可见是同一个对象。
person = com.mahao.alex.architecture.dagger2.Person@4310f898; person2 = com.mahao.alex.architecture.dagger2.Person@4310f898 1 1那么不同的Activity之间,能否保持单例呢?
创建一个新的Activity,代码如下:
public class Main2Actvity extends AppCompatActivity { @Inject Person person; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 构造桥梁对象 MainComponent component = DaggerMainComponent.builder().mainModule(new MainModule()).build(); //注入 component.inject(this); Log.i("dagger","person = "+ person.toString()); } } 1234567891011121314151617181920 1234567891011121314151617181920结果如下:
person create!!! person = com.mahao.alex.architecture.dagger2.Person@4310f898; person2 = com.mahao.alex.architecture.dagger2.Person@4310f898 person create!!! person = com.mahao.alex.architecture.dagger2.Person@43130058 1234 1234可见,@Singleton只对一个Component有效,即其单例所依赖Component对象。
Person的构造方法发生了变化,需要传入一个Context,代码如下:
public class Person { private Context mContext; public Person(Context context){ mContext = context; Log.i("dagger","create"); } } 1234567891011 1234567891011这样的话,我们需要修改MainModule
@Module //提供依赖对象的实例 public class MainModule { private Context mContext; public MainModule(Context context){ mContext = context; } @Provides Context providesContext(){ // 提供上下文对象 return mContext; } @Provides // 关键字,标明该方法提供依赖对象 @Singleton Person providerPerson(Context context){ return new Person(context); } } 1234567891011121314151617181920212223242526 1234567891011121314151617181920212223242526 修改providerPerson方法,传入Context对象。添加providesContext(),用以提供Context对象。看一下使用
// 构造桥梁对象 MainComponent component = DaggerMainComponent.builder().mainModule(new MainModule(this)).build(); //注入 component.inject(this); 123456 123456逻辑:
根据@Inject注解,查找需要依赖注入的对象。从MainModule中根据返回值,找到providerPerson(Context context)对象。发现其需要传入参数Context,找到moudule中具有返回值为Context的方法providesContext()。最后就成功的构建了实例化对象。可能会有疑问,我既然module中已经保存了Context对象,那么为什么不直接使用Context对象呢,因为解耦,如果使用了保存的对象,会导致下次Context获取发生变化时,需要修改providerPerson(Context context)中的代码。
在编写Module中,不能出现传入参数和返回参数一致的情况,会导致死循环。
很容易理解,需要的和获取的是同一个方法,循环调用。
在使用中,往往会有依赖另一个组件的情况。比如,在AppMoudle中能够提供Context对象,如下:
@Module public class AppModule { private Context mContext; public AppModule(Context context){ mContext = context; } @Provides Context providesContext(){ // 提供Context对象 return mContext; } } 1234567891011121314151617 1234567891011121314151617而在另一个Module中需要依赖Context对象,那么怎么写呢?
首先编写当前AppModule的Component类
/** * * 全局的Component 组件 * Created by MH on 2016/7/18. */ @Component(modules = AppModule.class) public interface AppComponent { // 向其下层提供Context 对象 Context proContext(); } 12345678910111213 12345678910111213在此种,因为Module中需要向下层提供Context对象,而其与下层的联系时通过Component ,所以需要在这里声明一个其所提供对象的方法。以便下层Module获取。
/** * * 下层Module类 * Created by MH on 2016/7/18. */ @Module public class ActivityMoudule { @Provides Person providePerson(Context context){ // 此方法需要Context 对象 return new Person(context); } } 12345678910111213141516 12345678910111213141516 /** * 子的Component * Created by MH on 2016/7/18. */ @Component(dependencies = AppComponent.class,modules = ActivityMoudule.class) public interface ActivityComponent { // 注入 void inject(MainActivity activity); } 1234567891011 1234567891011在子Component中,有一句关键的注解dependencies = AppComponent.class,添加了上层依赖。
看一下使用
// 依赖对象 Component AppComponent appCom = DaggerAppComponent.builder().appModule(new AppModule(this)).build(); // 子类依赖对象 ,并注入 DaggerActivityComponent.builder() .appComponent(appCom) .activityMoudule(new ActivityMoudule()) .build() .inject(this); 1234567891011 1234567891011在其中使用过程中,有很重的两点。
父依赖的Component中需要添加提供对象的接口。子依赖的Component中的注解中添加dependencies = AppComponent.class。在使用中,会出现两个方法返回对象相同时的情况,那么如何区分呢。
Person对象具有两个构造方法,根据不同的参数值构造不同的方法。
public class Person { private Context mContext; public Person(Context context){ mContext = context; Log.i("dagger","create"); } public Person(String name){ Log.i("dagger",name); } } 1234567891011121314 1234567891011121314ActivityModule中添加@Named标记
@Module public class ActivityMoudule { @Named("Context") // 通过context创建Person 对象 @Provides Person providePersonContext(Context context){ // 此方法需要Context 对象 return new Person(context); } @Named("name") // 通过name创建Person 对象 @Provides Person providePersonName(){ // 此方法需要name return new Person("1234"); } } 12345678910111213141516171819 12345678910111213141516171819使用时,也需要添加此标记
public class MainActivity extends AppCompatActivity{ @Named("context") // 标记 @Inject Person person; @Named("name") // 标记 @Inject Person person2; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //注入 component.inject(this);*/ // 依赖对象 Component AppComponent appCom = DaggerAppComponent.builder().appModule(new AppModule(this)).build(); // 子类依赖对象 ,并注入 DaggerActivityComponent.builder() .appComponent(appCom) .activityMoudule(new ActivityMoudule()) .build() .inject(this); } } 123456789101112131415161718192021222324252627282930313233 123456789101112131415161718192021222324252627282930313233使用时,使用者的@Inject上,必须要加入注解@Named("xxx"),不然编译期会报错。
这样使用过程中,虽然解决了问题,但是通过字符串标记一个对象,容易导致前后不匹配,可以通过自定义注解的方式解决。
添加两个注解,分别对应Context和name。
@Qualifier // 关键词 @Retention(RetentionPolicy.RUNTIME) // 运行时仍可用 public @interface PersonForContext { // Context 对象的注解 } 12345 12345 @Qualifier @Retention(RetentionPolicy.RUNTIME) public @interface PersonForName { // name 对象的注解 } 12345 12345在使用@Named("")的地方替换为上面的注解
@PersonForContext // 通过context创建Person 对象 @Provides Person providePersonContext(Context context){ // 此方法需要Context 对象 return new Person(context); } @PersonForName // 通过name创建Person 对象 @Provides Person providePersonName(){ // 此方法需要Context 对象 return new Person("123"); } 123456789101112131415 123456789101112131415注入时:
@PersonForContext // 标记 @Inject Person person; @PersonForName // 标记 @Inject Person person2; 123456789 123456789在前面中提到@Singleton注解,该注解能够使同一个Component中的对象保持唯一,即单例。
回忆一下,如下方式:
@Provides // 关键字,标明该方法提供依赖对象 @Singleton Person providerPerson(Context context){ return new Person(context); } 123456 123456Module中,对应方法中添加@Singleton注解,同时其所在的Component中,类生命上也需要添加注解
@Singleton @Component(modules = MainModule.class) // 作为桥梁,沟通调用者和依赖对象库 public interface MainComponent { } 12345 12345如果我们看这个意思,感觉其内部应该做了很多的实现,用以达到单例。其实,没我们想的那么复杂。
看一下@Singleton的实现
@Scope //注明是Scope @Documented //标记在文档 @Retention(RUNTIME) // 运行时级别 public @interface Singleton {} 12345 12345通过@Scope定义的一个新的注解。
在之前的,我们知道该单例是依托于他所在的Component组件。那么我们是否可以这样理解,因为方法上添加的@Scope标记的注解和Component上添加的@Scope标记的注解相同(确实相同,同为@Singleton),就表明了该方法提供的实例对象在Component保持唯一。保持唯一的条件是通过@Scope标记的注解相同。
通过在上面的依赖层级上,Android中通常定义两个生命周期。
全局的生命周期PerApp
/** * 全局的生命周期单例 */ @Scope @Documented @Retention(RetentionPolicy.RUNTIME) public @interface PerApp { } 12345678910 12345678910在使用中完全和@Singleton相同。
@Module public class AppModule { private Context mContext; public AppModule(Context context){ mContext = context; } @Provides @PerApp // 添加该标记表明该方法只产生一个实例 Context providesContext(){ // 提供上下文对象 return mContext; } } 123456789101112131415161718 123456789101112131415161718 @PerApp // 因为Module 中使用了该标记,所以需要在此添加 @Component(modules = AppModule.class) public interface AppComponent { // 向其下层提供Context 对象 Context proContext(); } 12345678 12345678因为单例的依托于他所在的Component中,所以需要在Application中进行实例化。
public class App extends Application { // 为什么可以使用静态 public static AppComponent appComponent; @Override public void onCreate() { super.onCreate(); // 实例化 appComponent = DaggerAppComponent.builder().appModule(new AppModule(this)).build(); } } 12345678910111213141516 12345678910111213141516为什么可以使用静态的,因为该AppComponent对象的生命周期是整个App。那么在使用中,其所在Module中的实例化对象,可以保持全局单例。
一个Activity的生命周期PerActivity
有全局的单例,而对于一个Activity,他也有些对象需要保持单例。我们需要定义该注解。
/** * Activity 单例生命周期 */ @Scope @Documented @Retention(RetentionPolicy.RUNTIME) public @interface PerActivity { } 123456789 123456789会发现,除了定义名不一样,其余都和PerApp一样。在前面,说过这样一句话:保持唯一的条件是通过@Scope标记的注解相同。
@Module public class ActivityMoudule { @PersonForContext @Provides @PerActivity // 添加标记,生命其所构造的对象单例 Person providePersonContext(Context context){ // 此方法需要Context 对象 return new Person(context); } ..... } 1234567891011121314 1234567891011121314 @PerActivity // ActivityMoudule 中使用了该标记 @Component(dependencies = AppComponent.class,modules = ActivityMoudule.class) public interface ActivityComponent { // 注入 void inject(MainActivity activity); } 123456789 123456789使用方式,因为其所保持的单例是在Activity中,具体使用如下。
public class MainActivity extends AppCompatActivity{ @PersonForContext // 标记 @Inject Person person; @PersonForName // 标记 @Inject Person person2; /** * 不使用静态的,因为该Component只是针对于该Activity,而不是全局的 */ ActivityComponent activityComponent; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); activityComponent = DaggerActivityComponent.builder() .appComponent(App.appComponent) // 添加了全局的AppComponent组件,可以使用全局的实例化对象 .activityMoudule(new ActivityMoudule()) .build(); activityComponent.inject(this); 12345678910111213141516171819202122232425262728293031323334 12345678910111213141516171819202122232425262728293031323334对于具有依赖关系的Component,不能使用相同的Scope,如果使用相同的会带来语意不明