org.wso2.carbon.apimgt.webapp.publisher.lifecycle.util.AnnotationProcessor.java Source code

Java tutorial

Introduction

Here is the source code for org.wso2.carbon.apimgt.webapp.publisher.lifecycle.util.AnnotationProcessor.java

Source

/*
 * Copyright 2005-2015 WSO2, Inc. (http://wso2.com)
 *
 * 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.wso2.carbon.apimgt.webapp.publisher.lifecycle.util;

import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.SwaggerDefinition;
import org.apache.catalina.core.StandardContext;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.wso2.carbon.apimgt.webapp.publisher.APIPublisherUtil;
import org.wso2.carbon.apimgt.webapp.publisher.config.APIResource;
import org.wso2.carbon.apimgt.webapp.publisher.config.APIResourceConfiguration;
import org.wso2.carbon.apimgt.webapp.publisher.dto.ApiScope;

import javax.servlet.ServletContext;
import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.HttpMethod;
import javax.ws.rs.OPTIONS;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import java.io.File;
import java.io.IOException;
import java.lang.annotation.Annotation;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
import java.security.AccessController;
import java.security.PrivilegedAction;
import java.util.*;

public class AnnotationProcessor {

    private static final Log log = LogFactory.getLog(AnnotationProcessor.class);

    private static final String AUTH_TYPE = "Application & Application User";
    private static final String STRING_ARR = "string_arr";
    private static final String STRING = "string";
    private static final String PACKAGE_ORG_APACHE = "org.apache";
    private static final String PACKAGE_ORG_CODEHAUS = "org.codehaus";
    private static final String PACKAGE_ORG_SPRINGFRAMEWORK = "org.springframework";
    public static final String WILD_CARD = "/*";

    private static final String SWAGGER_ANNOTATIONS_INFO = "info";
    private static final String SWAGGER_ANNOTATIONS_TAGS = "tags";
    private static final String SWAGGER_ANNOTATIONS_EXTENSIONS = "extensions";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES = "properties";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_NAME = "name";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_DESCRIPTION = "description";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_KEY = "key";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_PERMISSIONS = "permissions";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_VERSION = "version";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_CONTEXT = "context";
    private static final String SWAGGER_ANNOTATIONS_PROPERTIES_VALUE = "value";
    private static final String ANNOTATIONS_SCOPES = "scopes";
    private static final String ANNOTATIONS_SCOPE = "scope";
    private static final String DEFAULT_SCOPE_NAME = "default admin scope";
    private static final String DEFAULT_SCOPE_KEY = "perm:admin";
    private static final String DEFAULT_SCOPE_PERMISSION = "/permision/device-mgt";

    private static final String PERMISSION_PREFIX = "/permission/admin";

    private StandardContext context;
    private Method[] pathClazzMethods;
    private Class<Path> pathClazz;
    private ClassLoader classLoader;
    private ServletContext servletContext;
    private Class<SwaggerDefinition> apiClazz;
    private Class<Consumes> consumesClass;
    private Class<Produces> producesClass;
    private Class<io.swagger.annotations.Info> infoClass;
    private Class<io.swagger.annotations.Tag> tagClass;
    private Class<io.swagger.annotations.Extension> extensionClass;
    private Class<io.swagger.annotations.ExtensionProperty> extensionPropertyClass;
    private Class<io.swagger.annotations.ApiOperation> apiOperation;
    private Class<org.wso2.carbon.apimgt.annotations.api.Scope> scopeClass;
    private Class<org.wso2.carbon.apimgt.annotations.api.Scopes> scopesClass;
    private Map<String, ApiScope> apiScopes;

    public AnnotationProcessor(final StandardContext context) {
        servletContext = context.getServletContext();
        classLoader = servletContext.getClassLoader();
        try {
            pathClazz = (Class<Path>) classLoader.loadClass(Path.class.getName());
            consumesClass = (Class<Consumes>) classLoader.loadClass(Consumes.class.getName());
            producesClass = (Class<Produces>) classLoader.loadClass(Produces.class.getName());
            apiClazz = (Class<SwaggerDefinition>) classLoader.loadClass((SwaggerDefinition.class.getName()));
            infoClass = (Class<io.swagger.annotations.Info>) classLoader
                    .loadClass((io.swagger.annotations.Info.class.getName()));
            tagClass = (Class<io.swagger.annotations.Tag>) classLoader
                    .loadClass((io.swagger.annotations.Tag.class.getName()));
            extensionClass = (Class<io.swagger.annotations.Extension>) classLoader
                    .loadClass((io.swagger.annotations.Extension.class.getName()));
            extensionPropertyClass = (Class<io.swagger.annotations.ExtensionProperty>) classLoader
                    .loadClass(io.swagger.annotations.ExtensionProperty.class.getName());
            scopeClass = (Class<org.wso2.carbon.apimgt.annotations.api.Scope>) classLoader
                    .loadClass(org.wso2.carbon.apimgt.annotations.api.Scope.class.getName());
            scopesClass = (Class<org.wso2.carbon.apimgt.annotations.api.Scopes>) classLoader
                    .loadClass(org.wso2.carbon.apimgt.annotations.api.Scopes.class.getName());
            apiOperation = (Class<io.swagger.annotations.ApiOperation>) classLoader
                    .loadClass((io.swagger.annotations.ApiOperation.class.getName()));
        } catch (ClassNotFoundException e) {
            log.error("An error has occurred while loading classes ", e);
        }
    }

    public Set<String> scanStandardContext(String className) throws IOException {
        ExtendedAnnotationDB db = new ExtendedAnnotationDB();
        db.addIgnoredPackages(PACKAGE_ORG_APACHE);
        db.addIgnoredPackages(PACKAGE_ORG_CODEHAUS);
        db.addIgnoredPackages(PACKAGE_ORG_SPRINGFRAMEWORK);
        URL classPath = findWebInfClassesPath(servletContext);
        db.scanArchives(classPath);
        return db.getAnnotationIndex().get(className);
    }

    public List<APIResourceConfiguration> extractAPIInfo(final ServletContext servletContext,
            Set<String> entityClasses) throws ClassNotFoundException {
        List<APIResourceConfiguration> apiResourceConfigs = new ArrayList<APIResourceConfiguration>();
        if (entityClasses != null && !entityClasses.isEmpty()) {
            for (final String className : entityClasses) {
                APIResourceConfiguration apiResourceConfiguration = AccessController
                        .doPrivileged(new PrivilegedAction<APIResourceConfiguration>() {
                            public APIResourceConfiguration run() {
                                Class<?> clazz = null;
                                APIResourceConfiguration apiResourceConfig = null;
                                try {
                                    clazz = classLoader.loadClass(className);
                                    Annotation swaggerDefinition = clazz.getAnnotation(apiClazz);
                                    Annotation Scopes = clazz.getAnnotation(scopesClass);
                                    List<APIResource> resourceList;
                                    if (swaggerDefinition != null) {
                                        if (log.isDebugEnabled()) {
                                            log.debug("Application Context root = "
                                                    + servletContext.getContextPath());
                                        }
                                        try {
                                            apiResourceConfig = processAPIAnnotation(swaggerDefinition);
                                            if (Scopes != null) {
                                                apiScopes = processAPIScopes(Scopes);
                                            }
                                            if (apiResourceConfig != null) {
                                                String rootContext = servletContext.getContextPath();
                                                pathClazzMethods = pathClazz.getMethods();
                                                Annotation rootContectAnno = clazz.getAnnotation(pathClazz);
                                                String subContext;
                                                if (rootContectAnno != null) {
                                                    subContext = invokeMethod(pathClazzMethods[0], rootContectAnno,
                                                            STRING);
                                                    if (subContext != null && !subContext.isEmpty()) {
                                                        if (subContext.trim().startsWith("/")) {
                                                            rootContext = rootContext + subContext;
                                                        } else {
                                                            rootContext = rootContext + "/" + subContext;
                                                        }
                                                    }
                                                    if (log.isDebugEnabled()) {
                                                        log.debug("API Root  Context = " + rootContext);
                                                    }
                                                }
                                                Method[] annotatedMethods = clazz.getDeclaredMethods();
                                                resourceList = getApiResources(rootContext, annotatedMethods);
                                                apiResourceConfig.setResources(resourceList);
                                            }

                                        } catch (Throwable throwable) {
                                            log.error("Error encountered while scanning for annotations",
                                                    throwable);
                                        }
                                    }
                                } catch (ClassNotFoundException e1) {
                                    String msg = "Failed to load service class " + className
                                            + " for publishing APIs." + " This API will not be published.";
                                    log.error(msg, e1);
                                } catch (RuntimeException e) {
                                    log.error("Unexpected error has been occurred while publishing " + className
                                            + "hence, this API will not be published.");
                                    throw new RuntimeException(e);
                                }
                                return apiResourceConfig;
                            }
                        });
                if (apiResourceConfiguration != null)
                    apiResourceConfigs.add(apiResourceConfiguration);
            }
        }
        return apiResourceConfigs;
    }

    private Map<String, ApiScope> processAPIScopes(Annotation annotation) throws Throwable {
        Map<String, ApiScope> scopes = new HashMap<>();

        InvocationHandler methodHandler = Proxy.getInvocationHandler(annotation);
        Annotation[] annotatedScopes = (Annotation[]) methodHandler.invoke(annotation,
                scopesClass.getMethod(ANNOTATIONS_SCOPES, null), null);

        ApiScope scope;
        String permissions[];
        StringBuilder aggregatedPermissions;
        for (int i = 0; i < annotatedScopes.length; i++) {
            aggregatedPermissions = new StringBuilder();
            methodHandler = Proxy.getInvocationHandler(annotatedScopes[i]);
            scope = new ApiScope();
            scope.setName(invokeMethod(scopeClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_NAME),
                    annotatedScopes[i], STRING));
            scope.setDescription(invokeMethod(scopeClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_DESCRIPTION),
                    annotatedScopes[i], STRING));
            scope.setKey(invokeMethod(scopeClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_KEY), annotatedScopes[i],
                    STRING));
            permissions = (String[]) methodHandler.invoke(annotatedScopes[i],
                    scopeClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_PERMISSIONS, null), null);
            for (String permission : permissions) {
                aggregatedPermissions.append(PERMISSION_PREFIX);
                aggregatedPermissions.append(permission);
                aggregatedPermissions.append(" ");
            }
            scope.setRoles(aggregatedPermissions.toString().trim());
            scopes.put(scope.getKey(), scope);
        }
        return scopes;
    }

    /**
     * Get Resources for each API
     *
     * @param resourceRootContext
     * @param annotatedMethods
     * @return
     * @throws Throwable
     */
    private List<APIResource> getApiResources(String resourceRootContext, Method[] annotatedMethods)
            throws Throwable {
        List<APIResource> resourceList = new ArrayList<>();
        String subCtx = null;
        for (Method method : annotatedMethods) {
            Annotation[] annotations = method.getDeclaredAnnotations();
            APIResource resource = new APIResource();
            if (isHttpMethodAvailable(annotations)) {
                Annotation methodContextAnno = method.getAnnotation(pathClazz);
                if (methodContextAnno != null) {
                    subCtx = invokeMethod(pathClazzMethods[0], methodContextAnno, STRING);
                } else {
                    subCtx = WILD_CARD;
                }
                resource.setUriTemplate(makeContextURLReady(subCtx));
                resource.setUri(APIPublisherUtil.getServerBaseUrl() + makeContextURLReady(resourceRootContext)
                        + makeContextURLReady(subCtx));
                resource.setAuthType(AUTH_TYPE);
                for (int i = 0; i < annotations.length; i++) {
                    processHTTPMethodAnnotation(resource, annotations[i]);
                    if (annotations[i].annotationType().getName().equals(Consumes.class.getName())) {
                        Method[] consumesClassMethods = consumesClass.getMethods();
                        Annotation consumesAnno = method.getAnnotation(consumesClass);
                        resource.setConsumes(invokeMethod(consumesClassMethods[0], consumesAnno, STRING_ARR));
                    }
                    if (annotations[i].annotationType().getName().equals(Produces.class.getName())) {
                        Method[] producesClassMethods = producesClass.getMethods();
                        Annotation producesAnno = method.getAnnotation(producesClass);
                        resource.setProduces(invokeMethod(producesClassMethods[0], producesAnno, STRING_ARR));
                    }
                    if (annotations[i].annotationType().getName().equals(ApiOperation.class.getName())) {
                        ApiScope scope = this.getScope(annotations[i]);
                        if (scope != null) {
                            resource.setScope(scope);
                        } else {
                            log.warn("Scope is not defined for '" + makeContextURLReady(resourceRootContext)
                                    + makeContextURLReady(subCtx)
                                    + "' endpoint, hence assigning the default scope");
                            scope = new ApiScope();
                            scope.setName(DEFAULT_SCOPE_NAME);
                            scope.setDescription(DEFAULT_SCOPE_NAME);
                            scope.setKey(DEFAULT_SCOPE_KEY);
                            scope.setRoles(DEFAULT_SCOPE_PERMISSION);
                            resource.setScope(scope);
                        }
                    }
                }
                resourceList.add(resource);
            }
        }
        return resourceList;
    }

    /**
     * Read Method annotations indicating HTTP Methods
     *
     * @param resource
     * @param annotation
     */
    private void processHTTPMethodAnnotation(APIResource resource, Annotation annotation) {
        if (annotation.annotationType().getName().equals(GET.class.getName())) {
            resource.setHttpVerb(HttpMethod.GET);
        }
        if (annotation.annotationType().getName().equals(POST.class.getName())) {
            resource.setHttpVerb(HttpMethod.POST);
        }
        if (annotation.annotationType().getName().equals(OPTIONS.class.getName())) {
            resource.setHttpVerb(HttpMethod.OPTIONS);
        }
        if (annotation.annotationType().getName().equals(DELETE.class.getName())) {
            resource.setHttpVerb(HttpMethod.DELETE);
        }
        if (annotation.annotationType().getName().equals(PUT.class.getName())) {
            resource.setHttpVerb(HttpMethod.PUT);
        }
    }

    private boolean isHttpMethodAvailable(Annotation[] annotations) {
        for (Annotation annotation : annotations) {
            if (annotation.annotationType().getName().equals(GET.class.getName())) {
                return true;
            } else if (annotation.annotationType().getName().equals(POST.class.getName())) {
                return true;
            } else if (annotation.annotationType().getName().equals(OPTIONS.class.getName())) {
                return true;
            } else if (annotation.annotationType().getName().equals(DELETE.class.getName())) {
                return true;
            } else if (annotation.annotationType().getName().equals(PUT.class.getName())) {
                return true;
            }
        }
        return false;
    }

    /**
     * Iterate API annotation and build API Configuration
     *
     * @param annotation reading @SwaggerDefinition annotation
     * @return APIResourceConfiguration which compose with an API information which has its name, context,version,and tags
     * @throws Throwable
     */
    private APIResourceConfiguration processAPIAnnotation(Annotation annotation) throws Throwable {
        InvocationHandler methodHandler = Proxy.getInvocationHandler(annotation);
        Annotation info = (Annotation) methodHandler.invoke(annotation,
                apiClazz.getMethod(SWAGGER_ANNOTATIONS_INFO, null), null);
        Annotation[] tags = (Annotation[]) methodHandler.invoke(annotation,
                apiClazz.getMethod(SWAGGER_ANNOTATIONS_TAGS, null), null);
        String[] tagNames = new String[tags.length];
        for (int i = 0; i < tags.length; i++) {
            methodHandler = Proxy.getInvocationHandler(tags[i]);
            tagNames[i] = (String) methodHandler.invoke(tags[i],
                    tagClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_NAME, null), null);
        }
        methodHandler = Proxy.getInvocationHandler(info);
        String version = (String) methodHandler.invoke(info,
                infoClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_VERSION, null), null);
        if ("".equals(version))
            return null;
        Annotation[] apiInfo = (Annotation[]) methodHandler.invoke(info,
                infoClass.getMethod(SWAGGER_ANNOTATIONS_EXTENSIONS, null), null);
        methodHandler = Proxy.getInvocationHandler(apiInfo[0]);
        Annotation[] properties = (Annotation[]) methodHandler.invoke(apiInfo[0],
                extensionClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES, null), null);
        APIResourceConfiguration apiResourceConfig = new APIResourceConfiguration();
        for (Annotation property : properties) {
            methodHandler = Proxy.getInvocationHandler(property);
            String key = (String) methodHandler.invoke(property,
                    extensionPropertyClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_NAME, null), null);
            String value = (String) methodHandler.invoke(property,
                    extensionPropertyClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_VALUE, null), null);
            if ("".equals(key))
                return null;
            switch (key) {
            case SWAGGER_ANNOTATIONS_PROPERTIES_NAME:
                if ("".equals(value))
                    return null;
                apiResourceConfig.setName(value);
                break;
            case SWAGGER_ANNOTATIONS_PROPERTIES_CONTEXT:
                if ("".equals(value))
                    return null;
                apiResourceConfig.setContext(value);
                break;
            default:
                break;
            }
        }
        apiResourceConfig.setVersion(version);
        apiResourceConfig.setTags(tagNames);
        return apiResourceConfig;
    }

    /**
     * Append '/' to the context and make it URL ready
     *
     * @param context
     * @return
     */
    private String makeContextURLReady(String context) {
        if (context != null && context.length() > 0) {
            if (context.startsWith("/")) {
                return context;
            } else {
                return "/" + context;
            }
        }
        return "";
    }

    /**
     * When an annotation and method is passed, this method invokes that executes said method against the annotation
     *
     * @param method
     * @param annotation
     * @param returnType
     * @return
     * @throws Throwable
     */
    private String invokeMethod(Method method, Annotation annotation, String returnType) throws Throwable {
        InvocationHandler methodHandler = Proxy.getInvocationHandler(annotation);
        switch (returnType) {
        case STRING:
            return (String) methodHandler.invoke(annotation, method, null);
        case STRING_ARR:
            return ((String[]) methodHandler.invoke(annotation, method, null))[0];
        default:
            return null;
        }
    }

    /**
     * Find the URL pointing to "/WEB-INF/classes"  This method may not work in conjunction with IteratorFactory
     * if your servlet container does not extract the /WEB-INF/classes into a real file-based directory
     *
     * @param servletContext
     * @return null if cannot determin /WEB-INF/classes
     */
    private static URL findWebInfClassesPath(ServletContext servletContext) {
        String path = servletContext.getRealPath("/WEB-INF/classes");
        if (path == null)
            return null;
        File fp = new File(path);
        if (fp.exists() == false)
            return null;
        try {
            URI uri = fp.toURI();
            return uri.toURL();
        } catch (MalformedURLException e) {
            throw new RuntimeException(e);
        }
    }

    private ApiScope getScope(Annotation currentMethod) throws Throwable {
        InvocationHandler methodHandler = Proxy.getInvocationHandler(currentMethod);
        Annotation[] extensions = (Annotation[]) methodHandler.invoke(currentMethod,
                apiOperation.getMethod(SWAGGER_ANNOTATIONS_EXTENSIONS, null), null);
        if (extensions != null) {
            methodHandler = Proxy.getInvocationHandler(extensions[0]);
            Annotation[] properties = (Annotation[]) methodHandler.invoke(extensions[0],
                    extensionClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES, null), null);
            String scopeKey;
            String propertyName;
            for (Annotation property : properties) {
                methodHandler = Proxy.getInvocationHandler(property);
                propertyName = (String) methodHandler.invoke(property,
                        extensionPropertyClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_NAME, null), null);
                if (ANNOTATIONS_SCOPE.equals(propertyName)) {
                    scopeKey = (String) methodHandler.invoke(property,
                            extensionPropertyClass.getMethod(SWAGGER_ANNOTATIONS_PROPERTIES_VALUE, null), null);
                    if (scopeKey.isEmpty()) {
                        return null;
                    }
                    return apiScopes.get(scopeKey);
                }
            }
        }
        return null;
    }
}