|
|
|
Copyright
|
|
|
|
Preface
|
|
|
|
|
Contents of This Book
|
|
|
|
|
Related Books
|
|
|
|
|
Web Services Programming Resources Online
|
|
|
|
|
Examples Online
|
|
|
|
|
Conventions Used in This Book
|
|
|
|
|
Request for Comments
|
|
|
|
|
Acknowledgments
|
|
|
|
|
|
Part I: Introduction to the Java Web Services API
|
|
|
|
|
Chapter 1. Introduction
|
|
|
|
|
Section 1.1. What Is a Web Service?
|
|
|
|
|
Section 1.2. The SOAP Protocol
|
|
|
|
|
Section 1.3. Describing and Discovering Web Services
|
|
|
|
|
Section 1.4. J2EE Web Service APIs
|
|
|
|
|
Section 1.5. An Example Web Service
|
|
|
|
|
|
|
Chapter 2. JAX-RPC
|
|
|
|
|
Section 2.1. JAX-RPC Overview
|
|
|
|
|
Section 2.2. Programming with JAX-RPC
|
|
|
|
|
Section 2.3. Using EJBs to Implement Web Services
|
|
|
|
|
|
|
Chapter 3. SAAJ
|
|
|
|
|
Section 3.1. Introduction to SAAJ
|
|
|
|
|
Section 3.2. SAAJ Programming
|
|
|
|
|
Section 3.3. SOAP Messages
|
|
|
|
|
Section 3.4. SOAP Fault Handling
|
|
|
|
|
Section 3.5. SOAP Messages and MIME Headers
|
|
|
|
|
Section 3.6. SOAP with Attachments
|
|
|
|
|
Section 3.7. SOAP Headers
|
|
|
|
|
Section 3.8. Using SAAJ with Secure Connections
|
|
|
|
|
|
|
Chapter 4. JAXM
|
|
|
|
|
Section 4.1. JAXM Overview
|
|
|
|
|
Section 4.2. Providers and Asynchronous Messaging
|
|
|
|
|
Section 4.3. An Example JAXM Application
|
|
|
|
|
Section 4.4. JAXM Configuration
|
|
|
|
|
Section 4.5. The SOAP-RP Profile
|
|
|
|
|
Section 4.6. The ebXML Profile
|
|
|
|
|
|
|
Chapter 5. WSDL
|
|
|
|
|
Section 5.1. WSDL Overview
|
|
|
|
|
Section 5.2. WSDL Elements
|
|
|
|
|
|
|
Chapter 6. Advanced JAX-RPC
|
|
|
|
|
Section 6.1. Using WSDL with JAX-RPC
|
|
|
|
|
Section 6.2. ServiceFactory and the Service Interface
|
|
|
|
|
Section 6.3. The Dynamic Invocation Interface
|
|
|
|
|
Section 6.4. JAX-RPC and J2EE 1.4 Application Clients
|
|
|
|
|
Section 6.5. Using Attachments
|
|
|
|
|
Section 6.6. RPC-Style and Document-Style JAX-RPC
|
|
|
|
|
Section 6.7. Client and Server Context Handling
|
|
|
|
|
Section 6.8. SOAP Header Processing
|
|
|
|
|
Section 6.9. Serialization and Type Mappings
|
|
|
|
|
|
|
Chapter 7. JAXR
|
|
|
|
|
Section 7.1. UDDI and ebXML Registries
|
|
|
|
|
Section 7.2. JAXR Architecture
|
|
|
|
|
Section 7.3. Using the JAXR Examples
|
|
|
|
|
Section 7.4. JAXR Registry Model Overview
|
|
|
|
|
Section 7.5. JAXR Programming
|
|
|
|
|
|
|
Chapter 8. Web Service Tools and Configuration Files
|
|
|
|
|
Section 8.1.
wscompile
” JAX-RPC Stub and Tie Generation Utility
|
|
|
|
|
Section 8.2.
wsdeploy
” JAX-RPC Deployable Web Archive Generation Utility
|
|
|
|
|
Section 8.3. J2EEC ” Utility for Creating Stubs and Ties for a JAX-RPC Web Service
|
|
|
|
|
Section 8.4. J2EE Deploytool ” Utility for Deploying Modules and Enterprise Applications
|
|
|
|
|
Section 8.5. JAXM Client and Provider Configuration
|
|
|
|
|
Section 8.6. J2EE 1.4 Web Services Configuration File
|
|
|
|
|
Section 8.7. J2EE 1.4 JAX-RPC Mapping File
|
|
|
|
|
|
|
|
Part II: API Quick Reference
|
|
|
|
|
Chapter 9. The javax.xml.messaging Package
|
|
|
|
|
Package javax.xml.messaging
|
|
|
|
|
Endpoint
|
|
|
|
|
JAXMException
|
|
|
|
|
JAXMServlet
|
|
|
|
|
OnewayListener
|
|
|
|
|
ProviderConnection
|
|
|
|
|
ProviderConnectionFactory
|
|
|
|
|
ProviderMetaData
|
|
|
|
|
ReqRespListener
|
|
|
|
|
URLEndpoint
|
|
|
|
|
|
|
Chapter 10. The javax.xml.namespace Package
|
|
|
|
|
Package javax.xml.namespace
|
|
|
|
|
QName
|
|
|
|
|
|
|
Chapter 11. The javax.xml.registry Package
|
|
|
|
|
Package javax.xml.registry
|
|
|
|
|
BulkResponse
|
|
|
|
|
BusinessLifeCycleManager
|
|
|
|
|
BusinessQueryManager
|
|
|
|
|
CapabilityProfile
|
|
|
|
|
Connection
|
|
|
|
|
ConnectionFactory
|
|
|
|
|
DeclarativeQueryManager
|
|
|
|
|
DeleteException
|
|
|
|
|
FederatedConnection
|
|
|
|
|
FindException
|
|
|
|
|
FindQualifier
|
|
|
|
|
InvalidRequestException
|
|
|
|
|
JAXRException
|
|
|
|
|
JAXRResponse
|
|
|
|
|
LifeCycleManager
|
|
|
|
|
Query
|
|
|
|
|
QueryManager
|
|
|
|
|
RegistryException
|
|
|
|
|
RegistryService
|
|
|
|
|
SaveException
|
|
|
|
|
UnexpectedObjectException
|
|
|
|
|
UnsupportedCapabilityException
|
|
|
|
|
|
|
Chapter 12. The javax.xml.registry.infomodel Package
|
|
|
|
|
Package javax.xml.registry.infomodel
|
|
|
|
|
Association
|
|
|
|
|
AuditableEvent
|
|
|
|
|
Classification
|
|
|
|
|
ClassificationScheme
|
|
|
|
|
Concept
|
|
|
|
|
EmailAddress
|
|
|
|
|
ExtensibleObject
|
|
|
|
|
ExternalIdentifier
|
|
|
|
|
ExternalLink
|
|
|
|
|
ExtrinsicObject
|
|
|
|
|
InternationalString
|
|
|
|
|
Key
|
|
|
|
|
LocalizedString
|
|
|
|
|
Organization
|
|
|
|
|
PersonName
|
|
|
|
|
PostalAddress
|
|
|
|
|
RegistryEntry
|
|
|
|
|
RegistryObject
|
|
|
|
|
RegistryPackage
|
|
|
|
|
Service
|
|
|
|
|
ServiceBinding
|
|
|
|
|
Slot
|
|
|
|
|
SpecificationLink
|
|
|
|
|
TelephoneNumber
|
|
|
|
|
URIValidator
|
|
|
|
|
User
|
|
|
|
|
Versionable
|
|
|
|
|
|
|
Chapter 13. The javax.xml.rpc Package
|
|
|
|
|
Package javax.xml.rpc
|
|
|
|
|
Call
|
|
|
|
|
JAXRPCException
|
|
|
|
|
NamespaceConstants
|
|
|
|
|
ParameterMode
|
|
|
|
|
Service
|
|
|
|
|
ServiceException
|
|
|
|
|
ServiceFactory
|
|
|
|
|
Stub
|
|
|
|
|
|
|
Chapter 14. The javax.xml.rpc.encoding Package
|
|
|
|
|
Package javax.xml.rpc.encoding
|
|
|
|
|
DeserializationContext
|
|
|
|
|
Deserializer
|
|
|
|
|
DeserializerFactory
|
|
|
|
|
SerializationContext
|
|
|
|
|
Serializer
|
|
|
|
|
SerializerFactory
|
|
|
|
|
TypeMapping
|
|
|
|
|
TypeMappingRegistry
|
|
|
|
|
XMLType
|
|
|
|
|
|
|
Chapter 15. The javax.xml.rpc.handler Package
|
|
|
|
|
Package javax.xml.rpc.handler
|
|
|
|
|
GenericHandler
|
|
|
|
|
Handler
|
|
|
|
|
HandlerChain
|
|
|
|
|
HandlerInfo
|
|
|
|
|
HandlerRegistry
|
|
|
|
|
MessageContext
|
|
|
|
|
|
|
Chapter 16. The javax.xml.rpc.handler.soap Package
|
|
|
|
|
Package javax.xml.rpc.handler.soap
|
|
|
|
|
SOAPMessageContext
|
|
|
|
|
|
|
Chapter 17. The javax.xml.rpc.holders Package
|
|
|
|
|
Package javax.xml.rpc.holders
|
|
|
|
|
BigDecimalHolder
|
|
|
|
|
BigIntegerHolder
|
|
|
|
|
BooleanHolder
|
|
|
|
|
BooleanWrapperHolder
|
|
|
|
|
ByteArrayHolder
|
|
|
|
|
ByteHolder
|
|
|
|
|
ByteWrapperHolder
|
|
|
|
|
CalendarHolder
|
|
|
|
|
DoubleHolder
|
|
|
|
|
DoubleWrapperHolder
|
|
|
|
|
FloatHolder
|
|
|
|
|
FloatWrapperHolder
|
|
|
|
|
Holder
|
|
|
|
|
IntegerWrapperHolder
|
|
|
|
|
IntHolder
|
|
|
|
|
LongHolder
|
|
|
|
|
LongWrapperHolder
|
|
|
|
|
ObjectHolder
|
|
|
|
|
QNameHolder
|
|
|
|
|
ShortHolder
|
|
|
|
|
ShortWrapperHolder
|
|
|
|
|
StringHolder
|
|
|
|
|
|
|
Chapter 18. The javax.xml.rpc.server Package
|
|
|
|
|
Package javax.xml.rpc.server
|
|
|
|
|
ServiceLifecycle
|
|
|
|
|
ServletEndpointContext
|
|
|
|
|
|
|
Chapter 19. The javax.xml.rpc.soap Package
|
|
|
|
|
Package javax.xml.rpc.soap
|
|
|
|
|
SOAPFaultException
|
|
|
|
|
|
|
Chapter 20. The javax.xml.soap Package
|
|
|
|
|
Package javax.xml.soap
|
|
|
|
|
AttachmentPart
|
|
|
|
|
Detail
|
|
|
|
|
DetailEntry
|
|
|
|
|
MessageFactory
|
|
|
|
|
MimeHeader
|
|
|
|
|
MimeHeaders
|
|
|
|
|
Name
|
|
|
|
|
Node
|
|
|
|
|
SOAPBody
|
|
|
|
|
SOAPBodyElement
|
|
|
|
|
SOAPConnection
|
|
|
|
|
SOAPConnectionFactory
|
|
|
|
|
SOAPConstants
|
|
|
|
|
SOAPElement
|
|
|
|
|
SOAPElementFactory
|
|
|
|
|
SOAPEnvelope
|
|
|
|
|
SOAPException
|
|
|
|
|
SOAPFactory
|
|
|
|
|
SOAPFault
|
|
|
|
|
SOAPFaultElement
|
|
|
|
|
SOAPHeader
|
|
|
|
|
SOAPHeaderElement
|
|
|
|
|
SOAPMessage
|
|
|
|
|
SOAPPart
|
|
|
|
|
Text
|
|
|
|
|
|
|
Class, Method, and Field Index
|
|
|
|
|
A-G
|
|
|
|
|
H-X
|
|
|
|
|
|
|
|
Part III: Appendix
|
|
|
|
|
Appendix A. Appendix: WSDL Files for the Example Source Code
|
|
|
|
|
Section A.1. WSDL File for the Book Web Service
|
|
|
|
|
Section A.2. WSDL File for the Document-Style Book Web Service
|
|
|
|
|
|
|
|
Colophon
|
|
|
|
Index
|
