Dagger 2中@Binds和@Provides注解的用例是什么

Question

我不确定 Dagger2 的@Bind annotation. 的目的

根据我在网上阅读的内容，我仍然不清楚，但这里有一个例子：

@Module
public abstract class HomeModule {

  @Binds
  public abstract HomePresenter bindHomePresenter(HomePresenterImp   
    homePresenterImp);
}

类定义如下所示：

public interface HomePresenter {
    Observable<List<User>> loadUsers();
}

public class HomePresenterImp implements HomePresenter {

    public HomePresenterImp(){
    }  

    @Override
    public Observable<List<User>> loadUsers(){
        //Return user list observable
    }
}

如果我可以使用提供注释，为什么我需要使用@Binds，如下所示：

@Provides
public HomePresenter provideHomePresenter() {
    return new HomePresenterImp();
}

@Binds 而不是 @Provides 的用例是什么？如果我使用@Binds，我还需要在我的应用组件中声明它吗（当我使用@Binds 时它是一个抽象类）？

Answer 1

@Binds 可以完全等同于这样的@Provides-annotated 方法：

@Provides
public HomePresenter provideHomePresenter() {
    return new HomePresenterImp();
}

...尽管您可能更喜欢将 HomePresenterImp 作为方法参数的变体，它允许 Dagger 实例化 HomePresenterImp（假设它有一个 @Inject 构造函数），包括传递它需要的任何依赖项。您也可以将其设为static，因此 Dagger 无需实例化您的 Module 实例即可调用它。

@Provides
public static HomePresenter provideHomePresenter(HomePresenterImp presenter) {
    return presenter;
}

那你为什么要选择@Binds呢？ Dagger has a FAQ about it，但归结为以下原因：

• @Binds（稍微）更紧凑：您可以跳过实现。
• @Binds 在接口和抽象类中工作，这是 @BindsOptionalOf 和 @ContributesAndroidInjector 等 Dagger 功能所严格要求的。
• @Binds 帮助您的代码保持高效。 @Provides 方法可以是实例方法，这需要 Dagger 实例化您的 Module 才能调用它们。使您的@Provides 方法static 也可以完成此操作，但是如果您忘记了static，您的@Provides 方法仍然可以编译。 @Binds 方法不会。
• @Binds 使 Dagger 不必为对象生成代码并为对象保留一个单独的工厂/提供程序，因为 Java 不会让 Dagger 访问知道实现就这么简单。在您的情况下，Dagger 可以将 Provider<HomePresenterImp> 转换为 Provider<HomePresenter> 并且只保留一个，而不是为 HomePresenter 保留一个，它只为 HomePresenterImp 调用一个。

因此，整个事情可以很好地表示为：

@Binds abstract HomePresenter bindHomePresenter(HomePresenterImp presenter);

Answer 2

这是一个需要Bind 注释的具体案例，假设您有一个BaseActivityModule，它包含在所有提供活动视图模型的活动模块中。

@Module
object BaseActivityModule {
    @Provides
    @ActivityScope
    @ActivityContext
    @JvmStatic
    fun provideViewModelProvider(
        activity: AppCompatActivity,
        viewModelFactory: ViewModelProvider.Factory
    ): ViewModelProvider = ViewModelProviders.of(activity, viewModelFactory)
}

在这里您看到我们需要提供AppCompatActivity 和ViewModelProvider.Factory。您不能为AppCompatActivity 提供Provide 注释，因为活动是由android 创建的。

我们假设您的具体 ActivityModule 例如 MainActivityModule 将提供 MainActivity 类，因为您创建了 MainActivity 子组件，或者您使用 ContributesAndroidInjector 自动创建子组件（但这是另一个话题） .

所以我们有我们的MainActivityModule 提供MainActivity 和我们的MainActivityModule 包括我们的BaseActivityModule 需要AppCompatActivity。所以这里是Bind 魔法，让我们告诉Dagger，当你需要AppCompatActivity 时，你可以使用我们的MainActivity。

@Module(includes = [BaseActivityModule::class])
abstract class MainActivityModule {
    @Binds
    @ActivityScope
    abstract fun bindActivity(activity: MainActivity): AppCompatActivity
}

你可以从我的项目模板here看到更多