All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.greenpepper.maven.plugin.utils.FixtureAnnotationClassScanner Maven / Gradle / Ivy

There is a newer version: 4.2.4
Show newest version
package com.greenpepper.maven.plugin.utils;

import com.google.common.collect.Multimap;
import com.greenpepper.annotation.Fixture;
import com.greenpepper.annotation.FixtureCollection;
import com.greenpepper.annotation.FixtureMethod;
import com.greenpepper.maven.plugin.schemas.*;
import com.greenpepper.reflect.CollectionProvider;
import org.apache.commons.lang3.ArrayUtils;
import org.apache.commons.lang3.StringUtils;
import org.reflections.Reflections;
import org.reflections.Store;
import org.reflections.util.ClasspathHelper;
import org.reflections.util.ConfigurationBuilder;
import org.reflections.util.FilterBuilder;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.lang.reflect.*;
import java.util.*;

import static com.google.common.base.Predicates.and;
import static com.google.common.base.Predicates.not;
import static com.google.common.base.Predicates.or;
import static org.apache.commons.lang3.StringUtils.replace;
import static org.reflections.ReflectionUtils.*;

public class FixtureAnnotationClassScanner {

    private static final String CAT_FIXTURES_ABSTRAITES = "Abstract Fixtures";

    /**
     * Logger for this class
     */
    private static final Logger LOGGER = LoggerFactory.getLogger(FixtureAnnotationClassScanner.class);

    private static Map xsdTypeMap;
    static {
        xsdTypeMap = new HashMap();
        xsdTypeMap.put("String", "string");
        xsdTypeMap.put("Integer", "integer");
        xsdTypeMap.put("Long", "long");
        xsdTypeMap.put("Double", "double");
        xsdTypeMap.put("Float", "float");
        xsdTypeMap.put("Boolean", "boolean");
    }

    /**
     * @param packagesToScan the package to scan for fixtures
     * @return The full Fixtures description.
     * @throws ClassNotFoundException
     */
    @SuppressWarnings("unchecked")
    public Fixtures scan(String ... packagesToScan) throws ClassNotFoundException {
        ConfigurationBuilder configuration = new ConfigurationBuilder();
        FilterBuilder filterBuilder = new FilterBuilder();
        for (String packageToScan : packagesToScan) {
            configuration.addUrls(ClasspathHelper.forPackage(packageToScan));
            filterBuilder.include(replace(packageToScan,".", "\\.") + "\\..+Fixture\\.class");
        }
        configuration.filterInputsBy(filterBuilder);
        configuration.addScanners(new JavaClassesScanner());
        Reflections reflections = new Reflections(configuration);

        Store store = reflections.getStore();
        Multimap fixturesClassFilesMap = store.get(JavaClassesScanner.class.getSimpleName());
        Collection fixturesClassFiles = fixturesClassFilesMap.values();
        LOGGER.info("Found {} Fixture classes.", fixturesClassFiles.size());
        if (LOGGER.isDebugEnabled()) {
            StringBuilder builder = new StringBuilder();
            for (String fixturesClassFile : fixturesClassFiles) {
                builder.append("\n\t ").append(fixturesClassFile);
            }
            LOGGER.debug(builder.toString());
        }

        Fixtures fixturesType = new Fixtures();
        fixturesType.setLanguage(TypeLanguage.JAVA);
        List listFixtureType = fixturesType.getFixture();

        for (String fixturesClassFile : fixturesClassFiles) {
            LOGGER.debug("Scanning {}", fixturesClassFile);
            Class clazz = Class.forName(fixturesClassFile);
            if (Modifier.isAbstract(clazz.getModifiers())) {
                if (isAbstractFixture(clazz)) {
                    LOGGER.debug("Parsing Abstract fixture {}", clazz);
                } else {
                    LOGGER.debug("Skipping abstract Class {}", clazz);
                    continue;
                }
            }
            FixtureType fixtureType = new FixtureType();

            if (clazz.isAnnotationPresent(Fixture.class)) {
                LOGGER.debug("Parsing @Fixture annotation");
                parseFixtureAnnotation(clazz, fixtureType);
            }

            List listMembreType = fixtureType.getMember();

            LOGGER.debug(" Retrieve and add constructor members");
            Constructor[] constructors = clazz.getConstructors();
            addClassMembreType(listMembreType, constructors);

            LOGGER.debug(" Retrieve and add method members");
            Set methods = getAllMethods(clazz, withAnnotation(FixtureMethod.class));
            addMethodMembreTypes(listMembreType, methods);

            LOGGER.debug(" Retrieve and add public field members");
            Set publicFields = getAllFields(clazz, withModifier(Modifier.PUBLIC));
            addFieldMembreTypes(listMembreType, publicFields);

            fixtureType.setClazz(returnTypeToString(clazz));
            listFixtureType.add(fixtureType);

            LOGGER.debug(" Retrieve and add new fixture with method members returning a Collection");
            Set collectionProviderMethods = getAllMethods(clazz, withReturnTypeAssignableTo(Collection.class));
            addCollectionProviderFixtureType(clazz, listFixtureType, collectionProviderMethods);
            LOGGER.debug(" Retrieve and add new fixture with method members annotated with @CollectionProvider or with signature query()");
            collectionProviderMethods = getAllMethods(clazz, withAnnotation(CollectionProvider.class));
            addCollectionProviderFixtureType(clazz, listFixtureType, collectionProviderMethods);
            LOGGER.debug(" Retrieve and add new fixture with method with signature query()");
            collectionProviderMethods = getAllMethods(clazz, and(withName("query"), withParametersCount(0)));
            addCollectionProviderFixtureType(clazz, listFixtureType, collectionProviderMethods);
        }

        return fixturesType;
    }

    private boolean isAbstractFixture(Class clazz) {
        return !(clazz.isEnum() || clazz.isAnnotation() || clazz.isInterface())
                && clazz.isAnnotationPresent(Fixture.class) && clazz.getAnnotation(Fixture.class).isAbstract();
    }

    private void parseFixtureAnnotation(Class clazz, FixtureType fixtureType) {
        Fixture annotation = clazz.getAnnotation(Fixture.class);
        if (annotation.deprecated()) {
            LOGGER.debug("Found Obsolete Fixture");
            fixtureType.setDeprecated(true);
        } else {
            fixtureType.setBestpractice(annotation.bestPractice());
        }
        if (StringUtils.isNotBlank(annotation.value())) {
            fixtureType.setMessage(annotation.value());
        }
        if (annotation.deprecated()) {
            Class[] relatedTo = annotation.relatedTo();
            if (!ArrayUtils.isEmpty(relatedTo)) {
                fixtureType.setReplacingfixture(relatedTo[0].getSimpleName());
                String message = "";
                if (StringUtils.isNotBlank(annotation.value())) {
                    message = annotation.value();
                }
                StringBuilder buffer = new StringBuilder(message).append(" (Replacing Fixture: ");
                for (Class class1 : relatedTo) {
                    buffer.append(class1.getSimpleName()).append(" ");
                }
                buffer.append(")");
                fixtureType.setMessage(buffer.toString());
            }
        }

        if (StringUtils.isNotBlank(annotation.category())) {
            fixtureType.setCategory(annotation.category());
        }

        if (StringUtils.isNotBlank(annotation.usage())) {
            fixtureType.setUsage(annotation.usage());
        }
        if (annotation.toFixAsap()) {
            fixtureType.setTofixasap(true);
        }
        if (annotation.isAbstract()) {
            fixtureType.setCategory(CAT_FIXTURES_ABSTRAITES);
        }
    }

    /**
     * Parsing des FixtureCollection.
     */
    private void addCollectionProviderFixtureType(Class clazz, List listFixtureType, Set methods) {

        for (Method method : methods) {
            if (Collection.class.isAssignableFrom(method.getReturnType())) {
                FixtureType fixtureType = new FixtureType();
                if (method.isAnnotationPresent(FixtureCollection.class)) {
                    FixtureCollection annotation = method.getAnnotation(FixtureCollection.class);
                    if (annotation.deprecated()) {
                        fixtureType.setDeprecated(annotation.deprecated());
                    } else {
                        fixtureType.setBestpractice(annotation.bestPractice());
                    }
                }

                Type genericReturnType = method.getGenericReturnType();
                Class typeClass;
                if (ParameterizedType.class.isAssignableFrom(genericReturnType.getClass())) {
                    ParameterizedType parameterizedReturnType = (ParameterizedType) genericReturnType;
                    LOGGER.debug("Checking the Collection Generic type: {}", parameterizedReturnType);
                    typeClass = (Class) parameterizedReturnType.getActualTypeArguments()[0];
                } else {
                    // We take the Object class
                    typeClass = Object.class;
                }

                fixtureType.setClazz(returnTypeToString(clazz) + "/" + method.getName());
                List listMembreType = fixtureType.getMember();

                if (Modifier.isAbstract(clazz.getModifiers())) {
                    fixtureType.setCategory(CAT_FIXTURES_ABSTRAITES);
                } else {
                    @SuppressWarnings("unchecked")
                    Set allFields = getAllFields(typeClass,
                            and(or(withModifier(Modifier.PUBLIC), withModifier(Modifier.PRIVATE)),
                                    not(withModifier(Modifier.STATIC))));

                    for (Field field : allFields) {
                        MemberType membreType = new MemberType();
                        membreType.setName(field.getName());
                        membreType.setType(TypeMemberEnum.QUERY);
                        membreType.setReturntype(returnTypeToString(field.getType().getSimpleName()));
                        listMembreType.add(membreType);
                    }
                }

                listFixtureType.add(fixtureType);
            } else {
                LOGGER.warn("A method matching the CollectionIterpreter is not returning a Collection: {}", method.toString());
            }
        }

    }

    private void addMethodMembreTypes(List listMembreType, Set methods) {
        if (methods == null) {
            return;
        }
        String returnTypeString;
        for (Method method : methods) {

            returnTypeString = returnTypeToString(method.getGenericReturnType());
            if (!(method.getGenericReturnType() instanceof ParameterizedType)
                    && !StringUtils.contains(returnTypeString, '/')) {
                MemberType membreType = createMembreType(TypeMemberEnum.METHOD,
                        returnTypeToString(method.getGenericReturnType()), method.getName());
                FixtureMethod annotation = method.getAnnotation(FixtureMethod.class);
                if (annotation.deprecated()) {
                    membreType.setBestpractice(false);
                    if (StringUtils.isNotBlank(annotation.replacedWith())) {
                        membreType.setMessage("Replacing Method : " + annotation.replacedWith());
                    }
                    membreType.setDeprecated(true);
                }
                if (annotation.bestPractice()) {
                    membreType.setBestpractice(true);
                }
                if (StringUtils.isNotBlank(annotation.usage())) {
                    membreType.setUsage(annotation.usage());
                }

                List listParameterType = membreType.getParameter();

                for (Class clazzType : method.getParameterTypes()) {
                    ParameterType paramType = new ParameterType();
                    paramType.setType(returnTypeToString(clazzType));
                    listParameterType.add(paramType);
                }
                listMembreType.add(membreType);
            }
        }
    }

    private void addFieldMembreTypes(List listMembreType, Set fields) {
        if (fields == null) {
            return;
        }
        for (Field field : fields) {
            listMembreType.add(createMembreType(TypeMemberEnum.PROPERTY, returnTypeToString(field.getType()),
                    field.getName()));
        }
    }

    private void addClassMembreType(List listMembreType, Constructor[] constructors) {

        for (Constructor constructor : constructors) {
            MemberType membreType = createMembreType(TypeMemberEnum.CONSTRUCTOR, null,
                    returnTypeToString(constructor.getName()));
            List listParametreType = membreType.getParameter();

            for (Class clazz : constructor.getParameterTypes()) {
                ParameterType paramType = new ParameterType();
                paramType.setType(returnTypeToString(clazz));
                listParametreType.add(paramType);
            }
            listMembreType.add(membreType);
        }
    }

    private MemberType createMembreType(TypeMemberEnum typeMembreEnum, String typeRenvoye, String nom) {
        MemberType membreType = new MemberType();
        membreType.setType(typeMembreEnum);
        membreType.setReturntype(typeRenvoye);
        membreType.setName(nom);
        return membreType;

    }

    private String returnTypeToString(Type type) {
        if (type == null) {
            return "undefined";
        }
        if (type instanceof ParameterizedType) {

            Type type2 = ((ParameterizedType) type).getActualTypeArguments()[0];
            String[] strings = StringUtils.split(type2.toString(), '.');
            String strToReturn = strings[strings.length - 1];
            strToReturn = replace(strToReturn, "$", "/");
            return (xsdTypeMap.get(strToReturn) == null) ? strToReturn : xsdTypeMap.get(strToReturn);
        }

        String[] strings = StringUtils.split(type.toString(), '.');
        String strToReturn = strings[strings.length - 1];
        return (xsdTypeMap.get(strToReturn) == null) ? strToReturn : xsdTypeMap.get(strToReturn);

    }

    private String returnTypeToString(Class clazz) {
        if (clazz == null) {
            return "undefined";
        }

        String simpleName = clazz.getSimpleName();
        return (xsdTypeMap.get(simpleName) == null) ? clazz.getSimpleName() : xsdTypeMap.get(clazz.getSimpleName());

    }

    private String returnTypeToString(String className) {
        if (className == null) {
            return "undefined";
        }
        String[] strings = StringUtils.split(className, '.');
        String strToReturn = strings[strings.length - 1];
        return (xsdTypeMap.get(strToReturn) == null) ? strToReturn : xsdTypeMap.get(strToReturn);
    }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy