This documentation is for WSO2 Enterprise Service Bus version 4.7.0 . View documentation for the latest release.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3


This sample demonstrates an introduction to error handling with the "fault" sequence. It sends a message from a sample client to a back-end service through the ESB through 3 mediation options as: success scenario, a failure scenario without error handling and a failure scenario with proper error handling.


Refer to For a list of prerequisites, see the Prerequisites section in ESB Samples Setup page.

Building the Sample

1. Start the ESB with sample 4 configuration using the instructions given in Starting Sample ESB Configurations.

2. A message should appear in the command or text Linux console stating the server started successfully.


4. Deploy the back-end service 'SimpleStockQuoteService' and start the Axis2 server using the instructions given in section Starting Sample Back-End Services.

5. Now you have a running ESB instance and a back-end service deployed. In the next section, we will send a message to the back-end service through the ESB using a sample client.


The sample client used here is 'Stock Quote Client' which can operate in several modes. For instructions on this sample client and its operation modes, refer to Stock Quote Client.

1. Run the following ant command from <ESB_HOME>/samples/axis2Client directory to trigger a sample message to the back-end service.


Code Block
ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dsymbol=IBM

When the IBM stock quote is requested, the configuration routes it to the defined inline endpoint, which routes the message to the SimpleStockQuoteService on the local Axis2 instance. Therefore, a valid response message is shown at the client.