寻找 Dagger 辅助注射的示例

From 匕首讨论@ https://groups.google.com/forum/#!topic/dagger-discuss/QgnvmZ-dH9c:

我有一个类，它从对象图中获取一些依赖项，并在运行时从调用者获取其他依赖项。

public class ImageDownloader {
  // Get these dependencies from the injector.
  private final HttpClient httpClient;
  private final ExecutorService executorService;

  // Get these from the caller.
  private final URL imageUrl;
  private final ImageCallback callback;

  ...
}

我想出了一个解决方案，我定义了一个工厂，

public class ImageDownloader {
  ...
  public static class Factory {
    private final HttpClient httpClient;
    private final ExecutorService executorService;

    @Inject
    public Factory(HttpClient httpClient, ExecutorService executorService) {
      this.httpclient = httpClient;
      this.executorService = executorService;
    }

    public ImageDownloader create(URL imageUrl, ImageCallback callback) {
      return new ImageDownloader(httpClient, executorService, iamgeUrl, callback);
    }
  }
  ...
}

现在，而不是注射ImageDownloader在客户端的构造函数中，我只需注入ImageDownloader.Factory并称其为create() method.

正如您所看到的，这非常冗长。它还包含大量重复内容和样板文件。对字段本身进行注释存在一些障碍@Inject，所以我们暂时忽略这种可能性。

Square 人员使用提供商提出了一个有趣的解决方案。定义一个Factory界面，

public class ImageDownloader {
  ...
  public interface Factory {
    ImageDownloader create(URL imageUrl, ImageCallback callback);
  }
}

然后在模块中提供它，

public class ImageModule {
  ...
  @Provides 
  public ImageModule.Factory provideImageModuleFactory(
      final Provider<HttpClient> httpClientProvider, 
      final Provider<ExecutorService> executorServiceProvider) {
    return new ImageDownloader.Factory() {
      public ImageDownloader create(URL imageUrl, ImageCallback callback) {
        return new ImageDownloader(httpClientProvider.get(), executorServiceProvider.get(),
            imageUrl, callback);
      }
  }
  ...
}

（再次来自 dagger-discuss@）。

My ImageDownloader是一个由一个类注入的类，该类由另一个类注入，而另一个类又由另一个类注入，...，它在@Module。这一切都以某种方式*起作用，并且所有类都在构建时找到。现在，要添加模块，我必须显式地让对象图知道它。

我一定错过了一些东西——注入一个新类很容易，但添加一个新模块却很乏味。

我的问题是：辅助注射在实践中是如何进行的？有人有例子吗？我应该如何使用ImageModule，如果有的话？

* - “不知怎的”确实意味着它对我来说有一定的魔力。

因此，Google 的一些 Dagger/Guice 人员创建了一个名为 AutoFactory 的东西（http://github.com/google/auto http://github.com/google/auto）在一个项目中，该项目包括 AutoFactory（代码生成的辅助注入）、AutoValue（代码生成的自定义值类型）和 AutoService（自动生成 java 服务元数据文件）。

AutoFactory 的运行方式几乎与您所期望的一样 - 它生成您原本需要手动创建的工厂。这是一个非常早期的版本，我们计划了更多的灵活性，但它将生成一个工厂类，该类将采用包含一些 JSR-330 可注入依赖项和一些调用堆栈参数的类型，并将它们合并在一起以创建带注释的类型。

本质上，如果您正确注释工厂创建的类型，它将自动生成您编写的工厂。

例如，如果您创建类：

@AutoFactory
public class ImageDownloader {
  // Get these dependencies from the injector.
  private final HttpClient httpClient;
  private final ExecutorService executorService;

  // Get these from the caller.
  private final URL imageUrl;
  private final ImageCallback callback;

  ImageDownloader(
      @Provided HttpClient httpClient,
      @Provided ExecutorService executorService,
      ImageCallback callback,
      URL imageUrl) {
    // assignments
  }
}

AutoFactory 将生成：

@Generated("com.google.auto.factory.processor.AutoFactoryProcessor")
public final class ImageDownloaderFactory {
  private final Provider<ExampleClasses.HttpClient> httpClientProvider;
  private final Provider<java.util.concurrent.ExecutorService> executorServiceProvider;

  @Inject
  public ImageDownloaderFactory(
      Provider<ExampleClasses.HttpClient> httpClientProvider,
      Provider<java.util.concurrent.ExecutorService> executorServiceProvider) {
    this.httpClientProvider = httpClientProvider;
    this.executorServiceProvider = executorServiceProvider;
  }

  public ImageDownloader create(ImageCallback callback, URL imageUrl) {
    return new ImageDownloader(
        httpClientProvider.get(), 
        executorServiceProvider.get(), 
        callback, 
        imageUrl);
  }
}

（请注意，我们需要对输出源进行大量清理，但上面基本上是生成的内容，尽管格式不那么好。）

然后，生成的类实际上是一个符合 JSR-330 的可注入类，您可以将其注入到依赖关系图中（在 Dagger 或 Guice 中），它将为您创建这些对象，将调用堆栈状态与提供的依赖项混合在一起适当地。

您可以注入上述 Just-In-Time，也可以通过@Provides方法在您闲暇时。

您甚至可以让工厂实现工厂接口，然后简单地将两者绑定在 dagger 模块中，如下所示：

@AutoFactory(implementing = MyFactoryInterface.class)
public class ImageDownloader {
  // ... otherwise as above...
}

@Module(...)
class MyModule {
  @Provides MyFactoryInterface factoryImpl(ImageDownloaderFactory impl) {
    return impl;
  }
}