This chapter provides an overview of the DSP (Oracle Data Service Integrator) transport and describes how to use and configure it in your services.
This chapter includes the following sections:
For information on supported Service Bus interoperability with Oracle Data Service Integrator, see "Interoperability Scenarios and Considerations" in Administering Oracle Service Bus. For information about the Oracle Data Service Integrator, see Developing Applications with Data Service Integrator.
Oracle Data Service Integrator can be accessed by Service Bus through the DSP transport, allowing Service Bus to make full use of data services. This approach also allows a more efficient and flexible approach to accessing data services compared to exposing such services as web services.
To make an Oracle Data Service Integrator data service available to a Service Bus client requires the following steps:
Generate a WSDL file for the data service and import the new WSDL file into Service Bus.
Create and configure a business service based on the WSDL file.
Create and configure a proxy service based on the business service.
Create and configure a pipeline to route and transform messages between the proxy and business service.
Once these tasks are complete, you can invoke data services through Service Bus.
This section takes you through a sample project that illustrates the use of a data service in Service Bus. In order to follow the steps in this sample, you must be using the sample WebLogic domain. For more information, see "Sample Applications and Code Examples" in Understanding Oracle WebLogic Server.
Perform the following steps in Oracle Data Service Integrator.
Start the Oracle Data Service Integrator server if it is not already running. This scenario uses the sample
RetailDataspace provided with Oracle Data Service Integrator on the sample domain.
You can generate the WSDL file from your data service using Data Services Studio. You can also export the WSDL file using the Oracle Data Service Integrator Console, or view and copy the WSDL definition from an existing web service map file. For information and instructions, see "Generating a Web Service Map and WSDL from a Data Service" in Developing Applications with Data Service Integrator.
Use the following steps to obtain the URL address of the WSDL file.
Below is the address for the OrderService example:
Perform the following steps in the Oracle Service Bus Console or in JDeveloper.
Service Bus lets you import a WSDL file generated in Oracle Data Service Integrator into Service Bus using the Oracle Service Bus Console or JDeveloper. This scenario uses the Service Bus example server and the Default project. The default user name is weblogic; you defined the password when you created the example server.
Create a new Service Bus project, and import the WSDL file and associated files into the new project. For more information about importing, see Importing and Exporting Resources and Configurations .
Create a business service from the WSDL file imported from Oracle Data Service Integrator. Use the following guidelines to configure the business service:
For the business service transport, select dsp.
For the service type, select WSDL, browse to and select the imported WSDL file, and then select the appropriate port or binding; for example,
For the endpoint URI, enter the URI to the Oracle Data Service Integrator project; for example,
On the Transport Details page of the Business Service Definition Editor, configure the transport settings. For more information, see Table 27-1 or the online help for the transport detail page. For more information on creating business services, see Creating and Configuring Business Services.
Generate a proxy service from the business service, as described in How to Generate a Proxy Service from an Existing Service in JDeveloper. You can only generate a proxy service from a business service using JDeveloper. Alternatively, you can create a proxy service in the console without generating it from the business service.
In practice you would most likely identify the encryption key, digital signature key, and SSL client authentication key. However, for the example, none of these need to be identified. The DSP transport uses the character set provided by the proxy service. Therefore if the default character set needs to be changed prior to invoking a data service transport, the conversion encoding needs to be handled within the proxy service itself.
Create a pipeline to perform any data transformations and to route the data from the proxy service to the business service. For more information, see Working with Pipelines in Oracle Service Bus Console or Working with Pipelines in Oracle JDeveloper .
Use the following steps to test access to the Oracle Data Service Integrator data service through the proxy service generated above.
<ord:getOrderByCustID xmlns:ord="ld:RetailApplication/OrderManagement/OrderService.ws"> <ord:custID>CUSTOMER3</ord:custID> </ord:getOrderByCustID>
Figure 27-1 Request and Response from the Service Bus Test Console
This section provides descriptions for DSP transport-specific properties for business services.
When you create business services that use the DSP transport, enter the endpoint URI for the business service in the following format:
The following table describes the properties you use to configure a DSP-based business service. For more information, see Creating and Configuring Business Services.
Table 27-1 DSP Transport Configuration Properties for Business Services
Enter one of the following options to specify how to handle debug information:
Enter a service account that will be used for authentication to access the service. If no service account is specified, an anonymous subject is used.
For more information, see Working with Service Accounts..
Select the instance of WebLogic Server Work Manager that you want to use to post the reply message for response processing. The default Work Manager is used if no other Work Manager exists.
For information about Work Managers, see: