dagger2从入门到放弃最基础的用法介绍

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分支上最新的代码可能会比当前文章的示例代码稍微复杂点，提交记录里包含了每一步的迭代过程,可以顺藤摸瓜