Dagger 2 系列（三） -- 基础篇：@Module 和 @Provides

本文主要是介绍Dagger 2 系列（三） -- 基础篇：@Module 和 @Provides，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Dagger2

该系列博客的最终目标：搭建 MVP + Dagger2 框架
该系列博客包含以下几篇内容：

Dagger 2 系列（一） – 前奏篇：依赖注入的基本介绍
Dagger 2 系列（二） – 基础篇：@Inject、@Component
Dagger 2 系列（三） – 基础篇：@Module 和@Provides
Dagger 2 系列（四） – 基础篇：@Named 和 @Qualifier
Dagger 2 系列（五） – 进阶篇：@Scope 和 @Singleton

在这篇文章中你会看到什么：

@Module 是什么
@Provides 是什么
@Module 、@Provides 和@Component 如何协同作战。

1. 什么是 Module

既然在Dagger 2 系列（二） – 基础篇：基本功能的实现一文中通过 @Inject 和 @Component 我们已经实现了 DI，那么为什么 Dagger2 还要实现其他的DI 方式。

其实在上文中我们实现的 DI 方式中我们不难发现，通过@Inject 的注解实体类的构造函数是必不可少，它标识着 Dagger2 可以实例化该类。那么当你需要实例化一个第三方的对象时，是不是懵逼了，因为你不可能注解第三方类的构造函数 – 比如说 Gson 类的构造函数。那么现在就需要 @Module 来充分发挥作用了。

其实Module 其实是一个简单工厂模式，Module 里面的方法都是创建相应类实例的方法。

具体什么是简单工厂模式，请看代码段简单学习设计模式 – 简单工厂模式

栗子：通过 @Module 的方式获得第三方类库的对象 – Gson(当然也可以获得自定义类对象)

@Module
public class AModule {@Providespublic Gson provideGson(){return new Gson();}
}

你再该类中看到了两个注解：

通过 @Module 注解类
通过 @Provides 注解方法

1.2 添加多个 Module

一个 Component 可以含有多个 Module ，这样在寻找依赖实例时就会自动从多个 Module 中寻找。

添加多个 Module 的方法有两种：

1.2.1 Component 注解 – @Component(modules={××××，×××})

示例代码如下：

@Component(modules={ModuleA.class,ModuleB.class,ModuleC.class}) 
public interface AppComponent{...
}

1.2.2 Module 注解 – @Module(includes={××××，×××})

示例代码如下：

@Module(includes={ModuleA.class,ModuleB.class,ModuleC.class})
public class FruitModule{...
}
@Component(modules={FruitModule.class}) //添加多个Module
public interface AppComponent{...
}

这种使用 Module的 includes 添加多Module 的方法一般用于构建更高层的Module时候使用,如在本例中

2. 什么是 Provides

@Provides 用以标注 Module 类中的方法，它的作用是 标注该 Module 可以向外界提供的类的实例对象的方法 ，就像 AModule 中可以提供 Gson 实例对象的 provideGson() 方法。

3. Component – 管理 Module

此时 DI 不是通过 @Inject 注解类构造器的方式，那么这个注解器的使用方法肯定也有所变化。

此时 Component 的职责是管理 Module，Component 中的属性允许 Module 可以加入到 Component，同时一个 Component 可以加入多个 Module。

依赖注入的具体工作流程：
协作流程

若实例化过程中参数同样是需要依赖注入的，那么需要按照上图中的流程一样寻找相应的方法。如果遍历了组件中管理的 Module 类中的 @Provides 注解的方法，那么就会寻找该实例类的构造器中是否有被 @Inject 注解的，如果参数同样有需要依赖注入的，那么就重复以上过程。如果最终还是没有找到相应的初始化实例的方法，那么程序会报出相应的错误。

4. 代码示例

@Component(modules = UserTwoModule.class)
public interface UserTwoComponent {void injectToSecondActivity(SecondActivity mSecondActivity);
}@Module
public class UserTwoModule {@ProvidesUserTwo provideUserTwo(){return new UserTwo("男",1243);}
}public class SecondActivity extends AppCompatActivity {@InjectUserTwo mUserTwo;private static final String TAG = "SecondActivity";@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_second);DaggerUserTwoComponent.builder().userTwoModule(new UserTwoModule()).build().injectToSecondActivity(this);}
}

Dagger2sample github地址