Tutorials

Introducing the BEA AquaLogic Service Bus Examples

What are the BEA AquaLogic Service Bus Examples?

The BEA AquaLogic Service Bus examples provide you with a quick and easy out-of-the-box experience of the run time capability of using BEA AquaLogic Service Bus proxy services in your design environment. The examples do not explore the implementation details of creating an AquaLogic Service Bus proxy service. They are user driven pre-configured scenarios that use AquaLogic Service Bus to communicate with business services. The examples are based on typical business scenarios that benefit from using the proxy services to communicate between clients and business processes. You can run the examples to see how AquaLogic Service Bus operates in the run time environment, or you can build the examples in the development environment to get more in-depth knowledge of how to configure the proxy service. For instructions on how to build a solution similar to those presented in the example scenarios, follow the instructions provided in each of the tutorials:

Examples Description

The following examples are pre-packaged with AquaLogic Service Bus:

Routing a Loan Application

A primary mortgage company uses AquaLogic Service Bus to route loan applications to appropriate business services based on the interest rate requested. An application containing a request for a rate less than 5% requires management approval and is routed to an appropriate business service for processing. All other loan applications are routed to another business service for processing. The target business service responds indicating whether the loan application is approved or rejected.

Transforming a Loan Application

A primary mortgage company uses AquaLogic Service Bus to identify and re-route loan applications that are easy to sell to secondary loan companies. A loan application with a principal request of $25,000,000.00 is a saleable candidate. When a loan application meeting the criteria is discovered, a Web service lookup is performed to retrieve the customer's credit rating. The credit rating information is added to the loan application and the application is then forwarded to the secondary mortgage company's Web service to be processed. All other loan applications are routed to another business service for processing. The target business service responds indicating whether the loan application is approved or rejected.

Validating a Loan Application

A primary mortgage company uses AquaLogic Service Bus to route loan applications to appropriate business services and to check the validity of the applications. An incomplete application is written to an error directory and an error message is returned to the client. A complete application is routed to a selected business service for review. If approved, the business service returns a message indicating whether the loan is accepted or rejected.

Using the AquaLogic Service Bus Examples

Prerequisites to Running the Examples

AquaLogic Service Bus must be running in the examples domain—see To Run the Examples in the next topic.

Running the Examples

The examples are installed automatically as part of the AquaLogic Service Bus installation. They are located in the BEA_HOME\weblogic90\samples\servicebus\examples directory.

When you install AquaLogic Service Bus on a Windows system, the installation program automatically creates shortcut files on the Start Menu. Options on the Start Menu vary according to the components you choose to install.

To Run the Examples

Start the examples server in one of the following ways:

From the Windows Start menu, select:

Start—>Programs—>BEA Products —>Examples—>AquaLogic Service Bus—>Start Examples Server

Run the startWebLogic command from your Windows or UNIX command line:

[BEA_HOME}\weblogic90\samples\domains\servicebus\startWebLogic.cmd
[BEA_HOME}/weblogic90/samples/domains/servicebus/startWebLogic.sh

This starts the examples server and launches a browser window that displays a page from which you can run the examples. This page contains descriptions for each of the three examples, and links to run them.

Note: If your examples server is running, you can launch the page from which to start the examples by entering the following URL in your browser location field:
http://host:port/examplesWebApp/index.jsp
where host:port represents the host and port on which your server is running.

Before running the examples you must activate the examples. To do so, select Click to load Service Bus Samples Configuration.

Click Run the Example for the examples you want to run.

What to Learn From the Examples

The AquaLogic Service Bus examples are based on a loan application request scenario in which AquaLogic Service Bus is used to manage message routing in the enterprise environment.

Running the examples introduces you to the routing, transformation, and validation capabilities of BEA AquaLogic Service Bus. You can see how the proxy service drives the interaction between the client and the business services to route messages, based on the user supplied information.

Running an example invokes an application that uses the proxy service to communicate with the client and the business services. When you run an example, you are prompted to change the parameter setting that in turn, changes the behavior of the proxy services defined in AquaLogic Service Bus. The fields that you can change for a given example are highlighted on the examples page. Each page also provides basic instructions for executing the examples successfully.