Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Simple Object Access Protocol Overview

What Is the Simple Object Access Protocol?

How Does SOAP Work?

Why Use SOAP?

What Is Oracle SOAP?

Client Application and Client API

SOAP Client API

Oracle SOAP Security Features

SOAP Transports

Administrative Clients

SOAP Request Handler

SOAP Provider Interface and Providers

Provider Interface

Provider Deployment Administration

SOAP Services

2 Using Oracle SOAP with Java Services

Writing a SOAP Java Service

Specifying a Package Name for the Service

Defining Java Methods

Serializing and Encoding Parameters and Results

Returning a Result

Deploying a SOAP Java Service

Creating a Java Service Deployment Descriptor

Adding Service Classes to the SOAP CLASSPATH

Using the Service Manager to Deploy and Undeploy Java Services

Using the Service Manager to Verify or Query Java Services

Writing a SOAP Java Client

Specifying a Package Name Java Clients

Importing for Java Clients

Defining a Request

Setting Up a Call to Request a Service

Serializing and Encoding Java Parameters and Results

Invoking a Call to Request a Service

Waiting for a Response and Handling SOAP Faults

Running a Client

Using Security Features with a Client

SOAP Troubleshooting

Tunneling Using the TcpTunnelGui Command

Setting Configuration Options for Debugging

Using DMS to Display Runtime Information

3 SOAP Parameters and Encodings

Writing a SOAP Java Service Using User-Defined Types

Specifying a Package Name for the Service

Defining Java Methods Using Parameters with User-Defined Types

Serializing Java Parameters and Results Using BeanSerializer

Writing JavaBean Support Routines for User-Defined Types

Adding Compiled JavaBean Classes to the CLASSPATH

Returning Results to the Request Handler Servlet

Encoding Java Parameters and Results

Deploying a SOAP Java Service Using User-Defined Types

Developing a SOAP Java Client Using Parameters

Creating Parameters to Pass to a Service

Handling Encoding, Serialization, and Mapping with Parameters

Setting Up a Call to Request a Service with Parameters

Invoking a Call to Request a Service with Parameters

Running a Client with Parameters

Writing a SOAP Service Using Arrays as Parameters

Server-Side Adjustments for Using Arrays as Parameters

Client-Side Adjustments for Using Arrays as Parameters

Writing a SOAP Service Using Literal XML Encoding

Server-Side Adjustments for Using Literal XML Encoding

Creating a Return Value with Literal XML Encoding

Client-Side Adjustments for Using Literal XML Encoding

Specifying a Call with Literal XML Encoding

Invoking a Call with Literal XML Encoding

4 SOAP Audit Logging

Audit Logging Information

Audit Logging Output

Auditable Events

Audit Logging Filters

Configuring the Audit Logger

5 SOAP Handlers

Handler Overview

Request Handlers

Response Handlers

Error Handlers

Configuring Handlers

6 Writing SOAP Providers

Provider Interface Overview

Implementing a Provider Interface

Implementing Provider Interface Methods

Working with the Provider init() Method

Working with the Provider invoke() Method

Working with the Provider destroy() Method

Working with the Provider getId() Method

Handling Provider Deployment

Updating the Provider Deployment Descriptor Schema

Updating the Service Deployment Descriptor Schema

7 Writing Deployment Managers

Creating a Provider Manager

Creating a Service Manager

8 SOAP Administration

Configuring the Request Handler Servlet

Setting Provider Manager and Service Manager Configuration Options

Using Auto Start Mode

Setting Jserv Configuration and Security

Changing the HTTP Listener Port Number

Configuring Memory Options

A Apache Software License, Version 1.1

Index