[maven-release-plugin] copy for tag 2.1.0
git-svn-id: https://svn.apache.org/repos/asf/synapse/tags/2.1.0@1228129 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/pom.xml b/pom.xml
index bab3111..e94c9a9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -203,15 +203,15 @@
<plugins>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
- <version>2.2</version>
+ <version>2.4.1</version>
</plugin>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
- <version>2.2</version>
+ <version>2.5</version>
</plugin>
<plugin>
<artifactId>maven-site-plugin</artifactId>
- <version>2.1</version>
+ <version>3.0</version>
</plugin>
</plugins>
</pluginManagement>
@@ -257,7 +257,7 @@
</plugin>
<plugin>
<artifactId>maven-site-plugin</artifactId>
- <version>2.1</version>
+ <version>3.0</version>
<inherited>false</inherited>
<executions>
<execution>
@@ -751,12 +751,12 @@
<plugins>
<plugin>
<artifactId>maven-site-plugin</artifactId>
- <version>2.1</version>
+ <version>3.0</version>
<inherited>false</inherited>
</plugin>
<plugin>
<artifactId>maven-project-info-reports-plugin</artifactId>
- <version>2.1.1</version>
+ <version>2.2</version>
<configuration>
<!-- These features are disabled since they cause "mvn site" to hang -->
<dependencyLocationsEnabled>false</dependencyLocationsEnabled>
diff --git a/src/site/xdoc/userguide/samples.xml b/src/site/xdoc/userguide/samples.xml
index f43232e..59d5000 100644
--- a/src/site/xdoc/userguide/samples.xml
+++ b/src/site/xdoc/userguide/samples.xml
@@ -126,7 +126,7 @@
<subsection name="Scheduled Tasks">
<p>
<ul>
- <li><a href="#Sample300">Sample 300: Introduction to tasks with simple trigger</a></li>
+ <li><a href="samples/sample300.html">Sample 300: Introduction to tasks with simple trigger</a></li>
</ul>
</p>
</subsection>
@@ -237,10 +237,12 @@
</ul>
</p>
</subsection>
- <subsection name="Message Store and Dead Letter Channel">
+ <subsection name="Message Stores and Message Processors">
<p>
<ul>
- <li><a href="samples/sample700.html">Sample 700: Introduction to Synapse message stores</a></li>
+ <li><a href="samples/sample700.html">Sample 700: Introduction to Synapse Message Stores</a></li>
+ <li><a href="samples/sample701.html">Sample 701: Introduction to Message Sampling Processor</a></li>
+ <li><a href="samples/sample702.html">Sample 702: Introduction to Message Forwarding Processor</a></li>
</ul>
</p>
</subsection>
@@ -260,4 +262,4 @@
</subsection>
</section>
</body>
-</document>
\ No newline at end of file
+</document>
diff --git a/src/site/xdoc/userguide/samples/sample700.xml b/src/site/xdoc/userguide/samples/sample700.xml
index 423ecbe..de212dc 100644
--- a/src/site/xdoc/userguide/samples/sample700.xml
+++ b/src/site/xdoc/userguide/samples/sample700.xml
@@ -24,51 +24,41 @@
</properties>
<body>
<section name="Sample 700: Introduction to Synapse Message Stores">
- <div class="xmlConf"><definitions xmlns="http://ws.apache.org/ns/synapse">
- <!--Simple in Memory Message Store with name foo -->
- <messageStore name="foo" sequence="bar">
- <redelivery>
- <!--retry interval 1 sec -->
- <interval>1</interval>
- <!--Message will be stored after 2 redeliveries -->
- <maximumRedeliveries>2</maximumRedeliveries>
- <exponentialBackoff>true</exponentialBackoff>
- <backoffMutiplier>2</backoffMutiplier>
- </redelivery>
- </messageStore>
-
- <!-- filtering of messages with XPath and regex matches -->
- <filter source="get-property('To')" regex=".*/StockQuote.*">
- <send>
- <endpoint key="SampleEndpoint"/>
- </send>
+ <div class="xmlConf"><!-- Introduction to the Message Store -->
+<definitions xmlns="http://ws.apache.org/ns/synapse">
+ <sequence name="fault">
+ <log level="full">
+ <property name="MESSAGE" value="Executing default 'fault' sequence"/>
+ <property name="ERROR_CODE" expression="get-property('ERROR_CODE')"/>
+ <property name="ERROR_MESSAGE"
+ expression="get-property('ERROR_MESSAGE')"/>
+ </log>
<drop/>
- </filter>
- <send/>
- <!-- Endpoint named SampleEndpoint-->
- <endpoint name="SampleEndpoint" onFault="foo">
- <address uri="http://localhost:9000/services/SimpleStockQuoteService">
- <suspendDurationOnFailure>2</suspendDurationOnFailure>
- </address>
- </endpoint>
-
- <sequence name="bar">
- <log level="full"/>
</sequence>
+ <sequence name="onStoreSequence">
+ <log>
+ <property name="On-Store" value="Storing message"/>
+ </log>
+ </sequence>
+ <sequence name="main">
+ <in>
+ <log level="full"/>
+ <property name="FORCE_SC_ACCEPTED" value="true" scope="axis2"/>
+ <store messageStore="MyStore" sequence="onStoreSequence"/>
+ </in>
+ <description>The main sequence for the message mediation</description>
+ </sequence>
+ <messageStore name="MyStore"/>
</definitions></div>
<subsection name="Objective">
<p>
- Demonstrate the usage of Synapse message stores and how to use a message store
- to implement the popular 'Dead Letter Channel' integration pattern
+ Introduction to Message Stores
</p>
</subsection>
<subsection name="Pre-requisites">
<p>
<ul>
<li>
- Deploy the SimpleStockQuoteService in the sample Axis2 server and start Axis2
- </li>
- <li>
Start Synapse using the configuration numbered 700 (repository/conf/sample/synapse_sample_700.xml)
<div class="command">
Unix/Linux: sh synapse.sh -sample 700<br/>
@@ -82,21 +72,33 @@
<p>
First execute the sample client as follows.
</p>
- <div class="command">ant stockquote -Dtrpurl=http://localhost:8280/soap/StockQuote</div>
+ <div class="command">ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dmode=placeorder
+ </div>
<p>
- Since you have the sample Axis2 server running, you will get a stock quote response
- at the client side. Axis2 server will also print a log confirming the generation
- of a new quote value. Now shut the Axis2 server down and invoke the sample client
- again. Now Synapse will attempt twice to deliever the message and faling that, the
- message will be stored in the specified in-memory message store (dead letter channel)
- for later delivery.
+ When you execute the client the message will be dispatched to the main sequence.
+ In the Main sequence store mediator will store the placeOrder request message in
+ the 'MyStore' Message Store.
</p>
<p>
- Now you can use the JMX view of the Synapse message store to see the message
- stored in the dead letter channel and manually retry on them.
- </p>
+ Now you can use the JMX view of the Synapse message store to see the messages
+ stored in the dead letter channel and manually perform retries on them.
+ </p>
+ <p>
+ Before storing the message, store mediator will invoke the sequence named
+ 'onStoreSequence'. You should see something similar to the following in the
+ log.
+ </p>
+ <div class="command">
+ INFO - LogMediator To: http://localhost:9000/services/SimpleStockQuoteService,
+ WSAction: urn:placeOrder, SOAPAction: urn:placeOrder, ReplyTo:
+ http://www.w3.org/2005/08/addressing/none, MessageID:
+ urn:uuid:54f0e7c6-7b43-437c-837e-a825d819688c, Direction: request, On-Store =
+ Storing message
+ </div>
</subsection>
</section>
- <p><a href="../samples.html">Back to Catalog</a></p>
+ <p>
+ <a href="../samples.html">Back to Catalog</a>
+ </p>
</body>
-</document>
\ No newline at end of file
+</document>
diff --git a/src/site/xdoc/userguide/samples/sample701.xml b/src/site/xdoc/userguide/samples/sample701.xml
new file mode 100644
index 0000000..3c1401a
--- /dev/null
+++ b/src/site/xdoc/userguide/samples/sample701.xml
@@ -0,0 +1,105 @@
+<?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.
+ -->
+
+<document>
+ <properties>
+ <title>Apache Synapse - Sample 701</title>
+ </properties>
+ <body>
+ <section name="Sample 701: Introduction to Message Sampling Processor">
+ <div class="xmlConf"><!-- Introduction to Message Sampling Processor -->
+<definitions xmlns="http://ws.apache.org/ns/synapse">
+ <sequence name="send_seq">
+ <send>
+ <endpoint>
+ <address uri="http://localhost:9000/services/SimpleStockQuoteService">
+ <suspendOnFailure>
+ <errorCodes>-1</errorCodes>
+ <progressionFactor>1.0</progressionFactor>
+ </suspendOnFailure>
+ </address>
+ </endpoint>
+ </send>
+ </sequence>
+ <sequence name="main">
+ <in>
+ <log level="full"/>
+ <property name="FORCE_SC_ACCEPTED" value="true" scope="axis2"/>
+ <property name="OUT_ONLY" value="true"/>
+ <store messageStore="MyStore"/>
+ </in>
+ <description>The main sequence for the message mediation</description>
+ </sequence>
+ <messageStore name="MyStore"/>
+ <messageProcessor
+ class="org.apache.synapse.message.processors.sampler.SamplingProcessor"
+ name="SamplingProcessor" messageStore="MyStore">
+ <parameter name="interval">20000</parameter>
+ <parameter name="sequence">send_seq</parameter>
+ </messageProcessor>
+</definitions></div>
+ <subsection name="Objective">
+ <p>
+ Introduction to Message Sampling Processor
+ </p>
+ </subsection>
+ <subsection name="Pre-requisites">
+ <p>
+ <ul>
+ <li>
+ Deploy the SimpleStockQuoteService in the sample Axis2 server and start Axis2
+ </li>
+ <li>
+ Start Synapse using the configuration numbered 701 (repository/conf/sample/synapse_sample_701.xml)
+ <div class="command">
+ Unix/Linux: sh synapse.sh -sample 701<br/>
+ Windows: synapse.bat -sample 701
+ </div>
+ </li>
+ </ul>
+ </p>
+ </subsection>
+ <subsection name="Executing the Client">
+ <p>
+ Execute the Client few times with command :
+ </p>
+ <div class="command">ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dmode=placeorder
+ </div>
+
+ <p>
+ When you execute the client the message will be dispatched to the main sequence.
+ In the Main sequence store mediator will store the placeOrder request message in
+ the 'MyStore' message store.
+ </p>
+ <p>
+ Message Processor will consume the messages and forward to the 'send_seq' sequence
+ in the configured rate.
+ </p>
+ <p>
+ You will observe that service invocation rate is not changing when increasing the
+ rate at which we execute the client.
+ </p>
+ </subsection>
+ </section>
+ <p>
+ <a href="../samples.html">Back to Catalog</a>
+ </p>
+ </body>
+</document>
diff --git a/src/site/xdoc/userguide/samples/sample702.xml b/src/site/xdoc/userguide/samples/sample702.xml
new file mode 100644
index 0000000..c37c408
--- /dev/null
+++ b/src/site/xdoc/userguide/samples/sample702.xml
@@ -0,0 +1,111 @@
+<?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.
+ -->
+
+<document>
+ <properties>
+ <title>Apache Synapse - Sample 702</title>
+ </properties>
+ <body>
+ <section name="Sample 702: Introduction to Message Forwarding Processor">
+ <div class="xmlConf"><!-- Introduction to Scheduled Message Forwarding Processor -->
+<definitions xmlns="http://ws.apache.org/ns/synapse">
+
+ <endpoint name="StockQuoteServiceEp">
+ <address uri="http://localhost:9000/services/SimpleStockQuoteService">
+ <suspendOnFailure>
+ <errorCodes>-1</errorCodes>
+ <progressionFactor>1.0</progressionFactor>
+ </suspendOnFailure>
+ </address>
+ </endpoint>
+ <sequence name="fault">
+ <log level="full">
+ <property name="MESSAGE" value="Executing default 'fault' sequence"/>
+ <property name="ERROR_CODE" expression="get-property('ERROR_CODE')"/>
+ <property name="ERROR_MESSAGE" expression="get-property('ERROR_MESSAGE')"/>
+ </log>
+ <drop/>
+ </sequence>
+ <sequence name="main">
+ <in>
+ <log level="full"/>
+ <property name="FORCE_SC_ACCEPTED" value="true" scope="axis2"/>
+ <property name="OUT_ONLY" value="true"/>
+ <property name="target.endpoint" value="StockQuoteServiceEp"/>
+ <store messageStore="MyStore"/>
+ </in>
+ <description>The main sequence for the message mediation</description>
+ </sequence>
+ <messageStore name="MyStore"/>
+ <messageProcessor
+ class="org.apache.synapse.message.processors.forward.ScheduledMessageForwardingProcessor"
+ name="ScheduledProcessor" messageStore="MyStore">
+ <parameter name="interval">10000</parameter>
+ </messageProcessor>
+</definitions>
+ </div>
+ <subsection name="Objective">
+ <p>
+ Introduction to Message Forwarding Processor
+ </p>
+ </subsection>
+ <subsection name="Pre-requisites">
+ <p>
+ <ul>
+ <li>
+ Start Synapse using the configuration numbered 702 (repository/conf/sample/synapse_sample_702.xml)
+ <div class="command">
+ Unix/Linux: sh synapse.sh -sample 702<br/>
+ Windows: synapse.bat -sample 702
+ </div>
+ </li>
+ </ul>
+ </p>
+ </subsection>
+ <subsection name="Executing the Client">
+ <p>
+ Execute the sample client a few times with the following command. Note that
+ we still haven't started the sample Axis2 server.
+ </p>
+ <div class="command">
+ ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dmode=placeorder
+ </div>
+
+ <p>
+ Deploy the SimpleStockQuoteService in the sample Axis2 server and start Axis2.
+ </p>
+ <p>
+ When you start the service you will see messages getting delivered to the service,
+ even though the service was actually down when we invoked the sample client.
+ </p>
+ <p>
+ Here in the 'main' sequence store mediator will store the placeOrder request
+ message in the 'MyStore' message store. Message processor will send the message
+ to the endpoint which is configured as a message context property. Message
+ processor will remove the message from the store only if the message is delivered
+ successfully.
+ </p>
+ </subsection>
+ </section>
+ <p>
+ <a href="../samples.html">Back to Catalog</a>
+ </p>
+ </body>
+</document>