Scope(作用域)
@Scope
@Documented
@Retention(RUNTIME)
public @interface Singleton{}
可以看到定义一个Scope注解,必须添加以下三部分:
@Scope :注明是Scope
@Documented :标记在文档
@Retention(RUNTIME) :运行时级别
Dagger2可以通过自定义Scope注解,来限定通过Module和Inject方式创建的类的实例的生命周期能够与目标类的生命周期相同。或者可以这样理解:通过自定义Scope注解可以更好的管理创建的类实例的生命周期。
- 在Module中定义创建全局类实例的方法
- ApplicationComponent管理Module
- 保证ApplicationComponent只有一个实例(在app的Application中 实例化ApplicationComponent)。
dagger2中正真创建单例的方法就是上面的步骤,全局类实例的生命周期也和Application一样了,很关键的一点就是保证ApplicationComponent是只初始化一次。所以说光一个singleton并没有创建单例的能力,singleton的作用只有更好的管理ApplicationComponent和Module之间的关系,保证ApplicationComponent和Module是匹配的。若ApplicationComponent和Module的Scope是不一样的,则在编译时报错。代码可读性,让开发人员更好的了解Module中创建的类实例是单例。
Scope用于局部范围内单例。在component的前面和module中的方法都加上自定义@Scope,那么在注入的activity中可以肯定生成的实例在此activity是单例。
Scope用于Component的组织。
- 更好的管理Component之间的组织方式,不管是依赖方式还是包含方式,都有必要用自定义的Scope注解标注这些Component,这些注解最好不要一样了,不一样是为了能更好的体现出Component之间的组织方式。还有编译器检查有依赖关系或包含关系的Component,若发现有Component没有用自定义Scope注解标注,则会报错。
- 更好的管理Component与Module之间的匹配关系,编译器会检查 Component管理的Modules,若发现标注Component的自定义Scope注解与Modules中的标注创建类实例方法的注解不一样,就会报错。
- 可读性提高,如用Singleton标注全局类,这样让开发人员立马就能明白这类是全局单例类。
自定义Scope
@Scope
@Retention(RUNTIME)
public @interface PreActivity {
}
@Scope
@Documented
@Retention(RUNTIME)
public @interface PerApp{}
全局单例
@Module
public class AppModule {
private AppApplication application;
public AppModule(AppApplication application) {
this.application = application;
}
@Provides @PreApp Context provideContext(){
return application;
}
}
@PreApp
@Component (modules = AppModule.class)
public interface AppComponent {
void inject(BaseActivity baseActivity);
Context context();
}
在AppApplication 中注入
public class AppApplication extends BaseApplication{
private static AppComponent appComponent;
private static AppApplication application;
@Override public void onCreate() {
super.onCreate();
application=this;
appComponent= DaggerAppComponent.builder().appModule(new AppModule(this)).build();
}
public static AppComponent getAppComponent(){
return appComponent;
}
}