Examples
|
 |
 |
|
 |
 |
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 in BEA AquaLogic Service Bus 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\weblogic91\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
- From the Windows Start menu, select:
- Run the
startWebLogiccommand, as shown below, from your Windows or UNIX command line respectively: This starts the examples server and launches a browser window that displays the AquaLogic Service Bus Examples page, from which you can run the examples. This page contains descriptions of each of the examples, information and link to load all examples, and links to run each of the three examples. There are also links to additional resources that will help you learn more about AquaLogic Service Bus.
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
wherehost:portrepresents the host and port on which your server is running. Typically, this islocalhost:7021/examplesWebApp/index.jsp.- Load the examples data in the domain by clicking Load the Examples. If you have previously loaded the examples, the Reload the Examples option is displayed instead. Click Reload the Examples only if you have changed your domain.
Note: As stated in Step 1 of the AquaLogic Service Bus Examples page, you only have to load the examples the first time you use them in a domain. This is a one-time activity and you need to reload the examples only if you change your domain.
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.
