11 Web Service Client Example

Real-Time Decision Server Integration Points are available through a Zero Client approach. Integration Points on a deployed Inline Service are exposed through a Web services definition.

The ability to invoke and asynchronously invoke a deployed Integration Point is exposed as a Web service by Real-Time Decision Server. The definition of these operations are available in a WSDL file, located at:

RTD_HOME\deploy\DecisionService\DecisionService.wsdl

The WSDL file defines all complex types and operations available.

Some slight structural changes were introduced in Oracle Real-Time Decisions Version 2.2 to bring the Decision Service up to the WS-I Basic level of compliance. The previous version of the WSDL file is named:

RTD_HOME\deploy\DecisionService\DecisionServiceLegacy.wsdl

Although implementors should develop new clients using the new WSDL, the server still understands the protocol defined by DecisionServiceLegacy.wsdl, and existing clients should experience no loss of functionality.

The instructions in this chapter detail how to use Sun's NetBeans IDE to create a Java WSDL Web service client using the RTD DecisionService WSDL file. The code content for the Web service project Main class is also provided.

This chapter contains the following topics:

• Section 11.1, "Before You Begin"

• Section 11.2, "Creating a New NetBeans Java Application Project"

• Section 11.3, "Adding the Provided Java Code and Testing the Client"

11.1 Before You Begin

You must perform the following tasks first before you can work with the Web Service Client:

1. Download the NetBeans IDE (Java Bundle) from http://www.netbeans.org/downloads/index.html.

2. Install and start the NetBeans IDE.

11.2 Creating a New NetBeans Java Application Project

In Netbeans IDE, to create a new NetBeans Java application project, perform the following steps:

1. In the top menu, select File, then New Project.

2. In the New Project dialog:

   • Under Categories, select Java

   • Under Projects, select Java Application, then click Next

3. Name the Project, and click Finish.

   Installing the JAX-RPC Web Service Plug-in

4. In the top menu, select Tools, then Plugins, then Available Plugins.

5. In the Plugins dialog, click the Available Plugins tab.

6. Check the Web Services plug-in check-box and click Install. Install the plug-in.

   Creating an Oracle RTD Web Service Client

7. In the Projects explorer, right-click your project and select New, then Web Service Client...

8. In the New Web Service Client dialog, select the Local File radio button.

9. Click the Browse... button next to Local File:

10. Locate the file DecisionService.wsdl in the Oracle Real-Time Decisions installation.

    Examples:

    C:\OracleBI\RTD\client\Client Examples\Web Service Client Example\DecisionService.wsdl

    C:\OracleBI\RTD\deploy\DecisionService\DecisionService.wsdl

11. For Client Style, select JAX-WS Style.

12. For Package, select your project package.

13. Click Finish.

11.3 Adding the Provided Java Code and Testing the Client

To add the provided Java code and to test the client, perform the following steps:

1. In the Projects explorer, create the package oracle.rtd.test.

2. Create classes Main and SecurityHandler under this package with the class contents in this example, as in the files Main.java and SecurityHandler.java in RTD_HOME\client\Client Examples\Web Service Client Example.

   You may delete the system generated Main class.

3. Right-click DecisionService under Web Service References, then click Configure Handlers...

4. In the Configure Message Handlers window, click Add, add the class oracle.rtd.test.SecurityHandler as handler, then click OK.

5. Select Run, then Run Main Project from the top menu.

6. View the output in the Output tab at the bottom of the IDE.