一、前言
在 中,我们提到了两种实现依赖注入的方法:
- 在依赖类的构造函数上增加
@Inject
注解 - 提供一个
Module
类,在其中创建提供依赖类实例的方法
在使用第二种方法时,Dagger2 在寻找目标依赖类的创建方法时,是根据 Module 提供的方法的返回类型来确定的,因此如果我们提供了多个返回类型相同的创建方法时,那么Dagger2
就无法判断使用哪个函数来创建实例,将会在编译时抛出异常。对于这种情况,我们称为 依赖注入迷失。
对于这种情况,我们可以通过@Qualifier/@Named
注解来解决,这篇文章的完整代码可以从 的第二章获取。
二、示例
我们还是像 中介绍的一样,采用一个数据仓库DataReposity
作为例子,它内部包含两个数据源,分别为LocalSource
和RemoteSource
,而这两个类都实现了Source
接口,SourceModule
用于提供这两个数据源,而SourceComponent
则作为注入器。
- 本地数据源
public class LocalSource implements Source { @Override public String getData() { return "读取本地数据成功"; }}复制代码
- 网络数据源
public class RemoteSource implements Source { @Override public String getData() { return "读取网络数据成功"; }}复制代码
- 依赖注入接口,
SourceComponent
:
@Component(modules = SourceModule.class)public interface SourceComponent { public void inject(DataRepository dataRepository);}复制代码
- 创建工厂类
@Modulepublic class SourceModule { @Provides public Source provideLocalSource() { return new LocalSource(); } @Provides public Source providerRemoteSource() { return new RemoteSource(); }}复制代码
- 注入目标类
public class DataRepository { @Inject Source mLocalSource; @Inject Source mRemoteSource; public DataRepository() { DaggerSourceComponent.create().inject(this); } public String getLocalData() { return mLocalSource.getData(); } public String getRemoteData() { return mRemoteSource.getData(); }}复制代码
这里所采用的就是我们在第一节中介绍的第二种依赖注入的方式,但是如果我们这时候点击make
,那么会曝出下面的错误:
这是因为Dagger2
在寻找mLocalSource
的创建方法时,它会去Component
关联的Module
中(也就是SourceModule
)寻找返回类型为Source
的方法,但是在SourceModule
中,provideLocalSource / providerRemoteSource
这两个方法返回的类型都为SourceModule
,导致无法确定使用哪个方法来创建mLocalSource
。
这时候就需要我们提供一个别名,让 目标类成员变量的类型 和 创建方法的返回类型 形成一对一的关系,一般来说,使用@Qulifier
是比较标准的方式。
我们先利用@Qulifier
创建两个别名,分别对应本地和远程数据源:
- 本地数据源别名
@Qualifier@Retention(RetentionPolicy.RUNTIME)public @interface Local {}复制代码
- 网络数据源别名
@Qualifier@Retention(RetentionPolicy.RUNTIME)public @interface Remote {}复制代码
接下来,为了建立唯一关系,我们需要在两个地方加上这个别名:
- 目标类的成员变量
- 工厂
Module
中创建目标类的成员变量的方法
即下面的两个截图中红色框部分:
最后,我们用一个例子演示最终的效果:
public class QualifierActivity extends AppCompatActivity { private static final String TAG = QualifierActivity.class.getSimpleName(); private Button mBtnGetData; private Button mBtnGetNetData; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_qualifier); mBtnGetData = (Button) findViewById(R.id.bt_get_data); mBtnGetData.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { DataRepository repository = new DataRepository(); String data = repository.getLocalData(); Toast.makeText(QualifierActivity.this, data, Toast.LENGTH_SHORT).show(); } }); mBtnGetNetData = (Button) findViewById(R.id.bt_get_net_data); mBtnGetNetData.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { DataRepository repository = new DataRepository(); String data = repository.getRemoteData(); Toast.makeText(QualifierActivity.this, data, Toast.LENGTH_SHORT).show(); } }); }}复制代码
运行结果:
三、使用 @Named
上面我们使用的是@Qulifier
注解来实现,@Named
也可以达到相同的效果。还是用上面的例子,我们不需要重新定义两个注解@Local
和@Remote
,而是直接在需要加上别名的两个地方,添加@Named("Local")
和@Named("Remote")
,也就是将@Named
后面括号中的字符串作为关联目标类型的成员变量和创建方法之间的别名。
更多文章,欢迎访问我的 Android 知识梳理系列:
- Android 知识梳理目录:
- 个人主页:
- 个人知识总结目录: