/*
* 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.xml;
import org.apache.axiom.om.OMAbstractFactory;
import org.apache.axiom.om.OMComment;
import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.OMFactory;
import org.apache.axiom.om.OMNamespace;
import org.apache.axiom.om.xpath.AXIOMXPath;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.Mediator;
import org.apache.synapse.SynapseConstants;
import org.apache.synapse.SynapseException;
import org.apache.synapse.aspects.AspectConfigurable;
import org.apache.synapse.aspects.statistics.StatisticsConfigurable;
import org.apache.synapse.mediators.MediatorProperty;
import org.apache.synapse.mediators.builtin.CommentMediator;
import javax.xml.namespace.QName;
import java.util.Collection;
import java.util.List;
/**
* Parent class for all the {@link MediatorSerializer} implementations
*/
public abstract class AbstractMediatorSerializer implements MediatorSerializer {
/** the standard log for mediators, will assign the logger for the actual subclass */
protected static Log log;
protected static final OMFactory fac = OMAbstractFactory.getOMFactory();
protected static final OMNamespace synNS = SynapseConstants.SYNAPSE_OMNAMESPACE;
protected static final OMNamespace nullNS
= fac.createOMNamespace(XMLConfigConstants.NULL_NAMESPACE, "");
protected static final QName PROP_Q
= new QName(XMLConfigConstants.SYNAPSE_NAMESPACE, "property");
protected static final QName DESCRIPTION_Q
= new QName(XMLConfigConstants.SYNAPSE_NAMESPACE, "description");
/**
* A constructor that makes subclasses pick up the correct logger
*/
protected AbstractMediatorSerializer() {
log = LogFactory.getLog(this.getClass());
}
/**
* Serializes the given mediator into XML element. This method handles
* adding the common information from the respective mediators to the element it get by
* delegating the mediator specific serialization to the
* {@link #serializeSpecificMediator(org.apache.synapse.Mediator)} method, which has tobe
* implemented by the respective mediators</p>
*
* <p>It is treating the {@link org.apache.synapse.config.xml.AnonymousListMediator} as a
* special case and calls it's children serialization, since there is nothing specific to be
* serialized in that case</p>
*
* <p>This method has been marked as <code>final</code> to avoid mistakenly overwriting
* this method instead of the {@link #serializeSpecificMediator(org.apache.synapse.Mediator)}
* by the sub classes
*
* @param parent the OMElement to which the serialization should be attached
* @param m mediator to be serialized
* @return the serialized Element
*/
public final OMElement serializeMediator(OMElement parent, Mediator m) {
OMElement serializedElement = null;
if (m instanceof AnonymousListMediator) {
((AnonymousListMediatorSerializer) this).serializeChildren(parent,
((AnonymousListMediator) m).getList());
serializedElement = parent;
} else if (m instanceof CommentMediator) {
// serialize comment mediator
serializedElement = serializeComments(parent, m);
} else {
// delegate the specific serializations to it's serializer
OMElement elem = serializeSpecificMediator(m);
if (m.getDescription() != null) {
OMElement descriptionElem = fac.createOMElement(DESCRIPTION_Q, elem);
descriptionElem.setText(m.getDescription());
elem.addChild(descriptionElem);
}
if (m.getShortDescription() != null) {
elem.addAttribute(
fac.createOMAttribute("description", nullNS, m.getShortDescription()));
}
// attach the serialized element to the parent
if (parent != null) {
parent.addChild(elem);
}
serializedElement = elem;
}
return serializedElement;
}
/**
* Specific mediator factory implementations should implement this method to build the
* {@link org.apache.synapse.Mediator} by the given XML configuration
*
* @param m mediator to be serialized
* @return serialized element of the mediator
*/
protected abstract OMElement serializeSpecificMediator(Mediator m);
/**
* Perform common functions and finalize the mediator serialization.
* i.e. process any common attributes
*
* @param mediatorOmElement the OMElement being created
* @param mediator the Mediator instance being serialized
*/
protected static void saveTracingState(OMElement mediatorOmElement, Mediator mediator) {
int traceState = mediator.getTraceState();
String traceValue = null;
if (traceState == org.apache.synapse.SynapseConstants.TRACING_ON) {
traceValue = XMLConfigConstants.TRACE_ENABLE;
} else if (traceState == org.apache.synapse.SynapseConstants.TRACING_OFF) {
traceValue = XMLConfigConstants.TRACE_DISABLE;
}
if (traceValue != null) {
mediatorOmElement.addAttribute(fac.createOMAttribute(
XMLConfigConstants.TRACE_ATTRIB_NAME, nullNS, traceValue));
}
if (mediator instanceof AspectConfigurable) {
StatisticsConfigurable statisticsConfigurable =
((AspectConfigurable) mediator).getAspectConfiguration();
if (statisticsConfigurable != null &&
statisticsConfigurable.isStatisticsEnable()) {
mediatorOmElement.addAttribute(fac.createOMAttribute(
XMLConfigConstants.STATISTICS_ATTRIB_NAME, nullNS,
XMLConfigConstants.STATISTICS_ENABLE));
}
if (statisticsConfigurable != null &&
statisticsConfigurable.isTracingEnabled()) {
mediatorOmElement.addAttribute(fac.createOMAttribute(
XMLConfigConstants.TRACE_ATTRIB_NAME, nullNS,
XMLConfigConstants.TRACE_ENABLE));
}
}
}
protected void serializeMediatorProperties(OMElement parent,
Collection<MediatorProperty> props,
QName childElementName) {
for (MediatorProperty mp : props) {
OMElement prop = fac.createOMElement(childElementName, parent);
if (mp.getName() != null) {
prop.addAttribute(fac.createOMAttribute("name", nullNS, mp.getName()));
} else {
handleException("Mediator property name missing");
}
if (mp.getValue() != null) {
prop.addAttribute(fac.createOMAttribute("value", nullNS, mp.getValue()));
} else if (mp.getExpression() != null) {
SynapsePathSerializer.serializePath(mp.getExpression(), prop, "expression");
} else {
handleException("Mediator property must have a literal value or be an expression");
}
}
}
protected void serializeMediatorProperties(OMElement parent,
Collection<MediatorProperty> props) {
serializeMediatorProperties(parent, props, PROP_Q);
}
protected void serializeProperties(OMElement parent, Collection<MediatorProperty> props) {
serializeMediatorProperties(parent, props);
}
protected void serializeNamespaces(OMElement elem, AXIOMXPath xpath) {
for (Object obj : xpath.getNamespaces().keySet()) {
String prefix = (String) obj;
String uri = xpath.getNamespaceContext().translateNamespacePrefixToUri(prefix);
if (!XMLConfigConstants.SYNAPSE_NAMESPACE.equals(uri)) {
elem.declareNamespace(uri, prefix);
}
}
}
protected void handleException(String msg) {
LogFactory.getLog(this.getClass()).error(msg);
throw new SynapseException(msg);
}
protected void handleException(String msg, Exception e) {
LogFactory.getLog(this.getClass()).error(msg, e);
throw new SynapseException(msg, e);
}
/**
* Serialize String Comment entries from a List
*
* @param parent OMElement to be updated
* @param commentList List of comment entries to be serialized
*/
protected void serializeComments(OMElement parent, List<String> commentList) {
for (String comment : commentList) {
OMComment commendNode = fac.createOMComment(parent, "comment");
commendNode.setValue(comment);
parent.addChild(commendNode);
}
}
/**
* Serialize String Comment entries from a List
*
* @param parent OMElement to be updated
* @param m Comment mediator instance which contains comment information
*/
protected OMElement serializeComments(OMElement parent, Mediator m) {
OMComment commendNode = fac.createOMComment(parent, "comment");
commendNode.setValue(((CommentMediator) m).getCommentText());
parent.addChild(commendNode);
return parent;
}
}