/*
* Copyright (C) 2014 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.internal.codegen.binding;
import static dagger.model.BindingKind.MEMBERS_INJECTOR;
import com.google.auto.value.AutoValue;
import com.google.common.base.CaseFormat;
import com.squareup.javapoet.ClassName;
import com.squareup.javapoet.ParameterizedTypeName;
import com.squareup.javapoet.TypeName;
import java.util.Optional;
import javax.lang.model.element.Element;
import javax.lang.model.element.ElementVisitor;
import javax.lang.model.element.ExecutableElement;
import javax.lang.model.element.TypeElement;
import javax.lang.model.element.VariableElement;
import javax.lang.model.type.TypeMirror;
import javax.lang.model.util.ElementKindVisitor8;
/**
* A value object that represents a field in the generated Component class.
*
*
Examples:
*
*
* - {@code Provider}
*
- {@code Producer}
*
- {@code Provider
*/
@AutoValue
public abstract class FrameworkField {
/**
* Creates a framework field.
*
* @param frameworkClassName the name of the framework class (e.g., {@link javax.inject.Provider})
* @param valueTypeName the name of the type parameter of the framework class (e.g., {@code Foo}
* for {@code Provider}
* @param fieldName the name of the field
*/
public static FrameworkField create(
ClassName frameworkClassName, TypeName valueTypeName, String fieldName) {
String suffix = frameworkClassName.simpleName();
return new AutoValue_FrameworkField(
ParameterizedTypeName.get(frameworkClassName, valueTypeName),
fieldName.endsWith(suffix) ? fieldName : fieldName + suffix);
}
/**
* A framework field for a {@link ContributionBinding}.
*
* @param frameworkClass if present, the field will use this framework class instead of the normal
* one for the binding's type.
*/
public static FrameworkField forBinding(
ContributionBinding binding, Optional frameworkClass) {
return create(
frameworkClass.orElse(
ClassName.get(
FrameworkType.forBindingType(binding.bindingType()).frameworkClass())),
TypeName.get(fieldValueType(binding)),
frameworkFieldName(binding));
}
private static TypeMirror fieldValueType(ContributionBinding binding) {
return binding.contributionType().isMultibinding()
? binding.contributedType()
: binding.key().type();
}
private static String frameworkFieldName(ContributionBinding binding) {
if (binding.bindingElement().isPresent()) {
String name = BINDING_ELEMENT_NAME.visit(binding.bindingElement().get(), binding);
return binding.kind().equals(MEMBERS_INJECTOR) ? name + "MembersInjector" : name;
}
return KeyVariableNamer.name(binding.key());
}
private static final ElementVisitor BINDING_ELEMENT_NAME =
new ElementKindVisitor8() {
@Override
protected String defaultAction(Element e, Binding p) {
throw new IllegalArgumentException("Unexpected binding " + p);
}
@Override
public String visitExecutableAsConstructor(ExecutableElement e, Binding p) {
return visit(e.getEnclosingElement(), p);
}
@Override
public String visitExecutableAsMethod(ExecutableElement e, Binding p) {
return e.getSimpleName().toString();
}
@Override
public String visitType(TypeElement e, Binding p) {
return CaseFormat.UPPER_CAMEL.to(CaseFormat.LOWER_CAMEL, e.getSimpleName().toString());
}
@Override
public String visitVariableAsParameter(VariableElement e, Binding p) {
return e.getSimpleName().toString();
}
};
public abstract ParameterizedTypeName type();
public abstract String name();
}