/*
* 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.OMAttribute;
import org.apache.axiom.om.OMElement;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.SynapseException;
import org.apache.synapse.Mediator;
import org.apache.synapse.config.Endpoint;
import org.apache.synapse.mediators.builtin.SendMediator;
import javax.xml.namespace.QName;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Iterator;
/**
* The Send mediator factory parses a Send element and creates an instance of the mediator
*
* //TODO support endpoints, failover and loadbalacing
*
* The <send> element is used to send messages out of Synapse to some endpoint. In the simplest case,
* the place to send the message to is implicit in the message (via a property of the message itself)-
* that is indicated by the following
* <pre>
* <send/>
* </pre>
*
* If the message is to be sent to one or more endpoints, then the following is used:
* <pre>
* <send>
* (endpointref | endpoint)+
* </send>
* </pre>
* where the endpointref token refers to the following:
* <pre>
* <endpoint ref="name"/>
* </pre>
* and the endpoint token refers to an anonymous endpoint defined inline:
* <pre>
* <endpoint address="url"/>
* </pre>
* If the message is to be sent to an endpoint selected by load balancing across a set of endpoints,
* then it is indicated by the following:
* <pre>
* <send>
* <load-balance algorithm="uri">
* (endpointref | endpoint)+
* </load-balance>
* </send>
* </pre>
* Similarly, if the message is to be sent to an endpoint with failover semantics, then it is indicated by the following:
* <pre>
* <send>
* <failover>
* (endpointref | endpoint)+
* </failover>
* </send>
* </pre>
*/
public class SendMediatorFactory implements MediatorFactory {
private static final Log log = LogFactory.getLog(SendMediatorFactory.class);
private static final QName SEND_Q = new QName(Constants.SYNAPSE_NAMESPACE, "send");
public Mediator createMediator(OMElement elem) {
SendMediator sm = new SendMediator();
Iterator iter = elem.getChildrenWithName(new QName(Constants.SYNAPSE_NAMESPACE, "endpoint"));
while (iter.hasNext()) {
OMElement endptElem = (OMElement) iter.next();
Endpoint endpt = EndpointFactory.createEndpoint(endptElem, true);
sm.addEndpoint(endpt);
}
return sm;
}
public QName getTagQName() {
return SEND_Q;
}
}