Thursday, July 5, 2012

Routing and Service Chaining with WSO2 ESB Part 2

Part 1 > Part 2Part 3 

Part 2 of this series will cover the following:

Deployment of GeoService, HCFacilityLocatorService and HCInformationService in the WSO2 Application Server. 
Creation of the endpoints GeoEP, HCFacilityLocatorServiceEP and HCInformationService in the WSO2 ESB. 
Creation of HCCService proxy service in the WSO2 ESB.

Bear in mind that all the artifacts can be downloaded from - . This will be a step-by-step guide to creating the artifacts that are  given.


AS - Application Server
EPR - Endpoint Reference
ESB - Enterprise Service Bus


1) Read part 1 of this tutorial to understand the demo scenario. 

2) Have the following installed:

WSO2 ESB Version - 4.0.3 
WSO2 Application Service Version - 4.1.2  Go to repository/conf/carbon.xml in from the home folder of the application server and set port offset to 1. The reason being that the ESB and the Application server both need to run at the same time on the same machine and they are configured to run on the same port - 9443. When the port offset is set to 1 in the Application Server, it will now run on port 9444. 
soapUI - 2.5

Adding the Services to AS

Download the following services and deploy them to AS.  

Go to the management console of the WSO2 Application Server.

Add -> Axis2 Service

Browse and choose the file as shown below. 

Deploy the given .aar files - GeoService (geows-SNAPSHOT.aar), HCFacilityLocatorService (hcfacilitylocator-SNAPSHOT.aar) and HCInformationService (hcinformationservice-SNAPSHOT.aar)

If you click on the GeoService service, the service dashboard will appear. On the endpoints section you will see the http and https endpoint URLs. Similarly you can obtain information about the other services as well. 

Creating Endpoints 

Go to the management console of the ESB. Click on Endpoints under Service Bus and the following screen will appear. Click on Address Endpoint.

An Address endpoint is an endpoint defined by specifying the EPR and other attributes of the endpoint directly in the configuration. The 'uri' attribute of the address element contains the EPR of the target endpoint.

To create the first endpoint, fill in with the following details as given in the screenshot.  

Name - GeoEP

After the endpoint is created, if you click on the source view tab you will see the following - 

<endpoint xmlns="" name="GeoEP">
   <address uri="http://localhost:9764/services/GeoService/" format="soap11" >

Similarly create the HCFacilityLocatorServiceEP endpoint with the following properties - 

Name - HCFacilityLocatorServiceEP
Address -

And the HCInformationService endpoint with the following properties.

Name - HCInformationService

After saving each of the endpoints that were created, you will now be able to view the list of endpoints available in the Defined Endpoints tab. 

Creating the HCCService Proxy Service (Part 1) 

As mentioned in the previous post, HCCService will be the proxy service used. The In Sequence of the HCCService will first call the GeoService service with the longitude and latitude values. 

Go to the management console of the WSO2 ESB. Go to Add -> Proxy Service as shown below. 

Select Custom Proxy.

Next a 3 step wizard will appear. Step 1 of 3 will be to fill in basic settings.

Proxy Service Name - HCCService (leave everything else as they are).

(Alternatively you could publish a WSDL for the proxy service if required. You can find the WSDL for the HCCService here).

Then click on Next.

For step 2 of 3, which is to create the in sequence, select Define Inline and click on Create.
(You can define an endpoint if you do not want to mediate the incoming message instead of defining the in sequence).

You will now see a graphical editor to add mediators to sequences. Click on Add Child. 

We will first add a property mediator. Add Child -> Core -> Property. 

The editor will now have a new child node, which is the property mediator.

Let's take a look at the request message before we set the properties of the property mediator. We need to obtain the longitude and latitude values to  pass on to the GeoService service. 

<soapenv:Envelope xmlns:soapenv="" xmlns:heal="http://healthcare.wso2">
The property mediators will be used to store the values of longitude and latitude. Click on the property mediator and go to the properties view below. Give the following values.
Name - longitude
Action - Set  (The action can be set or remove. 'Set' to add a new property and 'Remove' to remove a property with the given name).
Set Action as - Expression (Specify which type of value to store) 
Type - String
Expression - //heal:getHealthcareCenterInfo/heal:longitude/text()  (XPath expression)

Add another property mediator and add the following properties as shown below.

Name - latitude
Action - Set  
Set Action as - Expression 
Type - String
Expression - //heal:getHealthcareCenterInfo/heal:latitude/text()

For more information on the property mediator check here

Let's now add a log mediator. 

In the properties section add the properties as given below. 
Log Category - INFO  (Log messages will be logged in log4j with selected log category. The default log category is INFO)

Log level - Custom (Custom: Only properties specified to the Log mediator)
Log Seperator - , (The log separator is used to separate the attributes being logged. The default separator is ',' (comma))

Add properties for the log mediator. Longitude and Latitude values will be loggged because the Log level is Custom. 

$ctx:longitude and $ctx:latitude ($ctx is the prefix for Synapse message context properties)

For more information on the log mediator check here.

As shown in the screenshot below, let's add an enrich mediator now. For more information on enrich mediator check here. Actually, we can avoid using the enrich mediator here and use the payloadfactory mediator instead. You can see the reason for this later where I explain about its use.  

With the enrich mediator we will be replacing the body of the message with the body of a request message that goes to the GeoService. 

Give the following values for the enrich mediator as shown.

Clone - true (By setting the clone configuration, the message can be cloned or else used as a reference during the enriching)
Type - inline (Specifies an inline xml value)
Inline Content should be chosen from the radio buttons. 
Inline XML -

<geo:getZipCode xmlns:geo="http://geo.wso2">

Action - replace  (By specifying the action type the relevant action can be applied to outgoing message. By specifying the replace action type it replaces the xml message based on the target type specified on the target configuration)
Type - body (Body of the original message will be used for enriching)

Add another enrich mediator and add the following values.  This is used to replace the longitude value of the body with the longitude value received by the proxy service. 

Clone - true
Type - property (Specifies a property)
Property - longitude

Action - replace
Type - custom (To give custom XPath value) 
XPath Expression - //geo:getZipCode/geo:longitude/text()

Add a 3rd enrich mediator as shown below. This is used to replace the latitude value of the body with the latitude value received by the proxy service.  This will be similar to the previous endpoint except for the values for the following properties. 

Property - latitude
XPath Expression - //geo:getZipCode/geo:latitude/text()

Add another log mediator as shown below with the given properties. 

Finally add a send mediator as shown below. Add Child -> Core -> Send. 

Following is the screenshot when everything is complete for the send mediator.

Select Endpoint type - Pick from Registry (browse in the configuration registry as shown and select GeoEP endpoint).

In the properties view of the send mediator, the receiving sequence type should be selected as static (or dynamic if calculated using a XPath).

The receiving sequence (hcfRequest) can be selected and given as shown below.

For more information on the send mediator click here

Note that hcfRequest is a sequence that needs to be created. When the screenshot was taken hcfRequest was already created and added as the receiving sequence for the ease of understanding. Since you have not created hcfRequest sequence at this point, after creating the send mediator, save the proxy service and let's get on to creating the hcfRequest sequence. After creating it, come back to the send mediator and add the sequence as shown above. hcfRequest will be created in part 3 of this tutorial series.


  1. [2013-01-23 12:47:10,383] ERROR - SynapseXPath Evaluation of the XPath expression //heal:getHealthcareCenterInfo/heal:longitude/text() resulted in an error
    org.jaxen.UnresolvableException: Cannot resolve namespace prefix 'heal'

    what is the problem.?

    1. This is because the namespace is not filled:
      In your Property Mediatior design view, after entering the expression : //heal:getHealthcareCenterInfo/heal:latitude/text(),
      Click on "Namespaces" (in blue beside the field). A popup is displayed asking for the prefix (heal) and the uri (http://healthcare.wso2).

    2. Yes, I have missed that step :( . Please define the namespace 'heal' as http://healthcare.wso2 as instructed by Yaya. Thanks Yaya!