This page walks you through the development of a complete sample application. It includes the following sections:
...
Sample Scenario
This sample is about the account opening process of a normal retail bank. We are going to develop a simple application to model that scenario using WSO2 Developer Studio. Here is a simplified description of a common retail banking process. When a potential customer walks into a bank branch to open an account, the first thing the bank does is establish the person's identity. Once the person's identity is established, the branch staff perform a query against a customer database to see if the person is an existing customer. Legacy banking systems are based on account numbers, but banks today are focused on getting a single view of the customer, which requires the generation of customer numbers. It's therefore important to ensure that a customer is not assigned more than one customer number by mistake. If the person is a prior customer, the customer number is retrieved from the customer database. If not, a fresh customer number is generated. This customer number is then associated with the new account number of the account that is to be opened. Accounts are still held on thirty year old mainframe systems, which alone can generate fresh account numbers. A debit card is normally issued with the first cheque or savings account that is opened. However, not all branches have the equipment to generate and issue them on the spot. Hence, cards are issued centrally and sent to the customers. If this is an existing customer, the new account is linked to their existing debit card on the spot. Most branches are unable to provide secure PIN printing facilities, so this too is centralised.
...
The following diagram shows how these components hang together. 
Prerequisites
Now we are going to implement the solution using WSO2 Developer Studio. Before start implementing, you will need following third party tools and WSO2 Products.
Third Party Tools
...
Necessary Software Libraries and Drivers
- ActiveMQ
- activemq-core-5.4.2.jar (in ActiveMQ version 5.8.0 and above, activemq-core-5.8.0.jar has been split into activemq-core-broker-5.8.0.jar and activemq-client-5.48.20.jar)
- geronimo-j2ee-management_1.1_spec-1.0.1.jar
- geronimo-jms_1.1_spec-1.1.1.jar
- MySQL JDBC Driver
- mysql-connector-java-5.1.13-bin.jar
...
Following is the logical solution diagram that we are going to use while implementing the solution. This diagram shows how each and every WSO2 Product incorparate to come up with end to end solution. 
In this sample, we are going to create seven projects for each and every component.
...
- WSO2 App Server - 0 (App Server will now listen on 9764 9763 and 94449443)
- WSO2 ESB - 1 (ESB will now listen on 9764 and 9444)
- WSO2 BPS - 2 (Business Process Server will now listen on 9765 and 9445)
- WSO2 DSS - 6 (Data Services Server will now listen on 9769 and 9449)
...
Enable the ESB to talk over a message queue
Copy the ActiveMQ libraries (activemq-core-5.4.2.jar, geronimo-j2ee-management_1.1_spec-1.0.1.jar and geronimo-jms_1.1_spec-1.1.1.jar) to the App Server ESB ($ESB_HOME/repository/components/lib).
Enable the JMS transport on the ESB
Follow the same step that we did for App Server in the previous step.
...
Set up Customer Data Service
Open Under the Developer Studio Dashboard by clicking on Open Dashboard option under top menu item Developer Studio.
top menu item, click Open Dashboard to open the Developer Studio Dashboard.
To create a Data Service, click on click Data Service Project under the Data Services Server category.
Select Import Data Service and click Next.
Browse for the Data Services Descriptor file, CustomerDS.dbs under $DOWNLOAD_HOME/banking-sample/ds/dbs and click Finish.
Now you will see that the Data Service Project has been created in the workspace and make . Make sure to change the User Name and Password according to your MySQL credentials. 
| Anchor | ||||
|---|---|---|---|---|
|
...
To create the Pojo Service, select click Axis2 Service Project from the Developer Studio Dashboard.
From the Axis2 Service Creation Wizard, select Create New Axis2 Service and click Next. 
Fill the following information for Project Name, Package Name and Class Name.
- Project Name - MainframePojoService
- Package Name - wso2.hcc
- Class Name - MainframePojoService
...
After giving the necessary details, click Finish. Now you can see that the Axis2 Service has been created in the workspace. 
Now copy the two source files MainframePojoService.java and Account.java from $DOWNLOAD_HOME/banking-sample/appserver/AccountService/src/wso2/hcc and paste into the wso2.hcc package in the MainframePojoService project. 
Now we want to enable JMS transport, since this service will communicate via JMS transport. To enable this, we need to add the following block to services.xml under /src/main/resources/META-INF.
...
INF.
| Code Block | ||
|---|---|---|
| ||
<transports>
<transport>jms</transport>
</transports> |
Now your services.xml will look like below. 
Now we are done with modeling modelling the Account Service.
2. Modeling Card System
Now we want to create the Card System. This will be another Apache Axis2 Service Project. Select Click Axis2 Service Project from the WSO2 Developer Studio Dashboard as you done did in the previous step.
Select Create New Axis2 Service option from the wizard and give following details to Project Name, Package Name and Class Name.
- Project Name - CardAxis2Service
- Package Name - org.wso2.sample
- Class Name - CardAxis2Service
...
Now you will see the CardAxis2Service has been created in the workspace. Now copy the original sources CardAxis2Service.java, Customer.java and Card.java from $DOWNLOAD_HOME/banking-sample/appserver/CardApplication/src/main/java/org/wso2/sample and paste in to org.wso2.sample package of the CardAxis2Service project. Now we are done with creating two mock services and we are ready to deploy those two services in to WSO2 Application Server.
...
3. Create a Composite Application Project to group mock objects
Open the Developer Studio Dashboard again and select click Composite Application Project.
Give a name to the Composite Application Project and select both services that we created.
Now you You will see that the Composite Application Project has been created in the workspace with the name you have specified.
4. Deploy the Composite Application Project in to WSO2 App Server
Now we are going to deploy the created 
4. Deploy the Composite Application Project in to WSO2 Application App Server.
Before starting the WSO2 App Server, make sure Apache ActiveMQ is up and running.
...
Once you add the server successfully, start the server and add the BankingSample Composite Application to the running server. 
Wait till the application gets deployed successfully to the server. Once the deployement deployment is completed, you will see logs similar to the following in the Eclipse Console.
| Code Block | ||
|---|---|---|
| ||
[2012-04-20 10:05:57,818] INFO {org.wso2.carbon.application.deployer.internal.ApplicationManager} - Deploying Carbon Application : BankingSample.car...
[2012-04-20 10:05:58,059] INFO {org.wso2.carbon.application.deployer.internal.ApplicationManager} - Successfully Deployed Carbon Application : BankingSample {super-tenant}
[2012-04-20 10:06:07,881] INFO {org.wso2.carbon.core.deployment.DeploymentInterceptor} - Deploying Axis2 service: MainframePojoService {super-tenant}
[2012-04-20 10:06:10,517] INFO {org.apache.axis2.transport.jms.ServiceTaskManager} - Task manager for service : MainframePojoService [re-]initialized
[2012-04-20 10:06:11,528] INFO {org.apache.axis2.transport.jms.JMSListener} - Started to listen on destination : MainframePojoService of type queue for service
MainframePojoService
[2012-04-20 10:06:11,570] INFO {org.apache.axis2.deployment.DeploymentEngine} - Deploying Web service: MainframePojoService-1.0.0.aar - file:/media/dev/CS-Resources/2.0.0/review-02-04-2012/servers/wso2as-4.1.2/repository/deployment/server/axis2services/MainframePojoService-1.0.0.aar
[2012-04-20 10:06:11,605] INFO {org.wso2.carbon.core.deployment.DeploymentInterceptor} - Deploying Axis2 service: CardAxis2Service {super-tenant}
[2012-04-20 10:06:12,224] INFO {org.apache.axis2.transport.jms.ServiceTaskManager} - Task manager for service : CardAxis2Service [re-]initialized
[2012-04-20 10:06:13,233] INFO {org.apache.axis2.transport.jms.JMSListener} - Started to listen on destination : CardAxis2Service of type queue for service
CardAxis2Service
[2012-04-20 10:06:13,234] INFO {org.apache.axis2.deployment.DeploymentEngine} - Deploying Web service: CardAxis2Service-1.0.0.aar - file:/media/dev/CS-Resources/2.0.0/review-02-04-2012/servers/wso2as-4.1.2/repository/deployment/server/axis2services/CardAxis2Service-1.0.0.aar |
As displayed in the console log, you can see that the MainframePojoService and CardAxis2Service have been deployed to WSO2 Application Server. Go to management console in the browser and check for Deployed Services.
If you click on the MainframePojoService and check for the Endpoints section, you will see a JMS endpoint . This is because we have specified transport for this service as JMS.
If you check on other service CardAxis2Service, you will see both HTTP and JMS transport endpoints are available.
Now we are going to create proxy services to abstract the above two services.
...
1. Create an "address endpoint" for the mainframe on the ESB
Open the Developer Studio Dashboard and select Endpoint.
...
To create an ESB Config Project, click on Create New Project link. 
Give a name to the ESB Config Project and click Finish. 
Now you will see that the created ESB Project is set in the Save endpoint in field. 
Now you will see that the endpoint has been created inside the ESB Project that you have created. Once you double click on the MainFrameEP node, you will see that the Properties view gets focused. You need to update the URI field with the correct JMS URI that appears in the App Server after deploying the two mock services.
Save the configuration and now we are done with the address endpoint.
...
Right-click on the ESB Configuration Project, then select New ->Proxy Service. Choose the second radio button Import Proxy Service and click Next. Browse to $DOWNLOAD_HOME/banking-sample/esb/synapse-configs/default/proxy-services and select AccountServiceProxy.xml and click Finish. 
Make sure the correct endpoint is being referenced. In the Properties window below, select the row with the Endpoint on it, then click on the button on the far right containing ellipsis (…).
In the Resource Key Editor that pops up, select click workspace.
Expand Carbon Application Endpoints and ESB Configuration Project , then select MainframeEP .
Save the proxy service and now we complete the proxy service that wrap the AccountService mock object.
...
1. Create an "address endpoint" for the CardService on the ESB
In the same manner , that you create the MainFrameEP, create the cardServiceEP. Resource file for cardServiceEP can be found at $DOWNLOAD_HOME/banking-sample/esb/synapse-configs/default/endpoints 
Once the endpoint has been created, make sure that the correct URI has been specified.
2. Create a service on the ESB that will act as a proxy to the Cards system
Right-click on the ESB Configuration Project and select New->Proxy Service. Select Create A New Proxy Service and click Next.
Give the name as CardService and select Custom Proxy from Proxy Service Type and click Finish. 
Now you will find a basic template for a custom proxy has been created in the workspace. Next we have to configure it according to our scenario.
Once the CardService has been opened in Design view, you will see that there are three basic sections in the proxy service; InSequence, OutSequence and FaultSequence (red rectangle).
In the Properties window below, select the row corresponding to WSDL Type, and change its value from NONE to SOURCE_URL and hit Enter. Now a new row will open up with the name Wsdl URL.
In this field, we specify the actual file location of the WSDL file as file URI. The file CardService.wsdl can be found at $DOWNLOAD_HOME/banking-sample/appserver.Your file URI will be similar to: file:///$DOWNLOAD_HOME/banking-sample/appserver/CardService.wsdl .
Drag and drop the XSLT mediator from the tool palette to the InSequence of the CardService proxy.
Click on the newly created XSLT node, and change the Schema Key value to conf:/transform/transform.xslt.
This means that the transformation stylesheet is to be found in the local registry. But we don't have it there yet. The XSLT stylesheet used for transformation (transform.xslt) now needs to be imported into the local registry.
...
You can create before and after logging elements by dragging the Log mediator from the tool palette to before and after the XSLT.
Drag and drop a Send mediator and then drag and drop the cardServiceEP that we created earlier from the defined endpoints.
Now add a Send mediator as an OutSequence. We have successfully completed creating the proxy service for the card system.
Create Registry Resource for transform.xslt
...
Select Import from file system option and and click Next. 
Select Browse file.. button and Click Browse and browse for the transform.xslt file at $DOWNLOAD_HOME/banking-sample/esb/cardService.
Set Registry path to deploy as /_system/config/transform. Note that this is the same path we set when creating CardService. 
With WSO2 Developer Studio, we create all the Registry Resources in a project type called Registry Resources Project. If your workspace has already created Registry Resources Projects, you can point one of them to save your registry resource.
If you do not have created Registry Resources Project, you will have to create a Registry Resource Project in order to create the Registry Resource. To create a Registry Resource Project, click on the link Create New Project.... 
Give the necessary information for the Registry Resource Project and click Finish. 
Now you can see that the created Registry Resources Project is set in the Save resource in field. Once you fill all the information, click Finish. 
Now you will see that the new Registry Resources Project has been created in the workspace.
We have successfully completed the two proxy services for the mock services.
...
To create a BPEL Process, open the Developer Studio Dashboard and select click BPEL Workflow under the Business Process Server category.
Select Create New BPEL Workflow and click Next.
Give
Enter AccountOpeningProcess as the Project Name and Process Name as AccountOpeningProcess and leave , and leave the default values for the other fields as default values. Then click Click Finish . 
Now you You will see that the new BPEL Workflow has been created in the workspace. 
Note that this is just a template BPEL. We need to create the process file according to our scenario. If you are familiar with BPEL, you can use the graphical editor to drag and drop necessary elements from the palette.
For this scenario, you can find already developed BPEL file and other WSDL files from $DOWNLOAD_HOME/banking-sample/bps/AccountOpeningProcess.
Copy all the files from that location and paste in to AccountOpeningProcess project. 
Now we have successfully completed all the parts that we need to try the scenario.
Deploy the SOA Integration Solution
...
Open the pom.xml under Banking Sample. If it is already opened, you will have to refresh the file in order to view all the artifacts in the design view. 
Select all the artifacts by clicking the Select All button. Now we want to change the server role of the Registry Resource from Governance Registry to Enterprise Service Bus since we need to deploy the XSLT file in to local registry of the WSO2 ESB. 
Now we are ready to create the CAR file from the BankingSample C-App project.
To create the CAR file, click on the Create Archive button at the right hand corner of the design view of the pom.xml. You can achieve the same option by right click -clicking on the BankingSample C-App project and select selecting Export Composite Application Project.
Specify the location you want to save the CAR file. Now you will see that the BankingSample.car file has been created in the given location and you can deploy this CAR file in to WSO2 Servers.
Testing the Working Solution
...
We will assume the mock services are already being deployed in to WSO2 App Server. Deploy the CAR file to WSO2 DSS, then to WSO2 ESB, and finally to WSO2 BPS. You can deploy Carbon Application from the management console of each server. Go to Manage -> Applications -> Add.
Once you click this link, you will be prompted to select the CAR file you have saved to your file system. Upload it, then watch the console for messages that the CAR file has been deployed and the appropriate services have also been deployed. 
You will find the following artifacts in different servers once you deploy the CAR file to all the servers. The application BankingSample should be listed in all the servers as well.
| Server | Deployed Artifacts |
| WSO2 App Server | MainframePojoService, CardAxis2Service |
| WSO2 ESB | MainFrameEP, cardServiceEP, AccountServiceProxy, CardService, transform.xslt |
| WSO2 DSS | CustomerDS |
| WSO2 BPS | AccountOpeningProcess |
...
On the right hand side of the screen, under WSDL details, you will find a Create Instance link.
Click this link. A new tab will open up displaying two windows for the request and response messages. The request message has been formatted for you and you only have to enter values into the appropriate placeholders.
...
Enter a random integer value for nid and a string for name. Also enter the string CURRENT for accountType. Click Send. The response should be displayed in the other window with four fields including a card number.
2. Test the account opening process with an existing customer
Click Send again without changing any of the values in the request. The response displayed in the other window now only has two fields. One of them is a new account number. Significantly, there should be no field for card number because existing customers already have debit cards.
