You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@synapse.apache.org by hi...@apache.org on 2010/12/14 23:48:01 UTC

svn commit: r1049316 - in /synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide: samples.xml samples/sample257.xml samples/sample258.xml samples/sample259.xml samples/sample261.xml

Author: hiranya
Date: Tue Dec 14 22:48:01 2010
New Revision: 1049316

URL: http://svn.apache.org/viewvc?rev=1049316&view=rev
Log:
Samples 259, 261


Modified:
    synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples.xml
    synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample257.xml
    synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample258.xml
    synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample259.xml
    synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample261.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=1049316&r1=1049315&r2=1049316&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 22:48:01 2010
@@ -109,9 +109,9 @@
                         <li><a href="samples/sample256.html">Sample 256: Proxy services with the mail transport</a></li>
                         <li><a href="samples/sample257.html">Sample 257: Proxy services with the FIX transport</a></li>
                         <li><a href="samples/sample258.html">Sample 258: Switching from HTTP to FIX </a></li>
-                        <li><a href="">Sample 259: Switching from FIX to HTTP </a></li>
+                        <li><a href="samples/sample259.html">Sample 259: Switching from FIX to HTTP </a></li>
                         <li><a href="">Sample 260: Switching from FIX to AMQP </a></li>
-                        <li><a href="">Sample 261: Switch between FIX versions </a></li>
+                        <li><a href="samples/sample261.html">Sample 261: Switch between different FIX versions </a></li>
                         <li><a href="">Sample 262: CBR of FIX messages </a></li>
                         <li><a href="">Sample 263: Transport switching - JMS to http/s using JBoss Messaging (JBM)</a></li>
                         <li><a href="">Sample 264: Transport switching - HTTP/S to JMS two way messages</a></li>

Modified: synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample257.xml
URL: http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample257.xml?rev=1049316&r1=1049315&r2=1049316&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample257.xml (original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample257.xml Tue Dec 14 22:48:01 2010
@@ -64,7 +64,7 @@
                     <ul>
                         <li>
                             You need a <a href="http://www.quickfixj.org">Quickfix/J</a> installation
-                            to try out FIX samples. Pleas download and extract a Quickfix/J distribution
+                            to try out FIX samples. Please download and extract a Quickfix/J distribution
                             into your local machine.
                         </li>
                         <li>

Modified: synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample258.xml
URL: http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample258.xml?rev=1049316&r1=1049315&r2=1049316&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample258.xml (original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample258.xml Tue Dec 14 22:48:01 2010
@@ -64,7 +64,7 @@
                     <ul>
                         <li>
                             You need a <a href="http://www.quickfixj.org">Quickfix/J</a> installation
-                            to try out FIX samples. Pleas download and extract a Quickfix/J distribution
+                            to try out FIX samples. Please download and extract a Quickfix/J distribution
                             into your local machine.
                         </li>
                         <li>

Modified: synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample259.xml
URL: http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample259.xml?rev=1049316&r1=1049315&r2=1049316&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample259.xml (original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample259.xml Tue Dec 14 22:48:01 2010
@@ -23,7 +23,7 @@
         <title>Apache Synapse - Sample 259</title>
     </properties>
     <body>
-        <section name="Sample 259: ">
+        <section name="Sample 259: Switch from FIX to HTTP">
             <div class="xmlConf">&lt;definitions xmlns="http://ws.apache.org/ns/synapse"&gt;
 
     &lt;localEntry key="xslt-key-req"
@@ -52,31 +52,59 @@
 &lt;/definitions&gt;</div>
             <subsection name="Objective">
                 <p>
-
+                    In <a href="sample258.html">sample 258</a> we looked at how to forward HTTP
+                    requests over a FIX session. This sample demonstrates how to send a FIX message
+                    to an HTTP endpoint.
                 </p>
             </subsection>
             <subsection name="Pre-requisites">
                 <p>
                     <ul>
                         <li>
+                            You need a <a href="http://www.quickfixj.org">Quickfix/J</a> installation
+                            to try out FIX samples. Please download and extract a Quickfix/J distribution
+                            into your local machine.
+                        </li>
+                        <li>
                             Deploy the SimpleStockQuoteService in the sample Axis2 server and start Axis2
                         </li>
                         <li>
+                            Enable the FIX transport receiver for Synapse (refer FIX transport setup
+                            guide for details)
+                        </li>
+                        <li>
                             Start Synapse using the configuration numbered 259 (repository/conf/sample/synapse_sample_259.xml)
                             <div class="command">
                                 Unix/Linux: sh synapse.sh -sample 259<br/>
                                 Windows: synapse.bat -sample 259
                             </div>
                         </li>
+                        <li>
+                            Configure Banzai sample FIX application (shipped with Quickfix/J) to send
+                            messages to Synapse and start it (refer FIX setup guide for more details).
+                            If Banzai was properly configured, it should establish a FIX session with
+                            Synapse upon startup. You should see some session logon messages on Synapse
+                            console and Banzai console.
+                        </li>
                     </ul>
                 </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>
+                    This sample expects a Limit order from Banzai to be received by Synapse and
+                    transformed into a place order request in SOAP format. To try it out send a
+                    'Limit' order request from Banzai to Synapse. Synapse will convert it into a
+                    place order request and send to the Axis2 server over HTTP. The stock quote
+                    service in Axis2 will print the following log when it receives the in-only
+                    place order request.
+                </p>
+                <div class="consoleOutput">Accepted order for : 18406 stocks of MSFT at $ 83.58806051152119</div>
+                <p>
+                    Note that the request sent from Banzai must be of type 'Limit'. Otherwise the
+                    XSLT transformation will not work as expected and Axis2 will receive an invalid
+                    request. Also since the place order requests are one-way messages, Banzai is not
+                    supposed to receive any response in this case.
+                </p>
             </subsection>
         </section>
         <p><a href="../samples.html">Back to Catalog</a></p>        

Modified: synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample261.xml
URL: http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample261.xml?rev=1049316&r1=1049315&r2=1049316&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample261.xml (original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/samples/sample261.xml Tue Dec 14 22:48:01 2010
@@ -23,7 +23,7 @@
         <title>Apache Synapse - Sample 261</title>
     </properties>
     <body>
-        <section name="Sample 261: ">
+        <section name="Sample 261: Switch Between Different FIX Versions">
             <div class="xmlConf">&lt;definitions xmlns="http://ws.apache.org/ns/synapse"&gt;
 
     &lt;proxy name="OrderProcesserProxy41" transports="fix"&gt;
@@ -53,14 +53,32 @@
 &lt;/definitions&gt;</div>
             <subsection name="Objective">
                 <p>
-
+                    Demonstrate the ability of Synapse to switch between FIX versions (eg: FIX 4.0
+                    to FIX 4.1)
                 </p>
             </subsection>
             <subsection name="Pre-requisites">
                 <p>
                     <ul>
                         <li>
-                            Deploy the SimpleStockQuoteService in the sample Axis2 server and start Axis2
+                            You need a <a href="http://www.quickfixj.org">Quickfix/J</a> installation
+                            to try out FIX samples. Please download and extract a Quickfix/J distribution
+                            into your local machine.
+                        </li>
+                        <li>
+                            Enable the FIX transport listener and sender for Synapse (refer FIX setup
+                            guide for details).
+                        </li>
+                        <li>
+                            Configure the Executor sample FIX application (shipped with Quickfix/J)
+                            to receive messages from Synapse and start it (refer FIX setup guide for
+                            more details). In previous samples we only had a FIX 4.0 session configured
+                            for Executor. For this sample we should configure a FIX 4.1 session for
+                            Executor. Therefore before starting it add the following entries to the
+                            configuration file of Executor.
+                            <div class="consoleOutput">[session]
+BeginString=FIX.4.1
+SocketAcceptPort=19877</div>
                         </li>
                         <li>
                             Start Synapse using the configuration numbered 261 (repository/conf/sample/synapse_sample_261.xml)
@@ -68,16 +86,35 @@
                                 Unix/Linux: sh synapse.sh -sample 261<br/>
                                 Windows: synapse.bat -sample 261
                             </div>
+                            If Executor is properly configured, Synapse should establish a FIX 4.1 session
+                            with the Executor upon startup. You should see some log entries confirming
+                            the session logon event on Synapse console as well as Executor console.
+                        </li>
+                        <li>
+                            Configure Banzai sample FIX application (shipped with Quickfix/J) to send
+                            messages to Synapse and start it (refer FIX setup guide for more details).
+                            You should also add the following entry to the Banzai configuration file
+                            before starting it (replace $SYNAPSE_HOME with the actual path to Synapse
+                            home).
+                            <div class="consoleOutput">DataDictionary=$SYNAPSE_HOME/repository/conf/sample/resources/fix/FIX40-synapse.xml</div>
+                            If Banzai was properly configured, it should establish a FIX 4.0 session with
+                            Synapse upon startup. You should see some session logon messages on Synapse
+                            console and Banzai console.
                         </li>
                     </ul>
                 </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>
+                    Send some FIX messages from Banzai to Synapse. Synapse will forward all requests
+                    to Executor and get them processes. Responses from Executor will be routed back
+                    to Banzai.
+                </p>
+                <p>
+                    Note that the session between Banzai and Synapse is a FIX 4.0 session whereas
+                    the session between Synapse and Execurot is a FIX 4.1 session. Synapse receives
+                    FIX 4.0 messages and simply forwards them to the FIX 4.1 endpoint.
+                </p>                
             </subsection>
         </section>
         <p><a href="../samples.html">Back to Catalog</a></p>