Design an SOA Composite Application

You can easily create an application and project in which to design a service-oriented architecture (SOA) composite application. You then design the contents of the application to include binding components that make the application accessible to the outside world and service components that implement the business logic or processing rules of the application. You connect these components together with wires to enable message communication and create a transformation to map the message (payload) contents from the source binding component to the target service component.

You must install a database and configure it with the Oracle SOA Suite schema before creating an application server connection and deploying an SOA composite application. See Oracle Fusion Middleware Installation Guide for Oracle SOA Suite for more information.

Create an Application and a Project: Use the Create SOA Application wizard to create an application and a project with a business process execution language (BPEL) service component. A BPEL process service component enables you to integrate a series of business activities and services into an end-to-end process flow.

Add a Web Service Binding Component: Use the Create Web Service dialog to create a binding component service that provides a SOAP protocol entry point into the SOA composite application for the outside world.

Add a Mediator Service Component: Use the Create Mediator dialog to create a Mediator service component for routing data through the SOA composite application.

Connect the Components: Connect the binding component service and service components together with wires that enable message communication.

Pass the Payload: Use the Routing Rules panel, Request Transformation Map dialog, and XSLT Mapper to create a transformation mapper file that maps the message (payload) contents from the source web service WSDL file to the target BPEL process WSDL file.

Create an Application Server Connection: Use the Create Application Server Connection wizard to create a connection to the application server to which to deploy the SOA composite application.

Deploy the Application: Deploy the application to the application server in which you created the connection. When prompted, accept all default settings on the Revision ID dialog and the Deployment Plan dialog that display during the deployment process.

Create an Application and a Project

1. Open the Create Application wizard [ file > new > applications > SOA application] .
2. In the Application Name field, enter SOA-first-composite.
3. Select SOA Application in the Applica tion Template list, and click Next .
4. In the Project Name field, enter myFirstComposite, and click Next .
5. In the Composi te Template list, select Composite With BPEL, and click Finish .
6. In the Create BPEL Process dialog, enter emptyBPEL in the Name field.
7. From the Template list, select One Way BPEL Process.
8. Deselect the E xpose as a SOAP Service checkbox.
9. Click OK. The BPEL Process Designer appears.
10. Close the BPEL Process Designer.
    

    In the IDE

    After you create your application and project, the Application Navigator and SOA Composite Editor should look like this:  [ tell me more...]

    
    
    

Add a Web Service Binding Component

1. In the Component Palette, select SOA from the dropdown list.
2. Drag a Web Service component into the Exposed Services column of the SOA Composite Editor.
3. In the Create Web Service dialog, enter receive in the Name field.
4. Click the Generate WSDL from schema(s) icon to the right of the WSDL URL field.
5. In the Create WSDL dialog, accept all default values and click OK.
6. Click OK.
   

    In the IDE

   After you create the binding component service, the SOA Composite Editor should look like this:  [ tell me more...]

   
   
   

Add a Mediator Service Component

1. In the Component Palette, select the Mediator component and drag it into the Components section of the SOA Composite Editor.
2. In the Create Mediator dialog, enter SOAP2BPEL in the Name field.
3. Select Define Interface Later from the Template dropdown list, and click OK.
4. Click Save All.
   

   In the IDE

   After creating the Mediator service component, the SOA Composite Editor should look like this:  [ tell me more...]

   
   
   

Connect the Components

1. Select the arrow on the right side of the receive web service.
2. Drag the arrow to the arrow on the left side of the SOAP2BPEL Mediator service.
3. Select the triangle on the right side of the SOAP2BPEL Mediator service.
4. Drag the triangle to the arrow on the left side of the emptyBPEL BPEL process.
   

    In the IDE

   After you connect the binding component service, Mediator service component, and BPEL process component, the SOA Composite Editor should look like this:  [ tell me more...]

   
   
   

Pass the Payload

1. In SOA Composite Editor, double-click the SOAP2BPEL Mediator component.
2. Click next to the Transform Using field.
3. In the Request Transformation Map dialog, select Create New Mapper File .
4. Accept the default name in the Create New Mapper File field, and click OK.
5. In the XSLT Mapper, drag the inp1:input node in the source panel to the client:input node in the target panel.
6. Click Save All.
7. Close the XSLT Mapper.
8. Close the SOAP2BPEL Mediator component.
   

    In the IDE

   Once created, the singleString_To_process.xsl file in the xsl folder of the Application Navigator should look like this:  [ tell me more...]

   
   
   

Create an Application Server Connection

1. Open the Application Server Connection Wizard [ file > new > general > connections > application server connection] .
2. On step 1, Name and Type, enter myConnection in the C onnection Name field.
3. From the Connection Type dropdown list, select WebLogic 10.3, and click Next .
4. On step 2, Authentication, enter the credentials authorized to access the application server in the Username and Password fields, then click Next .
5. On step 3, Configuartion, enter the name of the host on which the Oracle WebLogic server is installed with the SOA Infrastructure in the Webl ogic Hostname field.
6. In the WLS Domain field, enter the domain name you specified during Oracle SOA Suite installation.
7. Accept the default settings for all other fields in this dialog, and click Next .
8. On step 4, Test, c lick Test Connection . If successful, the word Success is displayed for all tests. If the test connection fails, ensure that your SOA Infrastructure is running and verify that you correctly entered the host name in the previous page of the wizard.
9. Click Finish .
   

    In the IDE

   After creating an application server connection, select View Application Server Navigator . The connection displays in the Application Server Navigator as a resource, and should look like this:   [ tell me more...]

   
   
   

Deploy the Application

1. Right-click myFirstComposite, and select Deplo y m yFirstComposite .
2. On the Deployment Action step of the Deploy myFirstComopsite wizard, select Deploy to Application Server, and click Next .
3. On the Deploy Configuration step, accept the defaults, and click Next .
4. On the Select Server step, select myConnection, and click Next .
5. On the SOA Servers step, choose the target SOA server to which to deploy the archive, and click Finish .
6. In the Log window that appears at the bottom, click the SOA tab to display any SOA compilation errors. If deployment was successful, the words BUILD SUCCESSFUL display at the bottom.
7. Click the Deployment tab to display any generic deployment errors.
8. Click Save All.
   

    In the IDE

   If deployment was successful, the message that displays in the Log window at the bottom of the designer should look like this:  [ tell me more...]

   
   
   

Copyright © 1997, 2009, Oracle. All rights reserved.