org.gradle.api.internal.tasks.options.OptionReader Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of gradle-api Show documentation
Show all versions of gradle-api Show documentation
Gradle 5.5.1 API redistribution.
/*
* Copyright 2013 the original author or 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 org.gradle.api.internal.tasks.options;
import com.google.common.collect.ArrayListMultimap;
import com.google.common.collect.ListMultimap;
import org.gradle.api.tasks.options.Option;
import org.gradle.api.tasks.options.OptionValues;
import org.gradle.internal.reflect.JavaMethod;
import org.gradle.util.CollectionUtils;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
public class OptionReader {
private final ListMultimap, OptionElement> cachedOptionElements = ArrayListMultimap.create();
private final Map> cachedOptionValueMethods = new HashMap>();
private final OptionValueNotationParserFactory optionValueNotationParserFactory = new OptionValueNotationParserFactory();
public List getOptions(Object target) {
final Class targetClass = target.getClass();
Map options = new HashMap();
if (!cachedOptionElements.containsKey(targetClass)) {
loadClassDescriptorInCache(target);
}
for (OptionElement optionElement : cachedOptionElements.get(targetClass)) {
JavaMethod optionValueMethod = cachedOptionValueMethods.get(optionElement);
options.put(optionElement.getOptionName(), new InstanceOptionDescriptor(target, optionElement, optionValueMethod));
}
return CollectionUtils.sort(options.values());
}
private void loadClassDescriptorInCache(Object target) {
final Collection optionElements = getOptionElements(target);
List> optionValueMethods = loadValueMethodForOption(target.getClass());
Set processedOptionElements = new HashSet();
for (OptionElement optionElement : optionElements) {
if (processedOptionElements.contains(optionElement.getOptionName())) {
throw new OptionValidationException(String.format("@Option '%s' linked to multiple elements in class '%s'.",
optionElement.getOptionName(), target.getClass().getName()));
}
processedOptionElements.add(optionElement.getOptionName());
JavaMethod optionValueMethodForOption = getOptionValueMethodForOption(optionValueMethods, optionElement);
cachedOptionElements.put(target.getClass(), optionElement);
cachedOptionValueMethods.put(optionElement, optionValueMethodForOption);
}
}
private static JavaMethod getOptionValueMethodForOption(List> optionValueMethods, OptionElement optionElement) {
JavaMethod valueMethod = null;
for (JavaMethod optionValueMethod : optionValueMethods) {
String[] optionNames = getOptionNames(optionValueMethod);
if (CollectionUtils.toList(optionNames).contains(optionElement.getOptionName())) {
if (valueMethod == null) {
valueMethod = optionValueMethod;
} else {
throw new OptionValidationException(
String.format("@OptionValues for '%s' cannot be attached to multiple methods in class '%s'.",
optionElement.getOptionName(),
optionValueMethod.getMethod().getDeclaringClass().getName()));
}
}
}
return valueMethod;
}
private static String[] getOptionNames(JavaMethod optionValueMethod) {
OptionValues optionValues = optionValueMethod.getMethod().getAnnotation(OptionValues.class);
return optionValues.value();
}
private Collection getOptionElements(Object target) {
List allOptionElements = new ArrayList();
for (Class type = target.getClass(); type != Object.class && type != null; type = type.getSuperclass()) {
allOptionElements.addAll(getMethodAnnotations(type));
allOptionElements.addAll(getFieldAnnotations(type));
}
return allOptionElements;
}
private List getFieldAnnotations(Class type) {
List fieldOptionElements = new ArrayList();
for (Field field : type.getDeclaredFields()) {
Option option = findOption(field);
if (option != null) {
fieldOptionElements.add(FieldOptionElement.create(option, field, optionValueNotationParserFactory));
}
}
return fieldOptionElements;
}
private Option findOption(Field field) {
Option option = field.getAnnotation(Option.class);
if (option != null) {
if (Modifier.isStatic(field.getModifiers())) {
throw new OptionValidationException(String.format("@Option on static field '%s' not supported in class '%s'.",
field.getName(), field.getDeclaringClass().getName()));
}
}
return option;
}
private List getMethodAnnotations(Class type) {
List methodOptionElements = new ArrayList();
for (Method method : type.getDeclaredMethods()) {
Option option = findOption(method);
if (option != null) {
OptionElement methodOptionDescriptor = MethodOptionElement.create(option, method,
optionValueNotationParserFactory);
methodOptionElements.add(methodOptionDescriptor);
}
}
return methodOptionElements;
}
private Option findOption(Method method) {
Option option = method.getAnnotation(Option.class);
if (option != null) {
if (Modifier.isStatic(method.getModifiers())) {
throw new OptionValidationException(String.format("@Option on static method '%s' not supported in class '%s'.",
method.getName(), method.getDeclaringClass().getName()));
}
}
return option;
}
private static List> loadValueMethodForOption(Class declaredClass) {
List> methods = new ArrayList>();
for (Class type = declaredClass; type != Object.class && type != null; type = type.getSuperclass()) {
for (Method method : type.getDeclaredMethods()) {
JavaMethod optionValuesMethod = getAsOptionValuesMethod(type, method);
if (optionValuesMethod != null) {
methods.add(optionValuesMethod);
}
}
}
return methods;
}
private static JavaMethod getAsOptionValuesMethod(Class type, Method method) {
OptionValues optionValues = method.getAnnotation(OptionValues.class);
if (optionValues == null) {
return null;
}
if (Collection.class.isAssignableFrom(method.getReturnType())
&& method.getParameterTypes().length == 0
&& !Modifier.isStatic(method.getModifiers())) {
return JavaMethod.of(Collection.class, method);
} else {
throw new OptionValidationException(
String.format("@OptionValues annotation not supported on method '%s' in class '%s'. Supported method must be non-static, return a Collection and take no parameters.",
method.getName(),
type.getName()));
}
}
}