Tutorial: Create and use a JAX-WS web service client for Oracle Determinations Server

The advantage of using a rigorous and well defined interface such as a WS-I compliant web service, is the ability to integrate it with other applications, using tools to aid that integration. Using HTTP as the communication layer and XML as the request and response formats, gives a systems integrator an industry standard way of communicating, with the choice of many tools to build that integration.

This tutorial is a quick walkthrough of the direct integration of Oracle Determinations Server running a rulebase with a simple Java application. The generated JAX-WS client will perform the job of creating the Request as a web service call, making the call, and interpreting the response.

 

A JAX-WS client allows you to build a web service call with Plain Old Java Objects (POJOs). The client performs the conversion to XML and a SOAP Request. The response is likewise converted from XML back to POJOs for ease of integration.

This tutorial uses the JAX-WS Reference Implementation project available from http://jax-ws.dev.java.net.

Requirements to follow the tutorial

As this tutorial discusses programming in Java, you should be familiar with java, and be able to set up and run a program in an IDE of your choice (Eclipse or Netbeans for example). The following Software is required to follow this tutorial:

 

You should follow the instructions for installing JAX-WS correctly on your computer. This tutorial was written using version 2.1.7 of the JAX-WS RI, however older and new versions should work.

1. Compile and run the SimpleBenefits rulebase
2. Compile the client
3. Write a program to use the Client
4. Using a Java Client for the Generic WSDL
5. Generic vs. Specific WSDL
6. Appendix 1 – Glossary of terms
7. Appendix 2 - SimpleBenefitsSpecificAssessJaxWS Class
8. Appendix 3 - SimpleBenefitsGenericAssessJaxWS Class