book

J2EE™ Web Services

Name: J2EE™ Web Services
Author: Richard Monson-Haefel
ISBN: 0321146182

by Richard Monson-Haefel

October 2003

Intermediate to advanced

928 pages

20h 4m

English

Addison-Wesley Professional

Read now

Unlock full access

Copyright
Dedication
Praise for J2EE™ Web Services
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?Non-Web Service Aspects of the J2EE PlatformVendor-Specific Configuration and AdministrationOther Web Service “Standards”
Acknowledgments
1. An Overview of J2EE 1.4 Web Services
1.1. The J2EE Platform1.2. The Technologies of Web Services1.2.1. WS-I Basic Profile 1.01.2.2. XML1.2.3. SOAP1.2.4. WSDL1.2.5. UDDI1.3. The J2EE Web Service APIs1.3.1. JAX-RPC1.3.2. SAAJ1.3.3. JAXR1.3.4. JAXP1.4. Wrapping Up
I. XML
2. XML Basics
2.1. XML Primer2.1.1. XML Document Instance2.1.2. Anatomy of an XML Document2.1.2.1. XML Declaration2.1.2.2. Elements2.1.2.3. Attributes2.1.2.4. Comments2.1.2.5. CDATA Section2.1.3. Processing XML Documents2.2. XML Namespaces2.2.1. An Example of Using Namespaces2.2.2. Default Namespaces, Prefixes, and Qualified Names2.3. Wrapping Up
3. The W3C XML Schema Language
3.1. XML Schema Basics3.1.1. Why XML Schema Is Preferred to DTDs in Web Services3.1.2. The XML Schema Document3.1.3. Simple Types3.1.4. Complex Types3.1.4.1. Sequences of Elements3.1.4.2. Attributes3.1.4.3. Occurrence Constraints3.1.4.4. The all Element3.1.5. Declaring Global Elements in a Schema3.1.6. Qualified and Unqualified Elements3.1.7. Assigning and Locating Schemas3.2. Advanced XML Schema3.2.1. Inheritance of Complex Types3.2.1.1. Extension3.2.1.2. Restriction3.2.1.3. Polymorphism and Abstract Base Types3.2.1.4. Abstract and Final Complex Types3.2.2. Inheritance of Simple Types3.2.2.1. The pattern Facet3.2.2.2. The enumeration Facet3.2.3. List and Union Types3.2.3.1. List Types3.2.3.2. Union Types3.2.4. Anonymous Types3.2.5. Importing and Including Schemas3.2.5.1. Importing3.2.5.2. Including3.3. Wrapping Up
II. SOAP and WSDL
4. SOAP
4.1. The Basic Structure of SOAP4.2. SOAP Namespaces4.3. SOAP Headers4.3.1. The actor Attribute4.3.2. The mustUnderstand Attribute4.3.3. The WS-I Conformance Header Block4.3.4. Final Words about Headers4.4. The SOAP Body4.5. SOAP Messaging Modes4.5.1. Document/Literal4.5.2. RPC/Literal4.5.3. Messaging Modes versus Messaging Exchange Patterns4.5.4. Other Messaging Modes4.6. SOAP Faults4.6.1. The faultcode Element4.6.1.1. The Client Fault4.6.1.2. The Server Fault4.6.1.3. The VersionMismatch Fault4.6.1.4. The MustUnderstand Fault4.6.1.5. Non-standard SOAP Fault Codes4.6.2. The faultstring Element4.6.3. The faultactor Element4.6.4. The detail Element4.6.4.1. Processing Header Faults: Omitting the detail Element4.6.5. Final Words about Faults4.7. SOAP over HTTP4.7.1. Transmitting SOAP with HTTP POST Messages4.7.2. HTTP Response Codes4.7.2.1. Success Codes4.7.2.2. Error Codes4.7.3. Final Words about HTTP4.8. Wrapping Up

5. WSDL
5.1. The Basic Structure of WSDL5.2. WSDL Declarations: The definitions, types, and import Elements5.2.1. The XML Declaration5.2.2. The definitions Element5.2.3. The types Element5.2.4. The import Element5.3. The WSDL Abstract Interface: The message, portType, and operation Elements5.3.1. The message Element5.3.1.1. The message Element for RPC-Style Web Services5.3.1.2. The message Element for Document-Style Web Services5.3.1.3. Declaring Fault Messages5.3.2. The portType Element5.3.3. The operation Element5.3.3.1. Parameter Order within an Operation5.3.3.2. Operation Overloading5.4. WSDL Messaging Exchange Patterns5.4.1. Request/Response Messaging5.4.2. One-Way Messaging5.4.3. Notification and Solicit/Response Messaging5.5. WSDL Implementation: The binding Element5.5.1. SOAP Binding5.5.1.1. The soapbind:binding Element5.5.1.2. The soapbind:operation Element5.5.1.3. The soapbind:body Element5.5.1.4. The soapbind:fault Element5.5.1.5. The soapbind:header Element5.5.1.6. The soapbind:headerfault Element5.6. WSDL Implementation: The service and port Elements5.6.1. The soapbind:address Element5.7. WS-I Conformance Claims5.8. Wrapping Up
III. UDDI
6. The UDDI Data Structures
6.1. The businessEntity Structure6.1.1. The businessEntity Element and the businessKey Attribute6.1.2. The discoveryURL Element6.1.3. The name Element6.1.4. The description Element6.1.5. The contacts Element6.1.6. The businessServices Element6.1.7. The identifierBag Element6.1.7.1. The D-U-N-S Identification System6.1.7.2. The Thomas Register Identification System6.1.8. The categoryBag Element6.1.8.1. The NAICS Category System6.1.8.2. The UNSPSC Category System6.1.8.3. The ISO 3166 Geographic Locator System6.1.8.4. Other Categorizations6.1.8.4.1. tModel-Based Categorizations6.1.8.4.2. General Keyword Categorizations6.2. The businessService and bindingTemplate Structures6.2.1. The businessService Structure6.2.1.1. The categoryBag Element6.2.1.2. The bindingTemplates Element6.2.2. The bindingTemplate Structure6.2.2.1. The accessPoint Element6.2.2.2. The hostingRedirector Element6.2.2.3. The tModelInstanceDetails and tModelInstanceInfo Elements6.3. The tModel Structure6.3.1. tModels for WSDL Documents6.3.2. tModels as Taxonomy Identifiers6.3.3. The uddi-org:types tModel6.3.4. Checked and Unchecked tModels6.3.5. The tModel XML Schema6.3.5.1. The name and description Elements6.3.5.2. The overviewDoc Element6.3.5.3. The identifierBag and categoryBag Elements6.4. The publisherAssertion Structure6.5. UUID Keys6.6. WS-I Conformance Claims6.7. Wrapping Up
7. The UDDI Inquiry API
7.1. General Information about UDDI SOAP MessagingIBMMicrosoftSAPNTT7.2. The Inquiry Operations7.2.1. Find Operations7.2.1.1. Using Search Elements7.2.1.1.1. The identifierBag and categoryBag Search Elements7.2.1.1.2. The name Search Element7.2.1.1.3. The tModelBag Search Element7.2.1.1.4. The findQualifiers Search Element7.2.1.2. Operation Definitions and Payloads7.2.1.2.1. xxxInfos Response Structures7.2.1.2.2. The find_business OperationType DefinitionsWSDL message and portType Definitions7.2.1.2.3. The find_relatedBusinesses OperationType DefinitionsWSDL message and portType Definitions7.2.1.2.4. The find_service OperationType DefinitionsWSDL message and portType Definitions7.2.1.2.5. The find_binding OperationType DefinitionsWSDL message and portType Definitions7.2.1.2.6. The find_tModel OperationType DefinitionsWSDL message and portType Definitions7.2.2. Get Operations7.2.2.1. The get_businessDetail OperationType DefinitionsWSDL message and portType Definitions7.2.2.2. The get_businessDetailExt OperationType DefinitionsWSDL message and portType Definitions7.2.2.3. The get_serviceDetail OperationType DefinitionsWSDL message and portType Definitions7.2.2.4. The get_bindingDetail OperationType DefinitionsWSDL message and portType Definitions7.2.2.5. The get_tModelDetail OperationType DefinitionsWSDL message and portType Definitions7.3. Wrapping Up
8. The UDDI Publishing API
8.1. Operation Definitions and Payloads8.1.1. Authorization Operations8.1.1.1. The get_authToken OperationType DefinitionsWSDL message and portType Definitions8.1.1.2. The discard_authToken OperationType DefinitionsWSDL message and portType Definitions8.1.2. Save Operations8.1.2.1. The save_business OperationType DefinitionsWSDL message and portType Definitions8.1.2.2. The save_service OperationType DefinitionsWSDL message and portType Definitions8.1.2.3. The save_binding OperationType DefinitionsWSDL message and portType Definitions8.1.2.4. The save_tModel OperationType DefinitionsWSDL message and portType Definitions8.1.2.5. The add_publisherAssertions OperationType DefinitionsWSDL message and portType Definitions8.1.2.6. The set_publisherAssertions OperationType DefinitionsWSDL message and portType Definitions8.1.3. Delete Operations8.1.3.1. The delete_business OperationType DefinitionsWSDL message and portType Definitions8.1.3.2. The delete_service OperationType DefinitionsWSDL message and portType Definitions8.1.3.3. The delete_binding OperationType DefinitionsWSDL message and portType Definitions8.1.3.4. The delete_tModel OperationType DefinitionsWSDL message and portType Definitions8.1.3.5. The delete_publisherAssertions OperationType DefinitionsWSDL message and portType Definitions8.1.4. Get Operations8.1.4.1. The get_assertionStatusReport OperationType DefinitionsWSDL message and portType Definitions8.1.4.2. The get_publisherAssertions OperationType DefinitionsWSDL message and portType Definitions8.1.4.3. The get_registeredInfo OperationType DefinitionsWSDL message and portType Definitions8.2. Fault Messages8.3. Wrapping Up
IV. JAX-RPC
9. JAX-RPC Overview
9.1. The Server-Side Programming Models9.1.1. JAX-RPC Service Endpoint9.1.2. Enterprise JavaBeans Endpoints9.2. The Client-Side Programming Models9.2.1. Generated Stubs9.2.2. Dynamic Proxies9.2.3. DII9.3. Other JAX-RPC Topics Covered9.4. SAAJ9.5. Wrapping Up
10. JAX-RPC Service Endpoints
10.1. A Simple JSE Example10.2. The JSE Runtime Environment10.2.1. Servlets: The Foundation of JSE10.2.2. JNDI Environment Naming Context10.2.3. The ServletEndpointContext and ServiceLifecycle Interfaces10.2.3.1. Using the Life-Cycle Methods init() and destroy()10.2.3.2. Using the ServletEndpointContext Interface10.2.3.2.1. The getUserPrincipal() and isUserInRole() Methods10.2.3.2.2. The getHttpSession() Method10.2.3.2.3. The getServletContext() Method10.2.3.2.4. The getMessageContext() Method10.3. Multi-threading and JSEs10.4. Wrapping Up
11. JAX-RPC EJB Endpoints
11.1. An Enterprise JavaBeans Primer11.1.1. Transactions in a Nutshell11.1.2. Understanding EJB11.1.2.1. What Is EJB?11.1.2.2. Why Use EJB?11.1.2.3. RPC Components: Stateless, Stateful, and Entity Beans11.1.2.4. Asynchronous Components: The Message-Driven Bean11.1.2.5. The EJB Container System11.1.3. Where to Go from Here11.2. Enterprise JavaBeans Web Services11.2.1. A Simple Example11.2.1.1. The Endpoint Interface11.2.1.2. The Bean Class11.2.1.3. Deployment Descriptors and Packaging11.2.2. The EJB Runtime Environment11.2.2.1. The JNDI Environment Naming Context11.2.2.2. The SessionBean Interface11.2.2.3. The SessionContext11.3. Wrapping Up
12. JAX-RPC Client APIs
12.1. Generated Stubs12.1.1. The Endpoint Interface12.1.2. The Generated Stub12.1.3. Service Interfaces12.1.4. Using a Generated Stub in J2EE12.2. Dynamic Proxies12.2.1. Using a Dynamic Proxy12.2.2. Under the Covers12.3. DII12.3.1. Using DII with a WSDL Document12.3.2. Using DII without a WSDL Document12.3.3. Using One-Way Messaging with DII12.3.4. JAX-RPC Standard Properties and Constants12.4. Wrapping Up
13. SAAJ
13.1. A Simple SAAJ Example13.2. Creating a SOAP Message13.2.1. The MessageFactory Class13.2.1.1. The newInstance() Method13.2.1.2. The createMessage() Method13.2.1.3. The createMessage Method with Parameters13.2.2. SaajOutputter Classes13.2.3. The SOAPMessage Class13.2.3.1. The writeTo() Method13.2.3.2. The getSOAPBody() and getSOAPHeader() Methods13.2.3.3. The getProperty() and setProperty() Methods13.3. Working with SOAP Documents13.3.1. The SOAPPart and SOAPEnvelope Types13.3.2. The SOAPFactory Class and Name Types13.3.3. The SOAPElement Type13.3.4. The Node Type13.3.5. The SOAPHeader Type13.3.6. The SOAPHeaderElement Type13.3.7. The SOAPBody Type13.3.8. The SOAPBodyElement Type13.3.9. The Text Type13.3.10. The SOAPConstants Class13.3.11. The SOAPException Class13.3.12. The SOAPFactory and SOAPElement Types13.4. Working with SOAP Faults13.4.1. The SOAPFault Type13.4.2. The Detail Type13.4.3. The SOAPFaultElement Type13.4.4. The DetailEntry Type13.5. Sending SOAP Messages with SAAJ13.6. SAAJ 1.2 and DOM 213.7. Wrapping Up
14. Message Handlers
14.1. A Simple Example14.1.1. Defining a Message-Handler Class14.1.2. Defining a WSDL Document14.1.3. Generating the Service and Endpoint Interfaces14.1.4. Configuring Message Handlers14.1.5. Using Message Handlers in a J2EE Component14.2. Handler Chains and Order of Processing14.2.1. Return Values and Order of Processing14.2.2. Exceptions and Order of Processing14.2.2.1. The SOAPFaultException Type14.2.2.2. The JAXRPCException Type14.3. The Handler Runtime Environment14.3.1. Statelessness and Multi-threading14.3.2. JNDI Environment Naming Context14.3.3. A Message Handler's Life Cycle14.3.4. The MessageContext Type14.4. Wrapping Up
15. Mapping Java to WSDL and XML
15.1. Mapping WSDL to Java15.1.1. WSDL-to-Endpoint Interfaces15.1.2. Declaring Multiple Parts15.1.3. Defining Multiple Operations15.1.4. One-Way Messaging15.2. Mapping XML Schema to Java15.2.1. XML Schema Built-in Simple Types15.2.2. XML Schema Complex Types15.2.3. Arrays15.2.4. Enumerations15.2.5. SOAPElement: Supporting Non-standard Types in Document/Literal Encoding15.2.6. SOAPElement: The xsd:any Element15.2.7. Nillable Elements15.3. Holders15.3.1. Pass-by-Copy: IN Parameters15.3.2. Pass-by-Reference: INOUT and OUT Parameters15.3.3. Holders: Supporting INOUT and OUT Parameters in JAX-RPC15.3.4. Mapping Holder Types from WSDL15.3.4.1. Examples15.3.4.2. Rules for Mapping parts to Method Parameters15.3.4.3. Standard Holder Types15.3.4.4. Generated Holder Types15.4. Faults and Java Exceptions15.4.1. WSDL Faults and Application Exceptions15.5. Wrapping Up
V. JAXR
16. Getting Started with JAXR
16.1. Using a UDDI Test Registry16.2. Connecting to a UDDI Registry16.2.1. Obtaining a ConnectionFactory16.2.2. Configuring the ConnectionFactoryIBMMicrosoftSAPNTT16.2.3. Connecting to the UDDI Registry16.2.4. Authenticating to a UDDI Registry16.2.5. Obtaining a JAXR Connection in J2EE16.3. Using the RegistryService and BusinessLifeCycleManager16.3.1. The RegistryService Interface16.3.2. Using the BusinessLifeCycleManager16.3.2.1. The LifeCycleManager Interface16.3.2.2. The BusinessLifeCycleManager Interface16.4. The BulkResponse Type16.4.1. The BulkResponse Interface16.4.2. Handling the BulkResponse in Examples16.5. Exceptions16.6. Wrapping Up
17. The JAXR Business Objects
17.1. The RegistryObject Interface17.1.1. The UUID Key17.1.1.1. Understanding UUIDs17.1.1.2. The Key Interface17.2. The Organization Information Object17.2.1. businessEntity17.2.2. ExternalLinks17.2.2.1. The ExternalLink Information Object17.2.3. Name and Description17.2.3.1. The InternationalString Interface17.2.3.2. The LocalizedString Interface17.2.3.3. Working with InternationalString Objects17.2.4. User17.2.4.1. Creating a New User Object17.2.4.2. Setting a Person's Name17.2.4.3. Adding Descriptions17.2.4.4. Adding E-Mail Addresses17.2.4.5. Adding Phone Numbers17.2.4.6. Adding a Postal Address17.2.5. Classification17.2.5.1. The Standard UDDI Classifications17.2.5.1.1. The BusinessQueryManager Object17.2.5.1.2. Adding Standard UDDI Classifications to an OrganizationNAICSUNSPSCISO 316617.2.5.2. The Classification Interface17.2.5.3. The ClassificationScheme Interface17.2.5.4. Reading Classification and ClassificationScheme Objects17.2.6. ExternalIdentifiers17.2.6.1. Managing External Identifiers17.2.6.2. The ExternalIdentifier Interface17.2.7. Services17.3. Wrapping Up
18. The JAXR Technical Objects
18.1. The Service and ServiceBinding Information Objects18.1.1. Creating a New Service Object18.1.2. Creating a New ServiceBinding Object18.1.3. The Service Interface18.1.4. The ServiceBinding Interface18.2. The Concept Information Object18.2.1. Creating a New Concept18.2.1.1. Create a Concept Instance18.2.1.2. Set the Concept Name18.2.1.3. Set the Overview Document18.2.1.4. Assign the wsdlSpec Classification18.2.1.5. Assign the WS-I Conformance Claim18.2.1.6. Save the Concept Object18.2.2. The Concept Interface18.2.2.1. Concept Methods and Taxonomy Browsing18.2.2.2. RegistryObject Methods and WSDL Concepts18.3. The SpecificationLink Information Object18.3.1. Using SpecificationLink Objects18.3.1.1. Create a Service and a ServiceBinding18.3.1.2. Create a SpecificationLink18.3.2. The SpecificationLink Interface18.4. The Association Information Object18.4.1. Creating an Association18.4.1.1. Find the Concept Object Representing the Association Type18.4.1.2. Create an Association Instance18.4.1.3. Save the Association18.5. Predefined Enumerations18.5.1. The AssociationType Enumeration18.5.2. The URLType Enumeration18.5.3. The ExtensibleObject and Slot Interfaces18.6. Wrapping Up
19. The JAXR Inquiry and Publishing APIs
19.1. Mapping JAXR to the UDDI Inquiry API19.1.1. Using Search Criteria19.1.1.1. The namePattern Criteria19.1.1.2. The classifications Criteria19.1.1.3. The externalIdentifiers Criteria19.1.1.4. The specifications Criteria19.1.1.5. The externalLinks Criteria19.1.1.6. The findQualifiers Criteria19.1.2. The findXXX() Methods19.1.2.1. The findAssociations() Method19.1.2.2. The findCallerAssociations() Method19.1.2.3. The findOrganizations() Method19.1.2.4. The findServices() Method19.1.2.5. The findServiceBindings() Method19.1.2.6. The findClassificationSchemes() Method19.1.2.7. The findClassificationSchemeByName() Method19.1.2.8. The findConcepts() Method19.1.2.9. The findConceptByPath() Method19.2. Mapping JAXR to the UDDI Publishing API19.3. Wrapping Up
VI. JAXP
20. SAX2
20.1. Parsing with SAX: XMLReaderFactory and XMLReader20.2. The ContentHandler and DefaultHandler Interfaces20.2.1. The startDocument() and endDocument() Methods20.2.2. The startElement() and endElement() Methods20.2.3. The startPrefixMapping() and endPrefixMapping() Methods20.2.4. The characters() Method20.2.5. Other ContentHandler Methods20.2.6. Other SAX2 Listener Interfaces20.3. Validating with W3C XML Schema20.4. Wrapping Up
21. DOM 2
21.1. Parsing with DOM: DocumentBuilderFactory and DocumentBuilder21.2. Nodes21.2.1. Type-Dependent Properties21.2.2. XML Name Methods21.2.3. Attribute Methods21.2.4. The Owner Document21.2.5. Navigating a Node Tree21.2.6. Methods for Child Management21.2.7. Other Methods21.3. Building a DOM Document21.4. Copying Nodes21.5. Wrapping Up
VII. Deployment
22. J2EE Deployment
22.1. Overview of the J2EE Deployment Process22.2. J2EE Web Services Deployment22.2.1. Starting with a J2EE Endpoint22.2.2. Starting with WSDL22.2.3. JAX-RPC Mapping Files22.2.4. Deployment Descriptors for J2EE Components22.3. Deploying JSEs22.3.1. Packaging JSEs in a WAR File22.3.2. The web.xml File22.3.2.1. Configuring the ServletContext22.3.2.2. Configuring the JNDI ENC22.3.2.3. Configuring Other Aspects of a JSE22.4. Deploying EJB Endpoints22.4.1. Declarative Transaction Attributes22.4.2. Declarative Security Attributes22.5. Service References22.5.1. The service-ref-name Element22.5.2. The service-interface Element22.5.3. The wsdl-file and service-qname Elements22.5.4. The jaxrpc-mapping-file Element22.5.5. The port-component-ref Element22.5.6. The Display Elements22.5.7. The handler Element22.5.7.1. The handler-name Element22.5.7.2. The handler-class Element22.5.7.3. The init-param Elements22.5.7.4. The soap-header Elements22.5.7.5. The soap-role Elements22.5.7.6. The port-name Element22.5.7.7. Proper Processing by Handlers22.5.7.8. The Handler Display Elements22.6. Wrapping Up
23. Web Service Descriptors
23.1. The wsdl-file and wsdl-port Elements23.2. The port-component-name Element23.3. The service-endpoint-interface Element23.4. The service-impl-bean Element23.5. The jaxrpc-mapping-file Element23.6. The handler Element23.6.1. The handler-name Element23.6.2. The handler-class Element23.6.3. The init-param Elements23.6.4. The soap-header Elements23.6.5. The soap-role Elements23.6.6. Proper Processing by Handlers23.6.7. The Display Elements23.7. Wrapping Up
24. JAX-RPC Mapping Files
24.1. Conditions for a Lightweight JAX-RPC Mapping File24.2. A Lightweight Example24.3. A Heavyweight Example24.4. Anatomy of a Mapping File24.4.1. The java-wsdl-mapping Element24.4.2. The package-mapping Element24.4.3. The java-xml-type-mapping Element24.4.4. The exception-mapping Element24.4.5. The service-interface-mapping Element24.4.6. The service-endpoint-interface-mapping Element24.5. Wrapping Up
Appendices
A. XML DTDs
B. XML Schema Regular Expressions
B.1. Character SetsB.2. QuantifiersB.3. Other Meta-charactersB.4. Real-World ExamplesB.4.1. ISBN (International Standard Book Number)B.4.2. United States Zip CodeB.4.3. United States Phone NumberB.4.4. United Kingdom Postal Code
C. Base64 Encoding
D. SOAP RPC/Encoded
D.1. The soap:encodingStyle AttributeD.2. The Operation StructsD.3. Simple TypesD.4. Complex TypesD.5. Array TypesD.5.1. Array SizeD.5.2. Other Features of ArraysD.6. ReferencesD.7. Wrapping Up
E. SOAP Messages with Attachments
E.1. Understanding MIMEE.2. Using MIME with SOAPE.3. Wrapping Up
F. SAAJ Attachments
F.1. The Java Activation FrameworkF.1.1. DataHandlerF.1.2. DataContentHandlerF.1.3. DataSourceF.2. SAAJ and JAF: AttachmentPartF.2.1. Data ObjectsF.2.2. The createAttachmentPart() MethodF.2.3. The setContent() and setDataHandler() MethodsF.2.4. The getContent() MethodF.2.5. The MIME Header MethodsF.3. The SOAPPartF.3.1. XSLTF.3.2. TrAXF.3.3. Using a StreamSourceF.3.4. DOMSourceF.3.5. SAXSourceF.4. The SOAPEnvelopeF.4.1. The getHeader(), getBody(), addHeader(), and addBody() MethodsF.4.2. The createName() MethodF.5. Wrapping Up
G. JAX-RPC and SwA
G.1. JAF Revisited: DataContentHandler and DataSource TypesG.2. A Simple ExampleG.3. Mapping MIME Types to JavaG.3.1. The multipart/* MIME TypeG.3.2. The text/xml and application/xml MIME TypesG.3.3. MIME Attachments as Return Types, and INOUT and OUT ParametersG.4. Using DataHandler and DataSource TypesG.5. Wrapping Up
H. Using JAX-RPC DII without a WSDL Document
Bibliography
Web Services SpecificationsXMLSOAPWSDLUDDIJ2EE 1.4 SpecificationsWeb ServicesMiscellaneous SpecificationsBooks
Credits

Content preview from J2EE™ Web Services

Appendix E. SOAP Messages with Attachments

A SOAP message is an XML document, which is essentially just text. Unicode characters are the only kind of data that can be exchanged using SOAP. This restriction is not a problem in most cases, because W3C's XML schema allows us to exchange a fairly rich set of typed data: int, double, date, and so on. In some cases, however, you may need to convey binary data in SOAP messages. For example, you may want to send a SOAP message that contains a JPEG image or a document that uses a proprietary format such as PDF. SOAP Messages with Attachments (SwA) provides a mechanism to “attach” binary data to a SOAP message without converting binary data to ASCII characters using Base64 encoding.

SwA is certainly one ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 0321146182Purchase book

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

J2EE™ Web Services

by Richard Monson-Haefel

Appendix E. SOAP Messages with Attachments

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.