dagger.producers.internal.AbstractMapProducer Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dagger-producers Show documentation
A fast dependency injector for Android and Java.
There is a newer version: 2.52
/*
 * Copyright (C) 2016 The Dagger Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package dagger.producers.internal;

import static com.google.common.base.Preconditions.checkNotNull;
import static dagger.internal.Providers.asDaggerProvider;
import static dagger.producers.internal.Producers.producerFromProvider;

import com.google.common.collect.ImmutableMap;
import dagger.internal.Provider;
import dagger.producers.Producer;
import java.util.Map;

/**
 * An {@code abstract} {@link Producer} implementation used to implement {@link Map} bindings.
 *
 * @param The key type of the map that this produces
 * @param The type that each contributing producer
 * @param The value type of the map that this produces. For {@link MapProducer}, {@code V} and
 *     {@code V2} will be equivalent.
 */
abstract class AbstractMapProducer extends AbstractProducer> {
  private final ImmutableMap> contributingMap;

  AbstractMapProducer(ImmutableMap> contributingMap) {
    this.contributingMap = contributingMap;
  }

  /** The map of {@link Producer}s that contribute to this map binding. */
  final ImmutableMap> contributingMap() {
    return contributingMap;
  }

  /** A builder for {@link AbstractMapProducer} */
  public abstract static class Builder {
    final ImmutableMap.Builder> mapBuilder;

    Builder(int size) {
      mapBuilder = ImmutableMap.builderWithExpectedSize(size);
    }

    // Unfortunately, we cannot return a self-type here because a raw Producer type passed to one of
    // these methods affects the returned type of the method. The first put*() call erases the self
    // type to the "raw" self type, and the second erases the type to the upper bound
    // (AbstractMapProducer.Builder), which doesn't have a build() method.
    //
    // The methods are therefore not declared public so that each subtype will redeclare them and
    // expand their accessibility

    /** Associates {@code key} with {@code producerOfValue}. */
    Builder put(K key, Producer producerOfValue) {
      checkNotNull(key, "key");
      checkNotNull(producerOfValue, "producer of value");
      mapBuilder.put(key, producerOfValue);
      return this;
    }

    /** Associates {@code key} with {@code providerOfValue}. */
    Builder put(K key, Provider providerOfValue) {
      checkNotNull(key, "key");
      checkNotNull(providerOfValue, "provider of value");
      mapBuilder.put(key, producerFromProvider(providerOfValue));
      return this;
    }

    /**
     * Legacy javax version of the method to support libraries compiled with an older version of
     * Dagger. Do not use directly.
     */
    @Deprecated
    Builder put(K key, javax.inject.Provider providerOfValue) {
      return put(key, asDaggerProvider(providerOfValue));
    }

    /** Adds contributions from a super-implementation of a component into this builder. */
    Builder putAll(Producer> mapOfProducers) {
      if (mapOfProducers instanceof DelegateProducer) {
        @SuppressWarnings("unchecked")
        DelegateProducer> asDelegateProducer = (DelegateProducer) mapOfProducers;
        return putAll(asDelegateProducer.getDelegate());
      }
      @SuppressWarnings("unchecked")
      AbstractMapProducer asAbstractMapProducer =
          ((AbstractMapProducer) (Producer) mapOfProducers);
      mapBuilder.putAll(asAbstractMapProducer.contributingMap);
      return this;
    }
  }
}