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

tell me more icon Creating an Application and a Project

The JDeveloper application is the highest level in the organizational structure. It stores information about the objects you are working with, while you are creating your application. It keeps track of your projects and the environment settings while you are developing.  [ tell me more...]





  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.

    tell me more icon 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

tell me more icon Adding a Web Service Binding Component

Binding components such as web services make SOA composite applications accessible to the outside world. There are two types of binding components in an SOA composite application: services and references.   [ tell me more...]





  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.

    tell me more icon 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

tell me more icon Adding a Mediator Service Component

Service components implement the business logic or processing rules of the SOA composite application. A Mediator service component routes data through an SOA composite application. Using the Mediator service component, you create routing services and rules for them. A routing service is the key component for moving a message from entry point to exit point in an application. The rules determine how a message instance processed by the routing service gets to its next destination.  [ tell me more...]





  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 icon Save All.

    tell me more icon In the IDE

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



 

Connect the Components

tell me more icon Connecting the Components

Wires enable you to connect binding component services, service components, and binding component references in an SOA composite application for message communication.  [ tell me more...]





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

    tell me more icon 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

tell me more icon Passing the Payload

You must pass the incoming payload from the binding component service to the Mediator service component to the BPEL process service component. This requires you to create a transformation to map the payload contents from the source schema WSDL file of the web service to the target schema WSDL file of the BPEL process. The Mediator service component routes the payload between the two.  [ tell me more...]





  1. In SOA Composite Editor, double-click the SOAP2BPEL Mediator component.
  2. Click transformation icon 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 icon Save All.
  7. Close the XSLT Mapper.
  8. Close the SOAP2BPEL Mediator component.

    tell me more icon 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

tell me more icon Creating an Application Server Connection

You must create a connection to an Oracle Application Server to which to deploy your SOA composite application. You must install a database and configure it with the Oracle SOA Suite schema before creating an application server connection.  [ tell me more...]





  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 .

    tell me more icon In the IDE

    After creating an application server connection, select View then choose 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

tell me more icon Deploying the Application

In order to test and monitor your SOA composite application, you deploy the application deployment profile to the Oracle WebLogic Server instance to which you created a connection. Select Deplo y then choose m yFirstComposite .  [ tell me more...]





  1. Right-click myFirstComposite, and select Deplo y then choose 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 icon Save All.

    tell me more icon 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.

false ,,,,,,,,,,,,,,,