Author: hiranya
Date: Tue Dec 14 03:13:27 2010
New Revision: 1048918
URL: http://svn.apache.org/viewvc?rev=1048918&view=rev
Log:
samples 254, 255
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample254.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample255.xml
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml?rev=1048918&r1=1048917&r2=1048918&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml
(original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml
Tue Dec 14 03:13:27 2010
@@ -104,8 +104,8 @@
<li><a href="samples/sample251.html">Sample 251:
Switching from http/s to JMS</a></li>
<li><a href="samples/sample252.html">Sample 252: Pure
text, binary and POX message support with JMS</a></li>
<li><a href="samples/sample253.html">Sample 253: One
way bridging from JMS to http and replying with a 202 Accepted response</a></li>
- <li><a href="">Sample 254: Using the file system as
transport medium using VFS transport listener and sender</a></li>
- <li><a href="">Sample 255: Switching from ftp
transport listener to mail transport sender</a></li>
+ <li><a href="samples/sample254.html">Sample 254: Using
file system as the transport medium (reading/writing files)</a></li>
+ <li><a href="samples/sample255.html">Sample 255:
Switching from file transport (ftp) to the mail transport</a></li>
<li><a href="">Sample 256: Proxy services with the
mail transport</a></li>
<li><a href="">Sample 257: Proxy services with the FIX
transport</a></li>
<li><a href="">Sample 258: Switching from HTTP to FIX
</a></li>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample254.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample254.xml?rev=1048918&r1=1048917&r2=1048918&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample254.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample254.xml
Tue Dec 14 03:13:27 2010
@@ -23,7 +23,7 @@
<title>Apache Synapse - Sample 254</title>
</properties>
<body>
- <section name="Sample 254: ">
+ <section name="Sample 254: Using File System as the Transport Medium
(Reading/Writing Files)">
<div class="xmlConf"><definitions
xmlns="http://ws.apache.org/ns/synapse">
<proxy name="StockQuoteProxy" transports="vfs">
@@ -59,7 +59,10 @@
</definitions></div>
<subsection name="Objective">
<p>
-
+ Synapse can access the local file system using its VFS
(Virtual File System)
+ transport receiver and sender. This way Synapse can read
files in the local file
+ system as well as write to the local file system. This
sample show cases the
+ Synapse VFS transport in action.
</p>
</subsection>
<subsection name="Pre-requisites">
@@ -69,6 +72,25 @@
Deploy the SimpleStockQuoteService in the sample
Axis2 server and start Axis2
</li>
<li>
+ Create 3 new directories (folders) named 'in',
'out' and 'original' in a
+ suitable location in the local file system (eg:
/home/user/test).
+ </li>
+ <li>
+ Open the
repository/conf/sample/synapse_sample_254.xml file in a text
+ editor and. Then change the transport.vfs.FileURI,
transport.vfs.MoveAfterProcess,
+ transport.vfs.MoveAfterFailure parameter values to
the above in, original
+ and original directories respectively. Note that
both 2nd and 3rd parameters
+ are pointed to the 'original' directory.
+ </li>
+ <li>
+ Change the endpoint in the out-sequence to point
to the 'out' directory.
+ The prefix 'vfs' in the endpoint URL must not be
removed or changed.
+ </li>
+ <li>
+ Enable the VFS transport receiver and sender for
Synapse (refer VFS
+ setup guide for more information)
+ </li>
+ <li>
Start Synapse using the configuration numbered 254
(repository/conf/sample/synapse_sample_254.xml)
<div class="command">
Unix/Linux: sh synapse.sh -sample 254<br/>
@@ -79,11 +101,26 @@
</p>
</subsection>
<subsection name="Executing the Client">
- <div class="command">ant stockquote
-Daddurl=http://localhost:9000/services/SimpleStockQuoteService
-Dtrpurl=http://localhost:8280/</div>
-
- <div class="consoleOutput">Sat Nov 18 21:01:23 IST 2006
SimpleStockQuoteService :: Generating quote for : IBM</div>
-
- <div class="consoleOutput">Standard :: Stock price =
$95.26454380258552</div>
+ <p>
+ Copy the test.xml file in the
repository/conf/sample/resources/vfs directory to
+ the directory given in transport.vfs.FileURI above (i.e
the 'in' directory). This
+ file contains a simple stock quote request in XML/SOAP
format.
+ </p>
+ <div class="consoleOutput"><?xml version='1.0'
encoding='UTF-8'?>
+ <soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
+ <soapenv:Body>
+ <m0:getQuote xmlns:m0="http://services.samples">
+ <m0:request>
+ <m0:symbol>IBM</m0:symbol>
+ </m0:request>
+ </m0:getQuote>
+ </soapenv:Body>
+</soapenv:Envelope></div>
+ <p>
+ VFS transport listener will pick the file from 'in'
directory and send it to the
+ Axis2 service over HTTP. The request XML file will be
backed up in the 'original'
+ directory. The response from the Axis2 server will be
saved to the 'out' directory.
+ </p>
</subsection>
</section>
<p><a href="../samples.html">Back to Catalog</a></p>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample255.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample255.xml?rev=1048918&r1=1048917&r2=1048918&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample255.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample255.xml
Tue Dec 14 03:13:27 2010
@@ -23,7 +23,7 @@
<title>Apache Synapse - Sample 255</title>
</properties>
<body>
- <section name="Sample 255: ">
+ <section name="Sample 255: Switching from File Transport (FTP) to the
Mail Transport">
<div class="xmlConf"><definitions
xmlns="http://ws.apache.org/ns/synapse">
<proxy name="StockQuoteProxy" transports="vfs">
@@ -55,16 +55,43 @@
</definitions></div>
<subsection name="Objective">
<p>
-
+ In <a href="sample254.html">sample 254</a> we looked at
how the VFS transport
+ can be used to read files from the local file system. VFS
transport can also be
+ used to read files from FTP, SFTP and CIFS sites. This
sample illustrates how to
+ read from a remote FTP site and send the content to a
remote client as an e-mail.
</p>
</subsection>
<subsection name="Pre-requisites">
<p>
<ul>
+ <div class="command">ant stockquote
-Daddurl=http://localhost:9000/services/SimpleStockQuoteService
-Dtrpurl=http://localhost:8280/</div>
+
+ <div class="consoleOutput">Sat Nov 18 21:01:23 IST 2006
SimpleStockQuoteService :: Generating quote for : IBM</div>
+
+ <div class="consoleOutput">Standard :: Stock price =
$95.26454380258552</div> <li>
+ This sample requires access to a FTP site and an
e-mail account.
+ </li>
<li>
Deploy the SimpleStockQuoteService in the sample
Axis2 server and start Axis2
</li>
<li>
+ Enable the VFS transport listener for Synapse
(refer VFS setup guide for
+ more details).
+ </li>
+ <li>
+ Enable the mail transport sender for Synapse
(refer Mail transport setup
+ guide for more details).
+ </li>
+ <li>
+ Create a new test directory in the FTP site.
+ </li>
+ <li>
+ Open the
repository/conf/sample/synapse_sample_255.xml and edit the
+ transport.vfs.FileURI parameter to point to the
test directory in the FTP
+ server. Also change the endpoint in the out
sequence to point to your
+ e-mail account.
+ </li>
+ <li>
Start Synapse using the configuration numbered 255
(repository/conf/sample/synapse_sample_255.xml)
<div class="command">
Unix/Linux: sh synapse.sh -sample 255<br/>
@@ -75,11 +102,27 @@
</p>
</subsection>
<subsection name="Executing the Client">
- <div class="command">ant stockquote
-Daddurl=http://localhost:9000/services/SimpleStockQuoteService
-Dtrpurl=http://localhost:8280/</div>
-
- <div class="consoleOutput">Sat Nov 18 21:01:23 IST 2006
SimpleStockQuoteService :: Generating quote for : IBM</div>
-
- <div class="consoleOutput">Standard :: Stock price =
$95.26454380258552</div>
+ <p>
+ Copy the test.xml file in the
repository/conf/sample/resources/vfs directory to
+ the directory given in transport.vfs.FileURI above (i.e
the test directory in
+ FTP server). This file contains a simple stock quote
request in XML/SOAP format.
+ </p>
+ <div class="consoleOutput"><?xml version='1.0'
encoding='UTF-8'?>
+<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
+ <soapenv:Body>
+ <m0:getQuote xmlns:m0="http://services.samples">
+ <m0:request>
+ <m0:symbol>IBM</m0:symbol>
+ </m0:request>
+ </m0:getQuote>
+ </soapenv:Body>
+</soapenv:Envelope></div>
+ <p>
+ VFS transport will pick up the file from the FTP site and
send the content to
+ the stock quote service in Axis2 over HTTP. Response from
Axis2 will be sent to
+ the mail endpoint as an e-mail. It should show up in the
configured e-mail account
+ after a few seconds.
+ </p>
</subsection>
</section>
<p><a href="../samples.html">Back to Catalog</a></p>
