Package org.apache.synapse.deployers

Source Code of org.apache.synapse.deployers.ExtensionDeployer

/*
*  Licensed to the Apache Software Foundation (ASF) under one
*  or more contributor license agreements.  See the NOTICE file
*  distributed with this work for additional information
*  regarding copyright ownership.  The ASF licenses this file
*  to you 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.apache.synapse.deployers;

import java.io.BufferedReader;
import java.io.File;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.LinkedList;
import java.util.List;

import javax.xml.namespace.QName;

import org.apache.axis2.Constants;
import org.apache.axis2.context.ConfigurationContext;
import org.apache.axis2.deployment.AbstractDeployer;
import org.apache.axis2.deployment.DeploymentClassLoader;
import org.apache.axis2.deployment.DeploymentException;
import org.apache.axis2.deployment.repository.util.DeploymentFileData;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.config.xml.MediatorFactory;
import org.apache.synapse.config.xml.MediatorFactoryFinder;
import org.apache.synapse.config.xml.MediatorSerializer;
import org.apache.synapse.config.xml.MediatorSerializerFinder;
import org.apache.synapse.config.xml.StartupFactory;
import org.apache.synapse.config.xml.StartupFinder;

/**
* This will support the hot deployment and hot update of Synapse extensions (mediators
* and startups) at runtime using the Axis2 concepts of deployers.
*/
public class ExtensionDeployer extends AbstractDeployer {

    /**
     * Holds the log variable for logging purposes
     */
    private static final Log log = LogFactory.getLog(ExtensionDeployer.class);

    /**
     * ConfigurationContext of Axis2
     */
    private ConfigurationContext cfgCtx = null;

    /**
     * Initializes the Deployer
     *
     * @param configurationContext - ConfigurationContext of Axis2 from which
     *  the deployer is initialized
     */
    public void init(ConfigurationContext configurationContext) {
        this.cfgCtx = configurationContext;
    }

    /**
     * This will be called when there is a change in the specified deployment
     * folder (in the axis2.xml) and this will load the relevant classes to the system and
     * register them with the MediatorFactoryFinder
     *
     * @param deploymentFileData - describes the updated file
     * @throws DeploymentException - in case an error on the deployment
     */
    public void deploy(DeploymentFileData deploymentFileData) throws DeploymentException {

        log.info("Loading extensions from: " + deploymentFileData.getAbsolutePath());

        // get the context class loader for the later restore of the context class loader
        ClassLoader prevCl = Thread.currentThread().getContextClassLoader();

        try {
            boolean isDirectory = deploymentFileData.getFile().isDirectory();
            deploymentFileData.setClassLoader(isDirectory, getClass().getClassLoader(),
                    (File) cfgCtx.getAxisConfiguration().getParameterValue(
                            Constants.Configuration.ARTIFACTS_TEMP_DIR),
                    cfgCtx.getAxisConfiguration().isChildFirstClassLoading());

            DeploymentClassLoader urlCl
                = (DeploymentClassLoader)deploymentFileData.getClassLoader();
            Thread.currentThread().setContextClassLoader(urlCl);

            // StartupFactory registration
            for (StartupFactory factory : getProviders(StartupFactory.class, urlCl)) {
                QName tagQName = factory.getTagQName();
                Class<? extends StartupFactory> clazz = factory.getClass();
                StartupFinder finder = StartupFinder.getInstance();
                finder.getFactoryMap().put(tagQName, clazz);
                finder.getSerializerMap().put(tagQName, factory.getSerializerClass());
                log.info("Registered startup factory and serializer for " + tagQName);
            }

            // MediatorFactory registration
            for (MediatorFactory factory : getProviders(MediatorFactory.class, urlCl)) {
                QName tagQName = factory.getTagQName();
                Class<? extends MediatorFactory> clazz = factory.getClass();
                MediatorFactoryFinder.getInstance().getFactoryMap().put(tagQName, clazz);
                log.info("Registered mediator factory " + clazz.getName() + " for " + tagQName);
            }

            // MediatorSerializer registration
            for (MediatorSerializer serializer : getProviders(MediatorSerializer.class, urlCl)) {
                String mediatorClassName = serializer.getMediatorClassName();
                MediatorSerializerFinder.getInstance().getSerializerMap().put(
                        mediatorClassName, serializer);
                log.info("Registered mediator serializer " + serializer.getClass().getName()
                        + " for " + mediatorClassName);
            }
           
        } catch (IOException e) {
            handleException("I/O error in reading the mediator jar file", e);
        } catch (Exception e) {
            handleException("Error occurred while trying to deploy mediator jar file", e);
        } catch (Throwable t) {
            handleException("Error occurred while trying to deploy the mediator jar file", t);
        } finally {
            // restore the class loader back
            if (log.isDebugEnabled()) {
                log.debug("Restoring the context class loader to the original");
            }
            Thread.currentThread().setContextClassLoader(prevCl);
        }
    }
   
    private <T> List<T> getProviders(Class<T> providerClass, URLClassLoader loader)
            throws IOException {
       
        List<T> providers = new LinkedList<T>();
        String providerClassName = providerClass.getName();
        providerClassName = providerClassName.substring(providerClassName.indexOf('.')+1);
        URL servicesURL = loader.findResource("META-INF/services/" + providerClass.getName());
        if (servicesURL != null) {
            BufferedReader in
                = new BufferedReader(new InputStreamReader(servicesURL.openStream()));
            try {
                String className;
                while ((className = in.readLine()) != null) {
                    log.info("Loading the " + providerClassName + " implementation: " + className);
                    try {
                        Class<? extends T> clazz
                            = loader.loadClass(className).asSubclass(providerClass);
                        providers.add(clazz.newInstance());
                    } catch (ClassNotFoundException e) {
                        handleException("Unable to find the specified class on the path or " +
                            "in the jar file", e);
                    } catch (IllegalAccessException e) {
                        handleException("Unable to load the class from the jar", e);
                    } catch (InstantiationException e) {
                        handleException("Unable to instantiate the class specified", e);
                    }
                }
            } finally {
                in.close();
            }
        }
        return providers;
    }

    /**
     * This will not be implemented because we do not support changing the directory at runtime
     *
     * @param string -
     */
    public void setDirectory(String string) {
        // we do not support changing the directory
    }

    /**
     * This will not be implemented because we do not support changing the extension at runtime
     *
     * @param string -
     */
    public void setExtension(String string) {
        // we do not support changing the extension
    }

    /**
     * This will be called when a particular jar file is deleted from the specified folder.
     *
     * @param string - filename of the deleted file
     * @throws DeploymentException - incase of an error in undeployment
     */
    public void undeploy(String string) throws DeploymentException {
        // todo: implement the undeployement
    }

    private void handleException(String message, Exception e) throws DeploymentException {
        if (log.isDebugEnabled()) {
            log.debug(message, e);
        }
        throw new DeploymentException(message, e);
    }

    private void handleException(String message, Throwable t) throws DeploymentException {
        if (log.isDebugEnabled()) {
            log.debug(message, t);
        }
        throw new DeploymentException(message, t);
    }
}
TOP

Related Classes of org.apache.synapse.deployers.ExtensionDeployer

TOP
Copyright © 2018 www.massapi.com. All rights reserved.
All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.