Modified: incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_8.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_8.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_8.xml (original) +++ incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_8.xml Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <synapse xmlns="http://ws.apache.org/ns/synapse";> <!-- introduction to URL source properties, registry based properties and the XSLT mediator -->
Modified: incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_js.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_js.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_js.xml (original) +++ incubator/synapse/trunk/java/repository/conf/sample/synapse_sample_js.xml Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <synapse xmlns="http://ws.apache.org/ns/synapse"; xmlns:js="http://ws.apache.org/ns/synapse/js";> <rules> Modified: incubator/synapse/trunk/java/repository/conf/synapse.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/repository/conf/synapse.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/repository/conf/synapse.xml (original) +++ incubator/synapse/trunk/java/repository/conf/synapse.xml Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <synapse xmlns="http://ws.apache.org/ns/synapse";> <!-- The most simple Synapse configuration --> Modified: incubator/synapse/trunk/java/src/main/assembly/bin.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/main/assembly/bin.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/main/assembly/bin.xml (original) +++ incubator/synapse/trunk/java/src/main/assembly/bin.xml Fri Nov 17 04:41:15 2006 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- - * 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. ---> + ~ 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. + --> <assembly> <id>bin</id> <includeBaseDirectory>false</includeBaseDirectory> Modified: incubator/synapse/trunk/java/src/main/assembly/src.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/main/assembly/src.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/main/assembly/src.xml (original) +++ incubator/synapse/trunk/java/src/main/assembly/src.xml Fri Nov 17 04:41:15 2006 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- - * 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. ---> + ~ 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. + --> <assembly> <!-- id typically identifies the "type" (src vs bin etc) of the assembly --> <id>src</id> Modified: incubator/synapse/trunk/java/src/site/resources/Synapse_Configuration_Language.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/Synapse_Configuration_Language.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/Synapse_Configuration_Language.html (original) +++ incubator/synapse/trunk/java/src/site/resources/Synapse_Configuration_Language.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> Modified: incubator/synapse/trunk/java/src/site/resources/download.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/download.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/download.html (original) +++ incubator/synapse/trunk/java/src/site/resources/download.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <html> <title>Synapse Downloads</title> Modified: incubator/synapse/trunk/java/src/site/resources/download/M1/download.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/download/M1/download.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/download/M1/download.html (original) +++ incubator/synapse/trunk/java/src/site/resources/download/M1/download.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <html> <head> <meta http-equiv="content-type" content=""> Modified: incubator/synapse/trunk/java/src/site/resources/download/M2/download.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/download/M2/download.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/download/M2/download.html (original) +++ incubator/synapse/trunk/java/src/site/resources/download/M2/download.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <html> <head> <meta http-equiv="content-type" content=""> Modified: incubator/synapse/trunk/java/src/site/resources/extending_synapse.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/extending_synapse.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/extending_synapse.html (original) +++ incubator/synapse/trunk/java/src/site/resources/extending_synapse.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <html> <head> <meta content="text/html; charset=ISO-8859-1" @@ -119,34 +138,34 @@ <h4>Mediator interface</h4> <p>The second key interface for mediator writers is the Mediator interface:</p> -<pre>package org.apache.synapse.api; - -import org.apache.synapse.MessageContext; - -/** - * All Synapse mediators must implement this Mediator interface. As a message passes - * through the synapse system, each mediator's mediate() method is invoked in the - * sequence/order defined in the SynapseConfiguration. - */ +<pre>package org.apache.synapse.api; + +import org.apache.synapse.MessageContext; + +/** + * All Synapse mediators must implement this Mediator interface. As a message passes + * through the synapse system, each mediator's mediate() method is invoked in the + * sequence/order defined in the SynapseConfiguration. + */ public interface <span - style="font-weight: bold;">Mediator </span>{ - - /** - * Invokes the mediator passing the current message for mediation. Each - * mediator performs its mediation action, and returns true if mediation - * should continue, or false if further mediation should be aborted. - * - * @param synCtx the current message for mediation - * @return true if further mediation should continue - */ - public boolean mediate(MessageContext synCtx); - - /** - * This is used for debugging purposes and exposes the type of the current - * mediator for logging and debugging purposes - * @return a String representation of the mediator type - */ - public String getType(); + style="font-weight: bold;">Mediator </span>{ + + /** + * Invokes the mediator passing the current message for mediation. Each + * mediator performs its mediation action, and returns true if mediation + * should continue, or false if further mediation should be aborted. + * + * @param synCtx the current message for mediation + * @return true if further mediation should continue + */ + public boolean mediate(MessageContext synCtx); + + /** + * This is used for debugging purposes and exposes the type of the current + * mediator for logging and debugging purposes + * @return a String representation of the mediator type + */ + public String getType(); }</pre> <p>A mediator can read and/or modify the <a>SynapseMessage</a> in any suitable @@ -157,21 +176,21 @@ security agent it may decide that this message is dangerous and should not be processed further. This is generally the exception as mediators are usually -designed to co-operate to process the message onwards. +designed to co-operate to process the message onwards. + - </p> -<h3>Leaf and Node Mediators, List mediators and Filter mediators +<h3>Leaf and Node Mediators, List mediators and Filter mediators </h3> Mediators may be Node mediators (i.e. these contain sub mediators) or Leaf mediators (mediators that does not hold any sub mediators). A Node mediator must implement the org.apache.synapse.api.ListMediator interface listed below, or extend from the -org.apache.synapse.mediators.AbstractListMediator. +org.apache.synapse.mediators.AbstractListMediator. -<h4>The ListMediator interface +<h4>The ListMediator interface </h4> <pre> @@ -226,40 +245,40 @@ public List getList(); } -</pre> +</pre> A ListMediator implementation should call super.mediate(synCtx) to process its sub mediator sequence. A FilterMediator is a ListMediator which executes its sequence of sub mediators on successful outcome of a test condition. Mediator instance which performs filtering should -implement the FilterMediator interface. +implement the FilterMediator interface. + - <h4>FilterMediator interface</h4> -<pre>package org.apache.synapse.api; - -import org.apache.synapse.MessageContext; - -/** - * The filter mediator is a list mediator, which executes the given (sub) list of mediators - * if the specified condition is satisfied - * - * @see FilterMediator#test(org.apache.synapse.MessageContext) - */ +<pre>package org.apache.synapse.api; + +import org.apache.synapse.MessageContext; + +/** + * The filter mediator is a list mediator, which executes the given (sub) list of mediators + * if the specified condition is satisfied + * + * @see FilterMediator#test(org.apache.synapse.MessageContext) + */ public interface <span - style="font-weight: bold;">FilterMediator </span>extends ListMediator { - - /** - * Should return true if the sub/child mediators should execute. i.e. if the filter - * condition is satisfied - * @param synCtx - * @return true if the configured filter condition evaluates to true - */ - public boolean test(MessageContext synCtx); -} + style="font-weight: bold;">FilterMediator </span>extends ListMediator { + + /** + * Should return true if the sub/child mediators should execute. i.e. if the filter + * condition is satisfied + * @param synCtx + * @return true if the configured filter condition evaluates to true + */ + public boolean test(MessageContext synCtx); +} </pre> -<h2>Writing custom Configuration implementations for mediators +<h2>Writing custom Configuration implementations for mediators </h2> You may write your own custom configurator for the Mediator @@ -280,9 +299,9 @@ "org.apache.synapse.config.xml.MediatorFactory" which will contain the fully qualified name(s) of your MediatorFactory implementation class(es). You should also place any dependency JARs into the same lib -folder so that the correct classpath references could be made. +folder so that the correct classpath references could be made. + - The MediatorFactory interface listing is given below, which you should @@ -295,33 +314,33 @@ that an instance of the mediator could be created utilizing the custom XML specification and returned. See the ValidateMediator and the ValidateMediatorFactory classes under -modules/extensions in the Synapse source distribution for examples. +modules/extensions in the Synapse source distribution for examples. + - <h4>The MediatorFactory interface</h4> -<pre>package org.apache.synapse.config.xml; - -import ... - -/** - * A mediator factory capable of creating an instance of a mediator through a given - * XML should implement this interface - */ -public interface MediatorFactory { - /** - * Creates an instance of the mediator using the OMElement - * @param elem - * @return the created mediator - */ - public Mediator createMediator(OMElement elem); - - /** - * The QName of this mediator element in the XML config - * @return QName of the mediator element - */ - public QName getTagQName(); -} +<pre>package org.apache.synapse.config.xml; + +import ... + +/** + * A mediator factory capable of creating an instance of a mediator through a given + * XML should implement this interface + */ +public interface MediatorFactory { + /** + * Creates an instance of the mediator using the OMElement + * @param elem + * @return the created mediator + */ + public Mediator createMediator(OMElement elem); + + /** + * The QName of this mediator element in the XML config + * @return QName of the mediator element + */ + public QName getTagQName(); +} </pre> <h2>Writing custom Configuration implementations for Configuration extensions</h2> @@ -337,55 +356,55 @@ that it could be set into the SynapseConfiguration as a named global 'property'. -The interfaces referenced are listed below. +The interfaces referenced are listed below. + - <h4>The Extension interface</h4> -<pre>package org.apache.synapse.config; - -import ... - -/** - * An Extension allows the Synapse configuration to be extended. The Spring - * configuration support is implemented as such an extension, so that the - * Synapse core will not be dependent on Spring classes. An extension - * <b>must</b> specify the following methods to set and get its name. - */ -public interface Extension { - - public String getName(); - - public void setName(String name); - -} +<pre>package org.apache.synapse.config; + +import ... + +/** + * An Extension allows the Synapse configuration to be extended. The Spring + * configuration support is implemented as such an extension, so that the + * Synapse core will not be dependent on Spring classes. An extension + * <b>must</b> specify the following methods to set and get its name. + */ +public interface Extension { + + public String getName(); + + public void setName(String name); + +} </pre> -<h4>The ExtensionFactory interface +<h4>The ExtensionFactory interface </h4> -<pre>package org.apache.synapse.config.xml; - -import .... - -/** - * A extension factory that is capable of creating an instance of a - * named extension, through a given XML, should implement this interface - */ -public interface ExtensionFactory { - /** - * Creates an instance of a named extension using the OMElement - * @param elem - * @return the created named extension - */ - public Extension createExtension(OMElement elem); - - /** - * The QName of the extension element in the XML config - * @return QName of the extension element - */ - public QName getTagQName(); - -} +<pre>package org.apache.synapse.config.xml; + +import .... + +/** + * A extension factory that is capable of creating an instance of a + * named extension, through a given XML, should implement this interface + */ +public interface ExtensionFactory { + /** + * Creates an instance of a named extension using the OMElement + * @param elem + * @return the created named extension + */ + public Extension createExtension(OMElement elem); + + /** + * The QName of the extension element in the XML config + * @return QName of the extension element + */ + public QName getTagQName(); + +} </pre> <h4>Loading of Extensions by the Synapse runtime</h4> Synapse loads available extensions from the runtime classpath using the @@ -397,81 +416,81 @@ text file with the name org.apache.synapse.config.xml.ExtensionFactory which contains a list of fully qualified classname that implement the above -interface, listing each class in a separate line. +interface, listing each class in a separate line. + - e.g. The built-in extension_mediators.jar contains the following -structure +structure + - -<pre>extension_mediators.jar - /META-INF/services - org.apache.synapse.config.xml.ExtensionFactory - org.apache.synapse.config.xml.MediatorFactory - /... the implementation classes as usual... - +<pre>extension_mediators.jar + /META-INF/services + org.apache.synapse.config.xml.ExtensionFactory + org.apache.synapse.config.xml.MediatorFactory + /... the implementation classes as usual... + </pre> The org.apache.synapse.config.xml.ExtensionFactory text file discussed above contains the line "org.apache.synapse.config.xml.SpringConfigExtensionFactory" but may contain multiple lines specifying a list of extensions contained within -the specific JAR file. +the specific JAR file. + - Once the available ExtensionFactory implementations are loaded by the Synapse initializer, it accumulates the list of defined XML configuration elements by calling to the getTagQName() method of the ExtensionFactory implementation. Lets consider the Spring extension as -an example. +an example. - -<pre>package org.apache.synapse.config.xml; - -import ... - -/** - * Creates a Spring configuration extension from XML configuration. A Spring - * configuration extension keeps Spring away from the core of synapse - * - * <spring:config name="string" src="file"/> - */ -public class SpringConfigExtensionFactory implements ExtensionFactory { - - private static final Log log = LogFactory.getLog(SpringConfigExtensionFactory.class); - - private static final QName SPRING_CFG_Q = new QName(Constants.SYNAPSE_NAMESPACE + "/spring", "config"); - - /** - * <spring:config name="string" src="file"/> - * - * @param elem the XML configuration element - * @return A named Spring Configuration - */ - public Extension createExtension(OMElement elem) { - - SpringConfigExtension springCfgExt = null; - OMAttribute name = elem.getAttribute(new QName(Constants.NULL_NAMESPACE, "name")); - OMAttribute src = elem.getAttribute(new QName(Constants.NULL_NAMESPACE, "src")); - - if (name == null) { - handleException("The 'name' attribute is required for a Spring configuration definition"); - } else if (src == null) { - handleException("The 'src' attribute is required for a Spring configuration definition"); - } else { - springCfgExt = new SpringConfigExtension(name.getAttributeValue(), src.getAttributeValue()); - } - return springCfgExt; - } - - private void handleException(String msg) { - log.error(msg); - throw new SynapseException(msg); - } -} + +<pre>package org.apache.synapse.config.xml; + +import ... + +/** + * Creates a Spring configuration extension from XML configuration. A Spring + * configuration extension keeps Spring away from the core of synapse + * + * <spring:config name="string" src="file"/> + */ +public class SpringConfigExtensionFactory implements ExtensionFactory { + + private static final Log log = LogFactory.getLog(SpringConfigExtensionFactory.class); + + private static final QName SPRING_CFG_Q = new QName(Constants.SYNAPSE_NAMESPACE + "/spring", "config"); + + /** + * <spring:config name="string" src="file"/> + * + * @param elem the XML configuration element + * @return A named Spring Configuration + */ + public Extension createExtension(OMElement elem) { + + SpringConfigExtension springCfgExt = null; + OMAttribute name = elem.getAttribute(new QName(Constants.NULL_NAMESPACE, "name")); + OMAttribute src = elem.getAttribute(new QName(Constants.NULL_NAMESPACE, "src")); + + if (name == null) { + handleException("The 'name' attribute is required for a Spring configuration definition"); + } else if (src == null) { + handleException("The 'src' attribute is required for a Spring configuration definition"); + } else { + springCfgExt = new SpringConfigExtension(name.getAttributeValue(), src.getAttributeValue()); + } + return springCfgExt; + } + + private void handleException(String msg) { + log.error(msg); + throw new SynapseException(msg); + } +} </pre> The getTagQName() returns the name space "http://ws.apache.org/ns/synapse/spring"; and the element name as @@ -490,71 +509,71 @@ store it into the SynapseConfiguration, as a "property", and thus could be retrieved later via this same "name". Hence the implementations should be careful to use unique meaningful names for their -implementations. +implementations. + - For completeness, the implementation of the Spring extension is -given in the following listing. +given in the following listing. + + + +<pre>package org.apache.synapse.config; + +import ... + +/** + * This defines an extension to Synapse to process a Spring Configuration. + * This keeps the Spring dependency out from the Synapse core, and the + * dependent Jars from the core distribution. + * + * A Spring configuration is usually named, but this class allows an + * inlined configuration to be built up as well, where the Spring mediator + * defines an inline Spring configuration + */ +public class SpringConfigExtension implements Extension { - + /** + * The name of this Spring configuration + */ + private String name = null; + + /** + * This is the Spring ApplicationContext/BeanFactory + */ + private GenericApplicationContext appContext = null; + + /** + * Create a Spring configuration from the given configuration + * + * @param configFile the configuration file to be used + */ + public SpringConfigExtension(String name, String configFile) { + setName(name); + appContext = new GenericApplicationContext(); + XmlBeanDefinitionReader xbdr = new XmlBeanDefinitionReader(appContext); + xbdr.setValidating(false); + xbdr.loadBeanDefinitions(new FileSystemResource(configFile)); + appContext.refresh(); + } + + public GenericApplicationContext getAppContext() { + return appContext; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public QName getTagQName() { + return SPRING_CFG_Q; + } +} -<pre>package org.apache.synapse.config; - -import ... - -/** - * This defines an extension to Synapse to process a Spring Configuration. - * This keeps the Spring dependency out from the Synapse core, and the - * dependent Jars from the core distribution. - * - * A Spring configuration is usually named, but this class allows an - * inlined configuration to be built up as well, where the Spring mediator - * defines an inline Spring configuration - */ -public class SpringConfigExtension implements Extension { - - /** - * The name of this Spring configuration - */ - private String name = null; - - /** - * This is the Spring ApplicationContext/BeanFactory - */ - private GenericApplicationContext appContext = null; - - /** - * Create a Spring configuration from the given configuration - * - * @param configFile the configuration file to be used - */ - public SpringConfigExtension(String name, String configFile) { - setName(name); - appContext = new GenericApplicationContext(); - XmlBeanDefinitionReader xbdr = new XmlBeanDefinitionReader(appContext); - xbdr.setValidating(false); - xbdr.loadBeanDefinitions(new FileSystemResource(configFile)); - appContext.refresh(); - } - - public GenericApplicationContext getAppContext() { - return appContext; - } - - public String getName() { - return name; - } - - public void setName(String name) { - this.name = name; - } - - public QName getTagQName() { - return SPRING_CFG_Q; - } -} - </pre> </body> </html> Modified: incubator/synapse/trunk/java/src/site/resources/userguide.html URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/resources/userguide.html?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/resources/userguide.html (original) +++ incubator/synapse/trunk/java/src/site/resources/userguide.html Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> Modified: incubator/synapse/trunk/java/src/site/site.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/site.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/site.xml (original) +++ incubator/synapse/trunk/java/src/site/site.xml Fri Nov 17 04:41:15 2006 @@ -1,4 +1,23 @@ <?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + ~ 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. + --> + <project name="Apache Synapse"> <bannerLeft> Modified: incubator/synapse/trunk/java/src/site/xdoc/index.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/xdoc/index.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/xdoc/index.xml (original) +++ incubator/synapse/trunk/java/src/site/xdoc/index.xml Fri Nov 17 04:41:15 2006 @@ -1,21 +1,22 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> -<!-- -/* - * Copyright 2001-2004 The Apache Software Foundation. - * - * 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. - */ - --> +<!-- + ~ 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. + --> <document> Modified: incubator/synapse/trunk/java/src/site/xdoc/navigation.xml URL: http://svn.apache.org/viewvc/incubator/synapse/trunk/java/src/site/xdoc/navigation.xml?view=diff&rev=476123&r1=476122&r2=476123 ============================================================================== --- incubator/synapse/trunk/java/src/site/xdoc/navigation.xml (original) +++ incubator/synapse/trunk/java/src/site/xdoc/navigation.xml Fri Nov 17 04:41:15 2006 @@ -1,3 +1,22 @@ +<!-- + ~ 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. + --> + <project name="Synapse"> <title>Synapse</title> <body> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
