The container for the SOAP-specific portion of a SOAPMessage
object. All messages are required to have a SOAP part, so when a
SOAPMessage object is created, it will automatically
have a SOAPPart object.
A SOAPPart object is a MIME part and has the MIME headers
Content-Id, Content-Location, and Content-Type. Because the value of
Content-Type must be "text/xml", a SOAPPart object automatically
has a MIME header of Content-Type with its value set to "text/xml".
The value must be "text/xml" because content in the SOAP part of a
message must be in XML format. Content that is not of type "text/xml"
must be in an AttachmentPart object rather than in the
SOAPPart object.
When a message is sent, its SOAP part must have the MIME header Content-Type
set to "text/xml". Or, from the other perspective, the SOAP part of any
message that is received must have the MIME header Content-Type with a
value of "text/xml".
A client can access the SOAPPart object of a
SOAPMessage object by
calling the method SOAPMessage.getSOAPPart . The
following line of code, in which message is a
SOAPMessage object, retrieves the SOAP part of a message.
SOAPPart soapPart = message.getSOAPPart();
A SOAPPart object contains a SOAPEnvelope object,
which in turn contains a SOAPBody object and a
SOAPHeader object.
The SOAPPart method getEnvelope can be used
to retrieve the SOAPEnvelope object.
|