src/com/google/inject/RuntimeReflectionFactory.java

/**
 * Copyright (C) 2008 Google Inc.
 *
 * 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 com.google.inject;

import static com.google.common.base.Preconditions.checkNotNull;
import com.google.inject.internal.Errors;
import com.google.inject.internal.ErrorsException;
import java.lang.reflect.Constructor;
import java.lang.reflect.Modifier;

/**
 * @author jessewilson@google.com (Jesse Wilson)
 */
class RuntimeReflectionFactory implements Reflection.Factory {
  public Reflection create(ConstructionProxyFactory constructionProxyFactory) {
    return new RuntimeReflection(constructionProxyFactory);
  }

  private static class RuntimeReflection implements Reflection {
    private final ConstructionProxyFactory constructionProxyFactory;

    private RuntimeReflection(ConstructionProxyFactory constructionProxyFactory) {
      this.constructionProxyFactory = checkNotNull(constructionProxyFactory, "constructionProxyFatory");
    }

    public <T> ConstructionProxy<T> getConstructionProxy(Errors errors, Class<T> implementation)
        throws ErrorsException {
      return constructionProxyFactory.get(errors, findConstructorIn(errors, implementation));
    }

    private <T> Constructor<T> findConstructorIn(Errors errors, Class<T> implementation)
        throws ErrorsException {
      Constructor<T> found = null;
      @SuppressWarnings("unchecked")
      Constructor<T>[] constructors
          = (Constructor<T>[]) implementation.getDeclaredConstructors();
      for (Constructor<T> constructor : constructors) {
        Inject inject = constructor.getAnnotation(Inject.class);
        if (inject != null) {
          if (inject.optional()) {
            errors.optionalConstructor(constructor);
          }

          if (found != null) {
            errors.tooManyConstructors(implementation);
          }

          found = constructor;
        }
      }
      if (found != null) {
        return found;
      }

      // If no annotated constructor is found, look for a no-arg constructor
      // instead.
      try {
        Constructor<T> noArgCtor = implementation.getDeclaredConstructor();

        // Explicitly disallow private constructors that are missing @Inject
        if (Modifier.isPrivate(noArgCtor.getModifiers())) {
          errors.missingConstructor(implementation);
        }
        return noArgCtor;
      }
      catch (NoSuchMethodException e) {
        throw errors.missingConstructor(implementation).toException();
      }
    }

    /**
     * A placeholder. This enables us to continue processing and gather more
     * errors but blows up if you actually try to use it.
     */
    static class InvalidConstructor {
      InvalidConstructor() {
        throw new AssertionError();
      }
    }

    @SuppressWarnings("unchecked")
    static <T> Constructor<T> invalidConstructor() {
      try {
        return (Constructor<T>) InvalidConstructor.class.getDeclaredConstructor();
      }
      catch (NoSuchMethodException e) {
        throw new AssertionError(e);
      }
    }
  }
}