Introduction
This sample demonstrates how a message can be passed through the WSO2 ESB and logged before it is delivered to its receiver. This is a basic, introductory usecase of WSO2 ESB. In this sample, we will deploy a sample client and a sample back-end service and transfer a message to the back-end service from the client through the WSO2 ESB.
Prerequisites
To install WSO2 ESB and run the sample, you need:
- Java Development Kit/JRE version 1.6.* or 1.7.*
- Apache Ant 1.7.0 or later.
Setup instructions are given in section Installation Prerequisites.
Building the Sample
To start the ESB, simply execute wso2server.bat or wso2server.sh script found in <ESB_HOME>/bin directory. This starts up an instance of the ESB using Synapse and Axis2 configuration files located in <ESB_HOME>/repository/conf directory.
But to build and run samples, the ESB should be started with a sample configuration by executing wso2esb-samples.bat (for Windows) or wso2esb-samples.sh (for Linux) script found in <ESB_HOME>/bin directory. The <ESB_HOME>/repository/samples directory contains the sample configurations for ESB. Since this is sample 0, execute the following command to start the Synapse configuration numbered 0.
For Windows
wso2esb-samples.bat -sn 0
Start the Axis2 server and deploy the SimpleStockQuoteService if not already deployed. (PDF section Starting the Sample Services)
Building the Sample
Run ESB in debug mode.
Go to the bin directory of the distribution and run the build.xml file which resides in that directory using Apache Ant.
Executing the Sample
<definitions xmlns="http://ws.apache.org/ns/synapse">
<sequence name="main">
<in>
<!-- log all attributes of messages passing through -->
<log level="full"/>
<!-- Send the message to implicit destination -->
<send/>
</in>
<out>
<!-- log all attributes of messages passing through -->
<log level="full"/>
<!-- send the message back to the client -->
<send/>
</out>
</sequence>
</definitions>
The Stock quote client can operate in the following modes for this example:
Smart Client mode
ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/
Using ESB as a HTTP Proxy
ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dprxurl=http://localhost:8280/
Gateway Mode / Dumb Client
Refer to Sample 1 Simple Content-Based Routing (CBR) of Messages.
Execute the Smart Client
By tracing the execution of ESB with the log output level set to DEBUG, you will see the client request arriving at ESB with a WS-Addressing To set to EPR http://localhost:9000/services/SimpleStockQuoteService.The ESB engine logs the message at the "full" log level (all the message headers and the body) then sends the message to its implicit To address which is http://localhost:9000/services/SimpleStockQuoteService.You will see a message in the Axis2 server console confirming that the message got routed to the sample server and the sample service hosted at the sample server generating a stock quote for the requested symbol.
Sat Nov 18 21:01:23 IST 2006 SimpleStockQuoteService :: Generating quote for : IBM
The response message generated by the service is again received by ESB, and flows through the same mediation rules, which logs the response message and then sends it back to the client. On the client console you should see an output similar to the following based on the message received by the client.
Standard :: Stock price = $95.26454380258552
Execute the Proxy Client
You will see exactly the same behavior as per the previous example when you run this scenario. However, this time the difference is at the client, as it sends the message to the WS-Addressing To address http://localhost:9000/services/SimpleStockQuoteService, but the transport specifies ESB as the HTTP Proxy.