Oreilly Java And Soap

Java's resources for building SOAP-based web services are unfamiliar to many developers, and even those who are familiar with them are challenged by how rapidly they're evolving. Java and SOAP is designed for both groups of developers.Over time, SOAP development will become increasingly transparent: You'll write your Java code, and the SOAP APIs will do all the heavy lifting. But until nirvana arrives, you do need to concern yourself with encoding and interoperability issues (think .NET). So you'll really appreciate the "under the hood" information this book gives you - not just about encoding, but also about custom object types and serialization, handling errors and attachments, and many other crucial topics.Author Rob Englander also does an admirable job of preparing you for changes yet to come. For instance, while its examples are based on Apache SOAP 2.0 (and the widely used "GLUE" alternative), Englander also previews Axis, a forthcoming "from-scratch rewrite" that will make Apache SOAP more modular and flexible while offering far better performance. There's also a full chapter on Sun's brand-new Java API for XML-based RPC (JAX-RPC). Cover 1 Table of Contents 3 Dedication 5 Preface 6 Intended Audience 6 A Moment in Time 6 How This Book Is Organized 7 Conventions Used in This Book 8 How to Contact Us 9 Retrieving Examples Online 9 Acknowledgments 10 1. Introduction 11 1.1 RPC and Message-Oriented Distributed Systems 11 1.2 Self-Describing Data 12 1.3 XML 13 1.4 API Specs Versus Wire-Level Specs 13 1.5 Overview of SOAP 14 1.6 SOAP Implementations 15 1.7 The Approach 16 1.8 Getting Started 17 2. The SOAP Message 18 2.1 The HTTP Binding 18 2.2 HTTP Request 18 2.3 HTTP Response 20 2.4 The SOAP Envelope 22 2.5 The Envelope Element 25 2.6 The Header Element 25 2.7 The actor Attribute 26 2.8 The mustUnderstand Attribute 26 2.9 The encodingStyle Attribute 27 2.10 Envelope Versioning 28 2.11 The Body Element 29 2.12 SOAP Faults 29 3. SOAP Data Encoding 33 3.1 Schemas and Namespaces 33 3.2 Serialization Rules 35 3.3 Indicating Type 38 3.4 Default Values 49 3.5 The SOAP Root Attribute 50 4. RPC-Style Services 51 4.1 SOAP RPC Elements 51 4.2 A Simple Service 56 4.3 Deploying the Service 57 4.4 Writing Service Clients 67 4.5 Deploying with Request-Level Scope 75 4.6 Deploying with Session-Level Scope 76 4.7 Passing Parameters 78 5. Working with Complex Data Types 89 5.1 Passing Arrays as Parameters 89 5.2 Returning Arrays 97 5.3 Passing Custom Types as Parameters 100 5.4 Returning Custom Types 111 6. Custom Serialization 117 6.1 Custom Type Encoding 117 7. Faults and Exceptions 140 7.1 Throwing Server-Side Exceptions in Apache SOAP 140 7.2 Creating a Fault Listener in Apache SOAP 143 7.3 Throwing and Catching Exceptions in GLUE 147 8. Alternative Techniques 151 8.1 SOAP Messaging 151 8.2 Literal Encoding 161 9. SOAP Interoperability and WSDL 174 9.1 Web Services Definition Language 174 9.2 Calling a GLUE Service from an ApacheSOAP Client 183 9.3 A Proxy Service Using Apache SOAP 188 9.4 Calling an Apache SOAP Service from a GLUE Client 193 9.5 Accessing .NET Services 198 9.6 Writing an Apache Axis Client 203 10. SOAP Headers 206 10.1 Apache SOAP Providers and Routers 206 10.2 Replacing the Provider and Router Classes 207 10.3 An Apache SOAP Service That Handles SOAP Headers 211 11. JAX-RPC and JAXM 217 11.1 JAX-RPC 217 11.2 Working Without Ant 219 11.3 Creating a JAX-RPC Service 219 11.4 Creating a JAX-RPC Client 225 11.5 Generating Stubs from WSDL 226 11.6 Dynamic Invocation Interface 228 11.7 JAXM, in Less Than a Nutshell 228 11.8 What Next? 229 Colophon 230 Java and SOAP provides Java developers with an in-depth look at SOAP (the Simple Object Access Protocol). Of course, it covers the basics: what SOAP is, why it's soared to a spot on the Buzzwords' Top Ten list, and what its features and capabilities are. And it shows you how to work with some of the more common Java APIs in the SOAP world: Apache SOAP and GLUE.In addition to covering the basics such as the structure of a SOAP message, SOAP encoding, and building simple services using RPC and messaging, Java and SOAP covers many topics that are essential to real-world development. Although SOAP has native support for an impressive number of object types, the nature of modern programming means that whatever SOAP gives you is not enough. When do you need to add support for your own object types, and how do you do it? How do you handle errors, and how do you add your own information to Fault messages? How do you handle attachments?In an ideal world, you could live entirely within Java, and ignore the SOAP messages being send back and forth: you'd be able to write Java code and let the SOAP APIs work behind the scenes. However, we're not yet in that ideal world, and won't be for some time. Therefore, Java and SOAP pays particular attention to how SOAP messages are encoded. It doesn't just explain the document types, but shows how the documents are used in practice as they are generated by the different APIs. If you ever have to debug interoperability problems, you'll find that this information is indispensable.We've always found that the best software is written by people who understand what's happening under the hood. SOAP is no different. Let's say you need to write a custom serializer to create a SOAP representation of a structure. How do you know that your encoding is efficient? There's one definitive answer: look at the SOAP documents it produces!Java and SOAP also discusses interoperability between the major SOAP platforms, including Microsoft's .NET, SOAP messaging, SOAP attachments, message routing, and a preview of the forthcoming AXIS APIs and server. If you're a Java developer who would like to start working with SOAP, this is the book you need to get going. Java and SOAP provides Java developers with an in-depth look at SOAP (the Simple Object Access Protocol). Of course, it covers the what SOAP is, why it's soared to a spot on the Buzzwords' Top Ten list, and what its features and capabilities are. And it shows you how to work with some of the more common Java APIs in the SOAP Apache SOAP and GLUE. In addition to covering the basics such as the structure of a SOAP message, SOAP encoding, and building simple services using RPC and messaging, Java and SOAP covers many topics that are essential to real-world development. Although SOAP has native support for an impressive number of object types, the nature of modern programming means that whatever SOAP gives you is not enough. When do you need to add support for your own object types, and how do you do it? How do you handle errors, and how do you add your own information to Fault messages? How do you handle attachments? In an ideal world, you could live entirely within Java, and ignore the SOAP messages being send back and you'd be able to write Java code and let the SOAP APIs work behind the scenes. However, we're not yet in that ideal world, and won't be for some time. Therefore, Java and SOAP pays particular attention to how SOAP messages are encoded. It doesn't just explain the document types, but shows how the documents are used in practice as they are generated by the different APIs. If you ever have to debug interoperability problems, you'll find that this information is indispensable. We've always found that the best software is written by people who understand what's happening under the hood. SOAP is no different. Let's say you need to write a custom serializer to create a SOAP representation of a structure. How do you know that your encoding is efficient? There's one definitive look at the SOAP documents it produces! Java and SOAP also discusses interoperability between the major SOAP platforms, including Microsoft's .NET, SOAP messaging, SOAP attachments, message routing, and a preview of the forthcoming AXIS APIs and server. If you're a Java developer who would like to start working with SOAP, this is the book you need to get going. A thorough introduction for Java developers to the SOAP (Simple Object Access Protocol) for designing and implementing web services, covering both the Apache SOAP tools and IBM Web services toolkit, the use of Brazil as a small SOAP server, UDDI and WSDL, and other information exchange applications. Original. (Intermediate) Java and SOAP addresses both open source and commercial tools for use with Simple Object Access Protocol and Java. It introduces Web developers to SOAP to enable them to design and implement new Web services