| 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.
| 