Author: hiranya
Date: Sun Jan 2 14:24:10 2011
New Revision: 1054413
URL: http://svn.apache.org/viewvc?rev=1054413&view=rev
Log:
TCP/UDP transports
Added:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/tcp_udp.xml
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample265.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample266.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/db.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/index.xml
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample265.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample265.xml?rev=1054413&r1=1054412&r2=1054413&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample265.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample265.xml
Sun Jan 2 14:24:10 2011
@@ -52,8 +52,8 @@
Deploy the SimpleStockQuoteService in the sample
Axis2 server and start Axis2
</li>
<li>
- Enable the TCP transport receiver for Synapse
(refer TCP transport setup
- guide).
+ Enable the TCP transport receiver for Synapse
(refer
+ <a href="setup/tcp_udp.html#tcp">TCP transport
setup guide</a>).
</li>
<li>
Start Synapse using the configuration numbered 265
(repository/conf/sample/synapse_sample_265.xml)
@@ -63,8 +63,9 @@
</div>
</li>
<li>
- Enable the TCP transport sender for the sample
Axis2 client (refer TCP transport
- setup guide for details).
+ Enable the TCP transport sender for the sample
Axis2 client (refer
+ <a href="setup/tcp_udp.html#tcp">TCP transport
setup guide</a> for
+ details).
</li>
</ul>
</p>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample266.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample266.xml?rev=1054413&r1=1054412&r2=1054413&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample266.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample266.xml
Sun Jan 2 14:24:10 2011
@@ -54,8 +54,8 @@
Deploy the SimpleStockQuoteService in the sample
Axis2 server and start Axis2
</li>
<li>
- Enable the UDP transport receiver for Synapse
(refer UDP transport setup
- guide).
+ Enable the UDP transport receiver for Synapse
(refer
+ <a href="setup/tcp_udp.html#udp">UDP transport
setup guide</a>).
</li>
<li>
Start Synapse using the configuration numbered 266
(repository/conf/sample/synapse_sample_266.xml)
@@ -65,8 +65,9 @@
</div>
</li>
<li>
- Enable the UDP transport sender for the sample
Axis2 client (refer UDP transport
- setup guide for details).
+ Enable the UDP transport sender for the sample
Axis2 client (refer
+ <a href="setup/tcp_udp.html#udp">UDP transport
setup guide</a> for
+ details).
</li>
</ul>
</p>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/db.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/db.xml?rev=1054413&r1=1054412&r2=1054413&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/db.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/db.xml
Sun Jan 2 14:24:10 2011
@@ -39,7 +39,7 @@
Synapse using the dblookup and dbreport mediators. Synapse
ships with a collection
of samples which demonstrates various aspects of dblookup,
dbreport mediators and
database integration. This article describes how to setup the
databases, sample
- tables and JNDI data sources required to try these examples
out.
+ tables and reusable data sources required to try these
examples out.
</p>
<p>
Most samples assume Apache Derby is used as the database
engine. And therefore this
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/index.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/index.xml?rev=1054413&r1=1054412&r2=1054413&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/index.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/index.xml
Sun Jan 2 14:24:10 2011
@@ -380,10 +380,8 @@ ant jmsclient -Djms_type=binary -Djms_de
<ul>
<li><a href="jms.html">JMS Setup Guide</a></li>
<li><a href="fix.html">FIX Setup Guide</a></li>
- <li><a href="tcp.html">TCP Setup Guide</a></li>
- <li><a href="udp.html">UDP Setup Guide</a></li>
+ <li><a href="tcp_udp.html">TCP/UDP Setup Guide</a></li>
<li><a href="db.html">Database Setup Guide</a></li>
- <li><a href="ds.html">Datasource Setup Guide</a></li>
</ul>
</section>
</body>
Added:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/tcp_udp.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/tcp_udp.xml?rev=1054413&view=auto
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/tcp_udp.xml
(added)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/setup/tcp_udp.xml
Sun Jan 2 14:24:10 2011
@@ -0,0 +1,85 @@
+<?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 - TCP/UDP Setup Guide</title>
+ </properties>
+ <body>
+ <section name="Contents">
+ <ul>
+ <li><a href="#intro">Introduction</a></li>
+ <li><a href="#tcp">Setting Up the TCP Transport</a></li>
+ <li><a href="#udp">Setting Up the UDP Transport</a></li>
+ </ul>
+ </section>
+ <section name="Introduction" id="intro">
+ <p>
+ Apache Synapse is capable of sending and receiving messages
over raw TCP and UDP.
+ Any messages received over these transports can be mediated
using the usual set of
+ mediators and can be forwarded over different protocols such
as HTTP ans JMS. The
+ transport adapters for TCP and UDP are not available in the
Synapse binary
+ distribution by default. This guide will help you to download
and setup them in
+ Synapse ESB.
+ </p>
+ </section>
+ <section name="Setting Up the TCP Transport" id="tcp">
+ <p>
+ To enable the TCP transport for Synapse, first you need to
download the Axis2 TCP
+ transport jar, and copy it to the 'lib' directory of Synapse.
This library can be
+ downloaded from the <a
href="http://ws.apache.org/commons/transport";>WS-Commons Transports</a>
+ website. Then open up the axis2.xml file and uncomment the TCP
transport receiver
+ and sender configurations.
+ </p>
+ <div class="xmlConf"><transportReceiver name="tcp"
class="org.apache.axis2.transport.tcp.TCPServer">
+ <parameter name="port">6060</parameter>
+</transportReceiver></div>
+ <div class="xmlConf"><transportSender name="tcp"
class="org.apache.axis2.transport.tcp.TCPTransportSender"/></div>
+ <p>
+ The above configuration enables Synapse to receive raw TCP
messages on port 6060.
+ Since no application level headers are available on such
requests, Synapse will be
+ solely depending on the addressing headers or the XML payload
of the messages to
+ find the target service for TCP requests.
+ </p>
+ <p>
+ In some of the samples you will have to send raw TCP messages
using the sample
+ Axis2 client. In that case you should enable the TCP transport
sender for the
+ sample client. This can be done by uncommenting the following
entry in the
+ samples/axis2Client/client_repo/conf/axis2.xml file.
+ </p>
+ <div class="xmlConf"><transportSender name="tcp"
class="org.apache.axis2.transport.tcp.TCPTransportSender"/></div>
+ </section>
+ <section name="Setting Up the UDP Transport" id="udp">
+ <p>
+ Enabling the UDP transport for Synapse is similar to enabling
the TCP transport. You
+ should <a
href="http://ws.apache.org/commons/transport";>download</a> the Axis2 UDP
+ transport jar and copy it into 'lib' directory of Synapse.
Then uncomment the
+ following entries in the repository/conf/axis2.xml file to
enable the UDP listener
+ and sender.
+ </p>
+ <div class="xmlConf"><transportReceiver name="udp"
class="org.apache.axis2.transport.udp.UDPListener"/></div>
+ <div class="xmlConf"><transportSender name="udp"
class="org.apache.axis2.transport.udp.UDPSender"/></div>
+ <p>
+ To send UDP messages from the sample client, enable the UDP
transport sender for the
+ client in samples/axis2Client/client_repo/conf/axis2.xml file.
+ </p>
+ </section>
+ </body>
+</document>
\ No newline at end of file
