Interface Producer

dagger-producers/main/java/dagger/producers/Producer.java:94–107

An interface that represents the production of a type T. You can also inject Producer instead of T, which will delay the execution of any code that produces the T until #get is called. For example, you might inject Producer to lazily choose betw

 * @since 2.0
 */
@Beta
public interface Producer<T> {
  /**
   * Returns a future representing a running task that produces a value. Calling this method will
   * trigger the submission of this task to the executor, if it has not already been triggered. In
   * order to trigger this task's submission, the transitive dependencies required to produce the
   * {@code T} will be submitted to the executor, as their dependencies become available.
   *
   * <p>If the key is bound to a {@link Produces} method, then calling this method multiple times
   * will return the same future.
   */
  @CheckReturnValue
  ListenableFuture<T> get();
}