1. Chapter 1 Introduction

   1. RPC and Message-Oriented Distributed Systems

   2. Self-Describing Data

   3. XML

   4. API Specs Versus Wire-Level Specs

   5. Overview of SOAP

   6. SOAP Implementations

   7. The Approach

   8. Getting Started

2. Chapter 2 The SOAP Message

   1. The HTTP Binding

   2. HTTP Request

   3. HTTP Response

   4. The SOAP Envelope

   5. The Envelope Element

   6. The Header Element

   7. The actor Attribute

   8. The mustUnderstand Attribute

   9. The encodingStyle Attribute

   10. Envelope Versioning

   11. The Body Element

   12. SOAP Faults

3. Chapter 3 SOAP Data Encoding

   1. Schemas and Namespaces

   2. Serialization Rules

   3. Indicating Type

   4. Default Values

   5. The SOAP Root Attribute

4. Chapter 4 RPC-Style Services

   1. SOAP RPC Elements

   2. A Simple Service

   3. Deploying the Service

   4. Writing Service Clients

   5. Deploying with Request-Level Scope

   6. Deploying with Session-Level Scope

   7. Passing Parameters

5. Chapter 5 Working with Complex Data Types

   1. Passing Arrays as Parameters

   2. Returning Arrays

   3. Passing Custom Types as Parameters

   4. Returning Custom Types

6. Chapter 6 Custom Serialization

   1. Custom Type Encoding

7. Chapter 7 Faults and Exceptions

   1. Throwing Server-Side Exceptions in Apache SOAP

   2. Creating a Fault Listener in Apache SOAP

   3. Throwing and Catching Exceptions in GLUE

8. Chapter 8 Alternative Techniques

   1. SOAP Messaging

   2. Literal Encoding

9. Chapter 9 SOAP Interoperability and WSDL

   1. Web Services Definition Language

   2. Calling a GLUE Service from an ApacheSOAP Client

   3. A Proxy Service Using Apache SOAP

   4. Calling an Apache SOAP Service from a GLUE Client

   5. Accessing .NET Services

   6. Writing an Apache Axis Client

10. Chapter 10 SOAP Headers

    1. Apache SOAP Providers and Routers

    2. Replacing the Provider and Router Classes

    3. An Apache SOAP Service That Handles SOAP Headers

11. Chapter 11 JAX-RPC and JAXM

    1. JAX-RPC

    2. Working Without Ant

    3. Creating a JAX-RPC Service

    4. Creating a JAX-RPC Client

    5. Generating Stubs from WSDL

    6. Dynamic Invocation Interface

    7. JAXM, in Less Than a Nutshell

    8. What Next?

1. Colophon

Our look is the result of reader comments, our own experimentation, and feedback from distribution channels. Distinctive covers complement our distinctive approach to technical topics, breathing personality and life into potentially dry subjects. The animal on the cover of Java and SOAP is a red firefish, Pterois volitans. These fish are found throughout the warm, tropical waters of the Indian and Pacific Oceans at depths up to 100 feet. They tend to sit nearly motionless on the ocean floor, often under ledges, waiting for potential prey-mainly small fish and crustaceans-to wander into range.

Red firefish are members of the family Scorpaenidae-scorpionfishes-named for the poisonous spines on their dorsal fins. Confident in their ability to defend themselves, firefish often do not back off even when a human approaches; instead, they point their venomous spines towards aggressors. Their confidence is well-placed: the sting of their spines, though not usually fatal to humans, is extremely painful.

In addition to their native ocean habitat, red firefish can also be found living in many home tropical aquariums. They can grow up to 16 inches in length and so require a fairly large tank. But despite their fearsome spines and predatory nature, they're actually very peaceful and sociable, and they get along well with other fish-except the ones small enough to be eaten. Emily Quill was the production editor and copyeditor for Java and SOAP. Sarah Sherman and Matt Hutchinson provided quality control. Philip Dangler, David Chu, and Julie Flanagan provided production assistance. Ellen Troutman-Zaig wrote the index.

Emma Colby designed the cover of this book, based on a series design by Edie Freedman. The cover image is a 19th-century engraving from the Dover Pictorial Archive. Emma Colby produced the cover layout with QuarkXPress 4.1 using Adobe's ITC Garamond font.

Melanie Wang designed the interior layout, based on a series design by David Futato. Neil Walls converted the files from Microsoft Word to FrameMaker 5.5.6 using tools created by Mike Sierra. The text font is Linotype Birka; the heading font is Adobe Myriad Condensed; and the code font is LucasFont's TheSans Mono Condensed. The illustrations that appear in the book were produced by Robert Romano and Jessamyn Read using Macromedia FreeHand 9 and Adobe Photoshop 6. The tip and warning icons were drawn by Christopher Bing. This colophon was written by Leanne Soylemez.