10 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 RTD 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 10.1, "Before You Begin"

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

• Section 10.3, "Installing the JAX-RPC Web Services Plug-in"

• Section 10.4, "Creating an Oracle RTD Web Service Client"

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

10.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.

3. Locate the Oracle RTD DecisionService.wsdl file and Java project main content file. These files can be located in an Oracle RTD installation at the following location:

   • RTD_HOME\OracleBI\RTD\client\Client Examples\Web Service Client Example\DecisionService.wsdl

   • RTD_HOME\OracleBI\RTD\client\Client Examples\Web Service Client Example\main-content.txt

RTD_HOME\deploy\DecisionService\DecisionService.wsdl

The WSDL file defines all complex types and operations available.

Some slight structural changes were introduced in Oracle RTD 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.

10.2 Creating a New NetBeans Java Application Project

To create a new NetBeans Java application project, perform the following steps:

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

2. In the New Project dialog under Categories, select Java.

3. Under the Projects section of the dialog, select Java Application.

4. Click Next.

5. Name the Project, and click Finish.

10.3 Installing the JAX-RPC Web Services Plug-in

To install the JAX-RPC Web services plug-in, perform the following steps:

1. In the top menu, select Tools > Plugins > Available Plugins.

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

3. Check the JAX-RPC Web Services plug-in check-box and click Install. Install the plug-in.

10.4 Creating an Oracle RTD Web Service Client

To create an Oracle RTD Web Service Client, perform the following steps:

1. In the Projects explorer, right-click your project and select New > Web Services Client...

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

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

4. Locate the file DecisionService.wsdl in the RTD installation.

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

5. For Client Style, select JAX-RPC Style.

6. For Package, select your project package.

7. Click Finish.

10.5 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, locate the generated Main.java file and open it.

   It should be under PROJECT_NAME > Source Packages > PROJECT_NAME > Main.java.

2. In the main() method, add the code content in the file main-content.txt and save Main.java.

   Note:

   Additional exceptions handling code may be required for the project to compile and run properly.

3. Select Run > Run Main Project from the top menu.

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