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

Chapter 1   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

Chapter 2   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

Chapter 3   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

Chapter 4   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

Previous      Index      Next

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.