前言
dagger2确实学习曲线比较陡峭，但是忘掉生命周期，忘掉局部单例，忘掉SubComponent这样的进阶用法，只用最基础最简单的部分一样可以给项目带来一定程度的便利
依赖的提供方式
- @Inject注解构造器
- @Provides注解提供依赖的方法
@Inject注解构造器-用来提供依赖
- 表示该类可以作为依赖注入到依赖需求方
- 如果构造器带参数，则这些参数也需要是可以提供的依赖，dagger2会自动找到这些依赖并注入
- 对于有多个构造器的类，@Inject只能注解其中一个
public class SimpleInjectExtraBean {
@Inject
public SimpleInjectExtraBean() {
}
}
@Inject构造函数带参数的情况
构造函数中的参数需要是@Inject注解构造器的对象或者是@Provides方法提供的依赖
public class SimpleInjectBean extends BaseBean {
public SimpleModuleBean mSimpleModuleBean;
public SimpleInjectExtraBean mSimpleInjectExtraBean;
@Inject
public SimpleInjectBean(SimpleModuleBean simpleModuleBean,
SimpleInjectExtraBean simpleInjectExtraBean) {
mSimpleModuleBean = simpleModuleBean;
mSimpleInjectExtraBean = simpleInjectExtraBean;
}
}
@Module @Provides 提供无法修改构造器的依赖
使用@Inject注解构造器是最简单的提供依赖的方式，但是如果是一个第三方库中的代码无法修改构造函数添加注解呢，这时候就需要module出场了
@Module //@Module注解可以提供依赖的类
public class SimpleModule {
@Provides // @Provides 注解提供依赖的方法
public SimpleModuleBean provideSimpleModuleBean() {
return new SimpleModuleBean();
}
}
@Provides注解的方法带参数
和@Inject注解的构造函数带的参数一样，也需要是@Inject注解构造器的对象或者是@Provides方法提供的依赖
依赖的接收方式
@Inject注解实例变量-用来接受依赖
public class SimpleActivity extends AppCompatActivity {
@Inject
SimpleInjectBean mSimpleInjectBean;
...
}
连接依赖提供方和依赖接收方的Component
component是依赖提供方和依赖需求方的连接者，使用@Component注解，注意dagger2只能注解接口和抽象类，具体类注解了也生成不了注入相关的代码
对于@Inject不需要在Component中显示指定
对于module，需要在用@Component的modules属性显示指定
@Component(modules = SimpleModule.class)
public interface SimpleComponent {
void inject(SimpleActivity simpleActivity);
}
框架会生成DaggerXXXComponent的类，使用DaggerXXXComponent完成注入
public class SimpleActivity extends AppCompatActivity {
@Inject
SimpleInjectBean mSimpleInjectBean;
@Inject
SimpleInjectExtraBean mSimpleInjectExtraBean;
@Inject
SimpleModuleBean mSimpleModuleBean;
...
private SimpleComponent mSimpleComponent;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mSimpleComponent = DaggerSimpleComponent.create();
mSimpleComponent.inject(this);
...
}
}
以上就用dagger2实现了最简单的依赖注入
不过这基本上接近于写了一个HelloWorld
下面看一下更接近真实的简单场景
提供一个运行时的依赖
dagger2实现依赖注入的实质是创建编译期可以确定的所有类的工厂，在运行时通过dagger2生成的工厂代码（依赖注入框架内部）完成依赖的创建与管理
但是像Application，Activity这样的对象的创建过程是android框架完成的，dagger2无法接管这个过程，而非常多的对象的创建会依赖于context，activity这样的对象
为了解决这样的问题，需要将这些运行时对象作为参数提供给dagger框架
为dagger框架提供参数有两种方式
构造器带参数的Module
以Application为例
@Module
public class BaseAppModule {
private Application mApplication;
public BaseAppModule(Application application) {
mApplication = application;
}
@Provides
@Singleton
Application provideApplication() {
return mApplication;
}
@Provides
@Singleton
Context provideContext() {
return mApplication;
}
}
Component的获取方式也会变化
//before Component依赖的所有module的构造函数都没带参数，则可以直接通过DaggerXXXComponent.create()直接获取对应的Component实例
DaggerBaseAppComponent.create();
//等价于DaggerXXXComponent.builder().build();
DaggerBaseAppComponent.builder().build();
//after 如果module中带了参数，则编译期不会生成create()方法
//需要使用.builder()传入对应的Module作为参数，这时可以将Application实例作为Module的构造参数传入
DaggerBaseAppComponent.builder().baseAppModule(new BaseAppModule(this)).build();
直接通过@Component.Builder传入参数
@Component.Builder注解一个用来向Component绑定参数的接口
这里以Activity为例,在Component.Builder中使用@BindsInstance注解一个传入Activity的方法
//provideSimpleModuleActivityBean有一个Activity作为参数
@Module
public class SimpleModule {
@Provides
public SimpleModuleActivityBean provideSimpleModuleActivityBean(Activity activity) {
return new SimpleModuleActivityBean(activity);
}
}
@Component(modules = SimpleModule.class)
public interface SimpleComponent {
void inject(SimpleActivity simpleActivity);
@Component.Builder
interface Builder {
//创建Component的时候绑定实例
@BindsInstance
Builder simpleActivity(Activity simpleActivity);
SimpleComponent build();
}
}
注意：如果SimpleModule构造函数还带了参数，因为此时的Component.Builder是按照我们定义的而不是完全自动生成的，所以为能够传入Module中需要的参数，需要显式指定该module作为builder的参数
@Component(modules = SimpleModule.class)
@SimpleScope
public interface SimpleComponent {
void inject(SimpleActivity simpleActivity);
@Component.Builder
interface Builder {
//创建Component的时候绑定实例
@BindsInstance
Builder simpleActivity(Activity simpleActivity);
//使用了Builder就需要显式的指定带参数的module作为builder的参数
Builder simpleModule(SimpleModule simpleModule);
SimpleComponent build();
}
}
总结
这篇文章介绍了为dagger提供依赖和注入依赖以及提供运行时参数的方法，不过离真实场景还是有一定的区别那就是生命周期的管理
下一篇文章将介绍dagger2中依赖的生命周期管理
相关文章
dagger2从入门到放弃-概念
dagger2从入门到放弃-最基础的用法介绍
dagger2从入门到放弃-Component的继承体系、局部单例
dagger2从入门到放弃-ActivityMultibindings
dagger2从入门到放弃-dagger.android
dagger2从入门到放弃-其他用法
dagger2从入门到放弃-多模块项目下dagger的使用
dagger2从入门到放弃-为何放弃
参考资料
https://google.github.io/dagger/
https://github.com/google/dagger
使用Dagger 2依赖注入
Dagger 2 完全解析
示例代码
DaggerInAction
欢迎star
master分支上最新的代码可能会比当前文章的示例代码稍微复杂点，提交记录里包含了每一步的迭代过程,可以顺藤摸瓜
