Building Web Services

Sun ONE Studio 4 Programming Series

816-7862-10

Contents

Before You Begin

1. Web Services: A Conceptual Overview

What Are Web Services?

Industry Problems

Applications Within an Enterprise

Applications Shared Across Enterprises

High-Performance Utility Programs

A Standardized Solution

Web Services Standards

SOAP

WSDL

UDDI

Publishing and Using a Web Service

Sun ONE Studio 4 Java Web Services

Multitier Architecture

Web-centric Architecture

Software Versions

XML Operations

What Is an XML Operation?

Request-Response Mechanism

2. Building a Web Service

Web Service Development Tasks

Creating a JAX-RPC Web Service from Java Methods

Developing XML Operations

Adding References to Methods, XML Operations, and JAR Files

Deleting References From a Web Service

Creating a JAX-RPC Web Service from WSDL

Resolving References to Runtime Objects

Adding Environment Entries

Generating Runtime Classes

Assembling and Deploying a Web Service

A Web-Centric Application

Assembling the J2EE Application

Configuring the RI Server

Deploying the J2EE Application

Creating a Test Client

Web Service Client Features

Setting a Default Test Client for a Web Service

Testing a Web Service

Working With UDDI Registries

Generating WSDL

Managing UDDI Registry Options

Setting Default Publish Categories and Identifiers

Editing Registries Information in the IDE

Gaining Access to an External UDDI Registry

Publishing Your Web Service to a UDDI Registry

Publication Tasks and Terminology

Publication Procedure

The Internal UDDI Registry

Starting and Stopping the Internal UDDI Registry Server

Using the Sample Registry Browser

Instantiating Objects and Resolving References

Deployment Descriptors

Support for Arrays and Collections

Arrays

Collections

3. Creating a Web Service Client

Creating a Client From a Local Web Service

Creating the Client

Setting the Client's SOAP Runtime Property

Generating the Client

The Client HTML Pages and JSP Pages

The Client SOAP Proxy

Using Your Own Front End Client Components

Assembling the Client Application

Deploying and Executing the Client

Creating a Client From WSDL

Creating a Client From a UDDI Registry

Creating a Client: Planning and Implementation

Creating a Client: Procedure

The Service Endpoint URL

4. Developing XML Operations

Overview of Tools

The Data Source Pane

Input Document Elements Node

Methods Node

Executing Methods and Returning Data

Providing Parameter Values

Retrieving More or Less Data

Trimming the Data Returned to the Client

Development Work Flow

Creating XML Operations

Creating an XML Operation

Generating XML Operations From an Enterprise Bean

Editing an XML Operation

Adding a Method to an XML Operation

Adding an Input Document Element

Renaming an Input Document Element

Renaming an Output Document Element

Giving an Input Document Element a Default Value

Making an Input Document Element Permanent

Reordering a Method or Input Document Element

Deleting a Method or Input Document Element

Mapping a Method Parameter to a Source

Casting a Method Return Value

Displaying and Selecting Inherited Methods

Excluding an Element From the XML Output

Including an Element in the XML Output

Expanding a Class

Collapsing a Class

System Shared Objects

Static Utility Methods

Organizing Static Utility Methods

Using Static Utility Methods

A. Integration of C++ Shared Libraries

Tasks of the C++ Developer

Tasks of the Java Web Service Developer

Software Requirements

Customizing Your J2EE RI Installation

Installing the Shared Libraries in Your Application Server

B. Instantiating Objects and Resolving References

Specifying the Target of an Object Reference

Defining a New Target Object

Editing a Target Object Definition

C. Deployment Descriptors

Fields Propagated to Deployment Descriptors

Fields Propagated to the EJB Module Deployment Descriptor

Fields Propagated to the Web Module Deployment Descriptor

Viewing a Deployment Descriptor

Editing a Deployment Descriptor

Index