Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Web Services Overview

What Are Web Services?

Understanding Web Services

Benefits of Web Services

About the Web Services e-Business Transformation

About Business Transformation with Web Services

About Technology Transformation with Web Services

Overview of Web Services Standards

Simple Object Access Protocol (SOAP)

Web Services Description Language (WSDL)

Universal Description, Discovery, and Integration (UDDI)

Scenario: Web Services with a Currency Converter Application

Understanding the Publisher's Role

Understanding the Caller's Role

2 Oracle9iAS Web Services

Oracle9iAS OC4J (J2EE) and Oracle SOAP Based Web Services

Oracle9iAS Web Services Features

Developing End-to-End Web Services

Deploying and Managing Web Services

Using Oracle9i JDeveloper with Web Services

Securing Web Services

Aggregating Web Services

Oracle9iAS Web Services Architecture

About Servlet Entry Points for Web Services

What Are the Packaging and Deployment Options for Web Services

About Server Skeleton Code Generation for Web Services

Understanding WSDL and Client Proxy Stubs for Web Services

Overview of a WSDL Based Web Service Client

Overview of a Client-Side Proxy Stubs Based Web Service Client

About Universal Description, Discovery, and Integration Registry

Oracle Enterprise Manager Features to Register Web Services

3 Developing and Deploying Java Class Web Services

Using Oracle9iAS Web Services With Java Classes

Writing Java Class Based Web Services

Writing Stateless and Stateful Java Web Services

Building a Sample Java Class Implementation

Defining a Java Class Containing Methods for the Web Service

Defining an Interface for Explicit Method Exposure

Writing a WSDL File or Client-Side Proxy (Optional)

Preparing and Deploying Java Class Based Web Services

Modifying web.xml to Support Java Web Services

Configure the servlet Tag in web.xml for Java Class Web Services

Configure the servlet-mapping Tag in web.xml for Java Class Web Services

Preparing a .war File for Java Class Web Services

Preparing the .ear File for Java Class Web Services

Deploying Java Class Based Web Services

Serializing and Encoding Parameters and Results for Web Services

4 Developing and Deploying EJB Web Services

Using Oracle9iAS Web Services With Stateless Session EJBs

Writing Stateless Session EJB Web Services

Defining a Stateless Session Remote Interface

Defining a Stateless Session Home Interface

Defining a Stateless Session EJB Bean

Returning Results From EJB Web Services

Error Handling for EJB Web Services

Serializing and Encoding Parameters and Results for EJB Web Services

Using Supported Data Types

Writing a WSDL File or Client-Side Proxy Stubs for EJB Web Services

Preparing and Deploying Stateless Session EJB Based Web Services

Preparing a JAR File With an EJB

Modifying web.xml to Support EJB Web Services

Configure the servlet Tag in web.xml for EJB Web Services

Configure the ejb-ref Tag in web.xml for EJB Web Services

Configure the servlet-mapping Tag in web.xml for EJB Web Services

Preparing a WAR File for EJB Web Services

Preparing an EAR File for EJB Web Services

Deploying Web Services Implemented as EJBs

5 Developing and Deploying Stored Procedure Web Services

Using Oracle9iAS Web Services with Stored Procedures

Writing Stored Procedure Web Services

Creating a PL/SQL Stored Procedure for a Web Service

Generating a Stored Procedure Web Service Jar File

Creating and Compiling Stored Procedure Web Service Interfaces

Writing a WSDL File or Client Stubs for Stored Procedure Web Services (Optional)

Preparing Stored Procedure Web Services

Modifying web.xml To Support Stored Procedure Web Services

Configure the servlet Tag for Stored Procedure Web Services

Configure the servlet-mapping Tag for Stored Procedure Web Services

Configure the resource-ref Tag for Stored Procedure Web Services

Preparing a WAR File for Stored Procedure Web Services

Preparing an EAR File for Stored Procedure Web Services

Setting Up Datasources in Oracle9iAS Web Services (OC4J)

Deploying Stored Procedure Web Services

Limitations for Stored Procedures Running as Web Services

Supported Stored Procedure Features for Web Services

Unsupported Stored Procedure Features for Web Services

6 Building Clients that Use Web Services

Locating Web Services

Getting WSDL Descriptions and Client-Side Proxy Jar for Web Services

Getting WSDL Service Descriptions

Getting Client-Side Proxy Jar and Client-Side Proxy Source Jar

Getting Client-Side Proxy Jar and Client-Side Proxy Source with a Specified Package

Working with Client-Side Proxy Jar to Use Web Services

Using Web Services Security Features

Working with WSDL and JDeveloper to Use Web Services

7 Web Services Assembly Tool

Running the Web Services Assembly Tool

Web Services Assembly Tool Configuration File Specification

Web Services Assembly Tool Configuration File Sample

Web Services Assembly Tool Configuration File Sample Output

Web Services Assembly Tool Limitations

8 Discovering and Publishing Web Services

UDDI Registration

UDDI Registry

Oracle UDDI Enterprise Web Service Registry

Web Service Discovery

Using Tools

Using the Inquiry API

Web Service Publishing

Oracle UDDI Registry

Publishing a Web Service Using the OEM Deploy Applications Wizard

Publishing a Web Service Using the OEM Web Services Details Window

Updating a Published Web Service in the UDDI Registry

Database Character Set and Built-in ISO-3166 Taxonomy

9 Consuming Web Services in J2EE Applications

Consuming XML or HTML Streams in J2EE Applications

Web Service HTML/XML Stream Processing Wizard

Sample Use Scenarios

Handling an XML or HTML Stream Accessed Through a Static URL

Handling an XML or HTML Stream Accessed Through a Form

Advanced Section -- Editing Changes You Can Make to Generated Files

Editing the Generated XSLT Stylesheet

Modifying Environment Options in the Generated ejb-jar.xml File

Consuming SOAP-Based Web Services Using WSDL

Advanced Configuration

Known Limitations of the wsdl2ejb Utility

Running the Demonstration

RPC and Document Style with Simple Types Example

Round 2 Interop Services: Base Test Suite Example

Dynamic Invocation of Web Services

Dynamic Invocation API

WebServiceProxy Client

Known Limitations

A Using Oracle SOAP

Understanding Oracle9iAS SOAP

Apache SOAP Documentation

Configuring the SOAP Request Handler Servlet

Using Oracle9iAS SOAP Management Utilities and Scripts

Managing Providers

Using the Service Manager to Deploy and Undeploy Java Services

Generating Client Proxies from WSDL Documents

Generating WSDL Documents from Java Service Implementations

Deploying Oracle9iAS SOAP Services

Creating Deployment Descriptors

Installing a SOAP Web Service in OC4J

Disabling an Installed SOAP Web Service

Installing a SOAP Web Service in an OC4J Cluster

Using Oracle9iAS SOAP Handlers

Request Handlers

Response Handlers

Error Handlers

Configuring Handlers

Using Oracle9iAS SOAP Audit Logging

Audit Logging Information

Audit Logging Output

Auditable Events

Audit Logging Filters

Configuring the Audit Logger

Using Oracle9iAS SOAP Pluggable Configuration Managers

Working With Oracle9iAS SOAP Transport Security

Apache Listener and Servlet Engine Configuration for SSL

Using JSSE with Oracle9iAS SOAP Client

Using Oracle9iAS SOAP Sample Services

The Xmethods Sample

The AddressBook Sample

The StockQuote Sample

The Company Sample

The Provider Sample

The AddressBook2 Sample

The Messaging Sample

The Mime Sample

Using the Oracle9iAS SOAP EJB Provider

Stateless Session EJB Provider

Stateful Session EJB Provider in Apache SOAP

Stateful Session EJB Provider in Oracle9iAS SOAP

Entity EJB Provider in Oracle9iAS SOAP

Deployment and Use of the Oracle9iAS SOAP EJB Provider

Current Known EJB Provider Limitations

Using PL/SQL Stored Procedures With the SP Provider

SP Provider Supported Functionality

SP Provider Unsupported Functionality

SP Provider Supported Simple PL/SQL Types

Using Object Types

Deploying a Stored Procedure Provider

Translating PL/SQL Stored Procedures into Java

Deploying a Stored Procedure Service

Invoking a SOAP Service that is a Stored Procedure

SOAP Troubleshooting and Limitations

Tunneling Using the TcpTunnelGui Command

Setting Configuration Options for Debugging

Using DMS to Display Runtime Information

SOAP Limitations for Java Type Prcedence with Overloaded Methods

Oracle9iAS SOAP Differences From Apache SOAP

Service Installation Differences

Optional Provider Enhancements

Oracle Transport libraries

Modifications to Apache EJB Provider

Stored Procedure Provider

Utility Enhancements

Modifications to Sample Code

Handling the mustUnderstand Attribute in the SOAP Header

Setting the mustUnderstand Check

How the mustUnderstand Check Works

Differences Between Apache SOAP and Oracle SOAP for mustUnderstand

Glossary

Index