Contents

About This Document

Who Should Use This Guide
Using the Documentation
How This Guide Is Organized
Reference Information
Documentation Conventions

General Conventions
Conventions Referring to Directories

About Web Services

What are Web Services?
Messaging Models Used in Web Services

Synchronous Model
Asynchronous Model

Standards and Interoperability in Web Services

SOAP
WSDL
UDDI
ebXML

A Simple Web Service Scenario
Support for Web Services in Sun ONE Application Server
Java APIs for XML and Web Services

JAXP
JAX-RPC
JAXR
SAAJ
JAXM

Implementing Web Services Using Java APIs

The Coffee Break Example

Preparing for Developing Web Services and Clients

Using Ant Tasks
Setting Up the Client Environment

Services and Clients Using JAX-RPC

JAX-RPC Implementation
Developing JAX-RPC Web Services

JAX-RPC Web Services Using a WSDL

Assembling and Deploying JAX-RPC Web Services
Invoking JAX-RPC Web Services

Creating Clients Using Generating Stubs Method

Generating the Stubs
Coding the Client
Compiling the Client Code
Assembling the Client Classes into a JAR file
Running the Client

Creating Clients Using Dynamic Invocation Interface

Creating JAX-RPC Client Using a Dynamic Proxy
Creating a JAX-RPC Client Using the Call Interface

Assembling and Deploying a JAX-RPC Client
Sample Applications

JAX-RPC Client Invoking an EJB
Building Security into JAX-RPC Web Services

Basic Authentication Over SSL
Adding Security Elements to web.xml
Setting Security Properties in the Client Code
Mutual Authentication Over SSL
Setting Up Client Certificate Authentication for Web Services

JAX-RPC Tools

wscompile Tool

wscompile Command Options
Configuration File

wsdeploy Tool

wsdeploy Command Options

Namespace Mappings
SOAP Handlers

Java Language Types Supported By JAX-RPC

SOAP Clients and Services Using SAAJ and JAXM

SOAP Clients

SOAP Client Messaging Models

Client Without a Messaging Provider
Client With a Messaging Provider

SOAP Messages

Parts of a SOAP Message
Accessing Elements of a Message

Developing a SOAP Client

How SOAP Messaging Occurs?
Creating a SOAP Client

Assembling and Deploying a SOAP Client

SOAP Service

Creating a SOAP Service
Exception and Fault Handling

Fault Handling
Defining SOAP Fault

Assembling and Deploying a SOAP Service
Sample Clients and Services

Clients Using JAXR

Developing a JAXR Client

Getting Access to a Registry

Accessing an ebXML Registry

Establishing a Connection
Querying a Registry

Finding Organizations by Name
Finding Organizations by Classification
Finding Organizations by WSDL Descriptions
Finding Services and Service Bindings

Managing Registry Data

Getting Authorization from the Registry
Creating an Organization
Adding Classifications
Using Taxonomies

Defining Taxonomies
Specifying Postal Address

Adding Services and Service Bindings to an Organization

Publishing a Web Service to a UDDI Registry
Assembling and Deploying a JAXR Client

Sample JAXR Client

Appendix A

XML Schema Definitions

XML Schema for wscompile Configuration File
XML Schema for Deployment Descriptors
XML Schema for Exported wscompile Model Files
XML Schema for Runtime Descriptors

Glossary

Index