SOAP Web Service Tutorials - Herong's Tutorial Examples - Version 5.02, by Dr. Herong Yang
SAAJ SOAPMessage Structure and Classes/Interfaces
This section describes the SAAJ SOAPMessage structure, classes and interfaces that allows you to manage contents of a SOAPMessage object.
In the previous section, we learned how to create an empty SOAPMessage object. Now we want to know to insert contents into a SOAPMessage object. To do this, we need to understand the internal structure of a SOAPMessage object and what classes are used to represent different parts of a SOAPMessage object.
The high-level structure of a SOAPMessage object is well presented by this picture
from the "The Java EE 5Tutorial" book by Sun Microsystems.
This picture shows a SOAPMessage object with a SOAP message and 2 attachments represented as various objects and organized in this structure:
A SOAPMessage object - A container for a SOAP message and attachments A SOAPPart object - A container for a SOAP header and a SOAP body A SOAPEnvelope object - Represents a SOAP envelope A SOAPHeader object - Represents a SOAP header SOAP Headers A SOAPBody object - Represents a SOAP body SOAP Content A AttachmentPart object - A container for an attachment MIME Headers Content A AttachmentPart object - A container for an attachment MIME Headers Content
Interfaces listed below and their methods will allow you to manage various objects contained in a SOAPMessage object:
javax.xml.soap.SOAPPart - A class representing container for a SOAP message and attachments javax.xml.soap.AttachmentPart - A class representing a single attachment javax.xml.soap.SOAPEnvelope - An interface representing the SOAP envelope javax.xml.soap.SOAPHeader - An interface representing the SOAP header javax.xml.soap.SOAPBody - An interface representing the SOAP body
Both SOAPHeader and SOAPBody interfaces inherits org.w3c.dom.Element, org.w3c.dom.Node, and javax.xml.soap.SOAPElement interfaces, which provide more methods to help you manage contents of the SOAP header and the SOAP body.
Last update: 2009.
Table of Contents