J2EE Web Services (Paperback)

"This is the best—and most complete—description of J2EE Web services that I've seen. If you're a Java developer, you need this book."
—David Chappell, Chappell & Associates

Web services are revolutionizing the way enterprises conduct business, as they allow disparate applications to communicate and exchange business data. Now, Java 2, Enterprise Edition (J2EE™) delivers a complete Web services platform. But how do you make sense of the sea of acronyms in this emerging area? Richard Monson-Haefel comes to the rescue with this essential guide for Java developers who need to understand J2EE APIs for Web services and the Web services standards.

J2EE™ Web Services is a comprehensive guide to developing and deploying Web services using J2EE technology. Concentrating on standards sanctioned by the Web Services Interoperability Organization (WS-I) for maximum interoperability, the author delves into Web-service standards and the J2EE 1.4 Web-service APIs and components with clear and engaging discussions.

Key topics covered include:

XML (eXtensible Markup Language) and XML Schema

SOAP (Simple Object Access Protocol)

WSDL (Web Services Description Language)

UDDI (Universal Description, Discovery, and Integration)

JAX-RPC (Java API for XML-based RPC)

SAAJ (SOAP with Attachments API for Java)

JAXR (Java API for XML Registries)

JAXP (Java API for XML Processing)

The appendices complement this wealth of information with coverage of XML regular expressions, Base 64 encoding, DTDs (document type definitions), SOAP Messages with Attachments (SwA), RCP/Encoded SOAP messaging, and references to other resources. In short, this accessible reference will give Java developers the tools they need to use J2EE technologies and APIs to integrate both enterprise applications and Web-based applications.

Table of Contents

Preface.

Are Web Services Important?

What Do I Need to Know to Read This Book?

What Does This Book Cover?

How Is This Book Organized?

What Doesn't This Book Cover?

Acknowledgments.


1. An Overview of J2EE 1.4 Web Services.

The J2EE Platform.

The Technologies of Web Services.

The J2EE Web Service APIs.

Wrapping Up.

I. XML.

2. XML Basics.

XML Primer.

XML Namespaces.

Wrapping Up.

3. The W3C XML schema language.

XML Schema Basics.

Advanced XML Schema.

Wrapping Up.

II. SOAP AND WSDL.

4. SOAP.

The Basic Structure of SOAP.

SOAP Namespaces.

SOAP Headers.

The SOAP Body.

SOAP Messaging Modes.

SOAP Faults.

SOAP over HTTP.

Wrapping Up.

5. WSDL.

The Basic Structure of WSDL.

WSDL Declarations: The definitions, types, and import Elements.

The WSDL Abstract Interface: The message, portType, and operation Elements.

WSDL Messaging Exchange Patterns.

WSDL Implementation: The binding Element.

WSDL Implementation: The service and port Elements.

WS-I Conformance Claims.

Wrapping Up.

III. UDDI.

6. The UDDI Data Structures.

The businessEntity Structure.

The businessService and bindingTemplate Structures.

The tModel Structure.

The publisherAssertion Structure.

UUID Keys.

WS-I Conformance Claims.

Wrapping Up.

7. The UDDI Inquiry API.

General Information about UDDI SOAP Messaging.

The Inquiry Operations.

Wrapping Up.

8. The UDDI Publishing API.

Operation Definitions and Payloads.

Fault Messages.

Wrapping Up.

IV. JAX-RPC.

9. JAX-RPC Overview.

The Server-Side Programming Models.

The Client-Side Programming Models.

Other JAX-RPC Topics Covered.

SAAJ

Wrapping Up.

10. JAX-RPC Service Endpoints.

A Simple JSE Example.

The JSE Runtime Environment.

Multi-threading and JSEs.

Wrapping Up.

11. JAX-RPC EJB Endpoints.

An Enterprise JavaBeans Primer.

Enterprise JavaBeans Web Services.

Wrapping Up.

12. JAX-RPC Client APIs.

Generated Stubs.

Dynamic Proxies.

DII.

Wrapping Up.

13. SAAJ.

A Simple SAAJ Example.

Creating a SOAP Message.

Working with SOAP Documents.

Working with SOAP Faults.

Sending SOAP Messages with SAAJ.

SAAJ 1.2 and DOM 2.

Wrapping Up.

14. Message Handlers.

A Simple Example.

Handler Chains and Order of Processing.

The Handler Runtime Environment.

Wrapping Up.

15. Mapping Java to WSDL and XML.

Mapping WSDL to Java.

Mapping XML Schema to Java.

Holders.

Faults and Java Exceptions.

Wrapping Up.

V. JAXR.

16. Getting Started with JAXR.

Using a UDDI Test Registry.

Connecting to a UDDI Registry.

Using the RegistryService and BusinessLifeCycleManager.

The BulkResponse Type.

Exceptions.

Wrapping Up.

17. The JAXR Business Objects.

The RegistryObject Interface.

The Organization Information Object.

Wrapping Up.

18. The JAXR Technical Objects.

The Service and ServiceBinding Information Objects.

The Concept Information Object.

The SpecificationLink Information Object.

The Association Information Object.

Predefined Enumerations.

Wrapping Up.

19. The JAXR Inquiry and Publishing APIs.

Mapping JAXR to the UDDI Inquiry API.

Mapping JAXR to the UDDI Publishing API.

Wrapping Up.

VI. JAXP.

20. SAX2.

Parsing with SAX: XMLReaderFactory and XMLReader.

The ContentHandler and DefaultHandler Interfaces.

Validating with W3C XML Schema.

Wrapping Up.

21. DOM 2.

Parsing with DOM: DocumentBuilderFactory and DocumentBuilder.

Nodes.

Building a DOM Document.

Copying Nodes.

Wrapping Up.

VII. DEPLOYMENT.

22. J2EE Deployment.

Overview of the J2EE Deployment Process.

J2EE Web Services Deployment.

Deploying JSEs.

Deploying EJB Endpoints.

Service References.

Wrapping Up.

23. Web Service Descriptors.

The wsdl-file and wsdl-port Elements.

The port-component-name Element.

The service-endpoint-interface Element.

The service-impl-bean Element.

The jaxrpc-mapping-file Element.

The handler Element.

Wrapping Up.

24. JAX-RPC Mapping Files.

Conditions for a Lightweight JAX-RPC Mapping File.

A Lightweight Example.

A Heavyweight Example.

Anatomy of a Mapping File.

Wrapping Up.

VIII. INTRODUCTION.

Appendix A. XML DTDs.

Appendix B. XML Schema Regular Expressions.

Character Sets.

Quantifiers.

Other Meta-characters.

Real-World Examples.

Appendix C. Base64 Encoding.

Appendix D. SOAP RPC/Encoded.

The soap:encodingStyle Attribute.

The Operation Structs.

Simple Types.

Complex Types.

Array Types.

References.

Wrapping Up.

Appendix E. SOAP Messages with Attachments.

Understanding MIME.

Using MIME with SOAP.

Wrapping Up.

Appendix F. SAAJ Attachments.

The Java Activation Framework.

SAAJ and JAF: AttachmentPart.

The SOAPPart.

The SOAPEnvelope.

Wrapping Up.

Appendix G. JAX-RPC and SwA.

JAF Revisited: DataContentHandler and DataSource Types.

A Simple Example.

Mapping MIME Types to Java.

Using DataHandler and DataSource Types.

Wrapping Up.

Appendix H. Using JAX-RPC DII without a WSDL Document.

Bibliography.

Index.