SynapseHandlersLoader.java

/*
 *  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.config;


import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.OMNode;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.SynapseHandler;
import org.apache.synapse.SynapseConstants;
import org.apache.synapse.SynapseException;
import org.apache.synapse.commons.util.MiscellaneousUtil;
import org.apache.synapse.commons.util.PropertyHelper;

import javax.xml.namespace.QName;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

/**
 * Helper class to load synapse handlers to the synapse environment
 */
public class SynapseHandlersLoader {


    private static final QName ROOT_Q = new QName("handlers");
    private static final QName HANDLER_Q = new QName("handler");
    private static final QName CLASS_Q = new QName("class");
    private static final QName NAME_ATT = new QName("name");
    private static final QName PARAM_Q = new QName("parameter");
    private static final QName VALUE_ATT = new QName("value");

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

    /**
     * Load and get all synapse handlers
     *
     * @return List of loaded synapse handlers
     */
    public static List<SynapseHandler> loadHandlers() {
        List<SynapseHandler> handlers = new ArrayList<>();
        OMElement handlersConfig =
                MiscellaneousUtil.loadXMLConfig(SynapseConstants.SYNAPSE_HANDLER_FILE);
        if (handlersConfig != null) {

            if (!ROOT_Q.equals(handlersConfig.getQName())) {
                handleException("Invalid handler configuration file");
            }

            Iterator iterator = handlersConfig.getChildrenWithName(HANDLER_Q);
            while (iterator.hasNext()) {
                OMElement handlerElem = (OMElement) iterator.next();

                String name = null;
                if (handlerElem.getAttribute(NAME_ATT) != null) {
                    name = handlerElem.getAttributeValue(NAME_ATT);
                } else {
                    handleException("Name not defined in one or more handlers");
                }

                if (handlerElem.getAttribute(CLASS_Q) != null) {
                    String className = handlerElem.getAttributeValue(CLASS_Q);
                    if (!"".equals(className)) {
                        SynapseHandler handler = createHandler(className);
                        if (handler != null) {
                            handlers.add(handler);
                            handler.setName(name);
                            populateParameters(handlerElem, handler);
                        }
                    } else {
                        handleException("Class name is null for handle name : " + name);
                    }
                } else {
                    handleException("Class name not defined for handler named : " + name);
                }

            }
        }
        return handlers;
    }

    private static SynapseHandler createHandler(String classFQName) {
        Object obj = null;
        try {
            obj = Class.forName(classFQName).newInstance();
        } catch (ClassNotFoundException | InstantiationException | IllegalAccessException e) {
            handleException("Error creating Handler for class name : " + classFQName, e);
        }

        if (obj instanceof SynapseHandler) {
            return (SynapseHandler) obj;
        } else {
            handleException("Error creating Handler. The Handler should be of type " +
                            "org.apache.synapse.Handler");
        }
        return null;
    }

    private static void populateParameters(OMElement handlerElem, SynapseHandler handler) {

        for (Iterator it = handlerElem.getChildrenWithName(PARAM_Q); it.hasNext();) {
            OMElement child = (OMElement) it.next();

            String propName = child.getAttribute(NAME_ATT).getAttributeValue();
            if (propName == null) {
                handleException("Synapse Handler parameter must contain the name attribute");
            } else {
                if (child.getAttribute(VALUE_ATT) != null) {
                    String value = child.getAttribute(VALUE_ATT).getAttributeValue();
                    handler.addProperty(propName, value);
                    PropertyHelper.setInstanceProperty(propName, value, handler);
                } else {
                    OMNode omElt = child.getFirstElement();
                    if (omElt != null) {
                        handler.addProperty(propName, omElt);
                        PropertyHelper.setInstanceProperty(propName, omElt, handler);
                    } else {
                        handleException("Synapse Handler parameter must contain " +
                                        "name and value attributes, or a name and a child XML fragment");
                    }
                }
            }
        }
    }

    private static void handleException(String msg) {
        log.error(msg);
        throw new SynapseException(msg);
    }

    private static void handleException(String msg, Exception ex) {
        log.error(msg, ex);
        throw new SynapseException(msg, ex);
    }

}