前言
dagger2有一个比较重要的特性,就是可以指定依赖在某个相同的生命周期内被注入的是同一个对象。这个和一般的单例不太一样,普通的单例的生命周期是到应用被kill为止,而dagger2中的单例的生命周期可以和Application、Activity、Fragment...各种不同对象的生命周期保持一致,所以也叫局部单例,这篇文章就来聊一聊局部单例
Component的继承/依赖体系
dagger2中依赖的生命周期是由DaggerXXXComponent进行管理的,所以先来看看Component的继承/依赖体系
Component继承/依赖体系的作用
- Component继承体系是为了让每一个层级的Component可以只处理当前层级的依赖,而不用关心下层的依赖,当使用到下层依赖时会从父Component中去找
- Dagger虽然没有硬性规定要如何构建Component的继承体系,但是按照Application-Activity-Fragment这样的结构来更加自然和方便,同时也可以更好的和Android组件的生命周期匹配
- 当然如果要为一个Fragment进行依赖注入,你也可以只定义一个Component,将Application,Activity,Fragment作为builder的参数提供给该Component,但是这样不仅代码会较为繁琐,而且失去了dagger的生命周期管理的能力
Component继承的三种方式
方式1
使用@Subcomponent注解,在父Component中显式暴露获取SubComponent实例的接口
@Subcomponent
public interface ActivityComponent2 {
void inject(SubComponentActivity2 activity);
}
@Component
public interface AppComponent {
//显式声明获取SubComponent的接口
ActivityComponent2 getActivityComponent2();
}
//使用父Component获取SubComponent
getAppCompoent().getActivityComponent2().inject(this);
方式2
使用@Subcomponent注解,在父Component使用的Module中用subcomponents属性指定该Subcomponent
需要在SubComponent中显式声明 Subcomponent.Builder
@Subcomponent
public interface ActivityComponent3 {
void inject(SubComponentActivity3 activity);
//在module中指定subcomponents的Component必须显式地声明 Subcomponent.Builder
@Subcomponent.Builder
interface Builder {
ActivityComponent3 build();
}
}
//在@Module的subcomponents属性中指定SubComponent
@Module(subcomponents = ActivityComponent3.class)
public class AppModule {
}
获取SubComponent有两种方式
- 在父Component中显式的声明Subcomponent,Builder(这样其实和方式1差别不大,还多了一步)
@Component(modules = { AppModule.class})
public interface AppComponent {
ActivityComponent3.Builder getActivityComponent3Builder();
}
//使用父Component获取Subcomponent.Builder
getAppCompoent().getActivityComponent3Builder().build().inject(this);
- 将Subcomponent.Builder看做是父Component提供的一个依赖来处理
- 主要用来实现Activity-Multibinding,后面章节会有介绍,参考文章(在Dagger 2中Activities和Subcomponents的多绑定)
先写个比较简单的将Subcomponent.Builder作为依赖的用法
public class RealApplication{
//直接在Application中注入ActivityComponent3.Builder
@Inject
ActivityComponent3.Builder mBuilder;
...
public ActivityComponent3.Builder getBuilder() {
return mBuilder;
}
}
//从Application中获取Builder完成注入
((RealApplication)getApplication()).getBuilder().build().inject(this);
官方的例子写的更好一些:(subcomponents-for-encapsulation)
方式3
子Component使用@Component标记并通过dependencies属性指定父Component,在父Component显示声明子Component中需要的依赖的接口
@Component(dependencies = AppComponent.class)
public interface ActivityComponent1 {
void inject(SubComponentActivity1 activity);
}
public interface AppComponent {
//如果有component使用dependencies,则需要显式声明可以提供的对象
Integer versionCode();
}
//将父Component作为参数
DaggerActivityComponent1.builder()
.appComponent(getAppCompoent())
.build().inject(this);
这种方式比较不推荐使用,应为底层Component提供的依赖需要手动暴露出来上层才能用,这样比较麻烦
有个值得的注意的点是显式暴露的依赖不能多层传递,即Component1依赖Component2依赖Component3,都使用dependencies指定父Component;Component3显式声明了获取依赖假设是Application application();
,如果Component1需要用到Application,则需要在Component2中也显式声明获取Application的方法
不过这是三种方式中唯一一种从上至下定义依赖关系的方式(在子Component中指定父Component),其他的都是从下至上的(父Component或者父Component的Module中指定子Component),在多个模块的项目中,这是上层模块中Component依赖下层模块中Componnet唯一方式,而需要手动暴露提供依赖的接口也是出于权限控制的考虑
这种方式有个额外的好处是上层的Componnet可以依赖多个底层Component
@Scope
@Scope是一个标记注解的注解,用来定义生命周期相关的注解
@Scope需要Component和依赖提供者配合才能起作用,对于@Scope注解的依赖,Component会持有第一次创建的依赖,后面注入时都会复用这个依赖的实例,实质上@Scope的目的就是为了让生成的依赖实例的生命周期与 Component 绑定
如果Component重建了,持有的@Scope的依赖也会重建,所以为了维护局部单例需要自己维护Component的生命周期
dagger2默认提供了Singleton注解
@Scope
@Documented
@Retention(RUNTIME)
public @interface Singleton {}
参照着写了ActivityScope,AppScope,FragmentScope,当然可以自己加什么ViewScope,ViewModelScope等等,只是改个名字而已
//一个例子
@Scope
@Documented
@Retention(RUNTIME)
public @interface ActivityScope {
}
@Scope的用法
- 用在@Inject注解构造器的类上,而不是构造器上
@SimpleScope
public class SimpleActivityBean extends BaseBean {
Activity mSimpleActivity;
@Inject
public SimpleActivityBean(Activity simpleActivity) {
mSimpleActivity = simpleActivity;
}
}
- 用在@Providers注解的方法上
@Provides
@SimpleScope
public SimpleModuleBean provideSimpleModuleBean() {
return new SimpleModuleBean();
}
-
用在@ContributesAndroidInjector注解的方法上(dagger.android相关,后面章节会提到)
-
用在Component上,与要实现局部单例的依赖进行绑定
局部单例的其他用法
不与Componnet绑定的依赖的复用
上面说的局部单例都是绑定到Componnet中实现复用的,如果只是单纯的想减少依赖创建的次数而不关心和哪个
Component绑定,可以使用@Reusable注解
可释放的局部单例
使用@Scope注解时,Component 会间接持有依赖实例的引用,使得依赖和Componnet具有相同的生命周期,在android中需要尽可能的减少内存占用,这种情况下可以使用@CanReleaseReferences标记@Scope注解。
总结
如果理解了Component的继承/依赖体系,其实@Scope比较好理解
- 一个Componnet只能维护一个生命周期,即该Componnet提供的依赖想要具备局部单例的能力,必须标记和Component相同的@Scope注解
- 具有继承/依赖关系的不同Component需要使用不同的@Scope注解
- Scope 作用域的本质:Component 间接持有依赖实例的引用,把实例的作用域与 Component 绑定,它们不是同年同月同日生,但是同年同月同日死。
- 实现局部单例需要在对应的生命周期里只创建一个Component,例如在Application中AppComponent只创建一次,其他的子Component的创建都基于这一个AppComponent实例完成
相关文章
dagger2从入门到放弃-概念
dagger2从入门到放弃-最基础的用法介绍
dagger2从入门到放弃-Component的继承体系、局部单例
dagger2从入门到放弃-ActivityMultibindings
dagger2从入门到放弃-dagger.android
dagger2从入门到放弃-其他用法
dagger2从入门到放弃-多模块项目下dagger的使用
dagger2从入门到放弃-为何放弃
示例代码
DaggerInAction
欢迎star
master分支上最新的代码可能会比当前文章的示例代码稍微复杂点,提交记录里包含了每一步的迭代过程,可以顺藤摸瓜
网友评论