org.apache.xmlbeans.impl.soap: abstract public class: SOAPPart

org.apache.xmlbeans.impl.soap
abstract public class: SOAPPart [javadoc | source]

java.lang.Object
   org.apache.xmlbeans.impl.soap.SOAPPart

All Implemented Interfaces:
Document

Direct Known Subclasses:
SoapPartDom

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.

Constructor:
public SOAPPart() { }

Method from org.apache.xmlbeans.impl.soap.SOAPPart Summary:
addMimeHeader, getAllMimeHeaders, getContent, getContentId, getContentLocation, getEnvelope, getMatchingMimeHeaders, getMimeHeader, getNonMatchingMimeHeaders, removeAllMimeHeaders, removeMimeHeader, setContent, setContentId, setContentLocation, setMimeHeader

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.apache.xmlbeans.impl.soap.SOAPPart Detail:
abstract public void addMimeHeader(String name, String value) Creates a `MimeHeader` object with the specified name and value and adds it to this `SOAPPart` object. If a `MimeHeader` with the specified name already exists, this method adds the specified value to the already existing value(s). Note that RFC822 headers can contain only US-ASCII characters.
abstract public Iterator getAllMimeHeaders() Retrieves all the headers for this `SOAPPart` object as an iterator over the `MimeHeader` objects.
abstract public Source getContent() throws SOAPException Returns the content of the SOAPEnvelope as a JAXP `Source` object.
public String getContentId() { String as[] = getMimeHeader("Content-Id"); if (as != null && as.length > 0) { return as[0]; } else { return null; } } Retrieves the value of the MIME header whose name is "Content-Id".
public String getContentLocation() { String as[] = getMimeHeader("Content-Location"); if (as != null && as.length > 0) { return as[0]; } else { return null; } } Retrieves the value of the MIME header whose name is "Content-Location".
abstract public SOAPEnvelope getEnvelope() throws SOAPException Gets the `SOAPEnvelope` object associated with this `SOAPPart` object. Once the SOAP envelope is obtained, it can be used to get its contents.
abstract public Iterator getMatchingMimeHeaders(String[] names) Retrieves all `MimeHeader` objects that match a name in the given array.
abstract public String[] getMimeHeader(String name) Gets all the values of the `MimeHeader` object in this `SOAPPart` object that is identified by the given `String`.
abstract public Iterator getNonMatchingMimeHeaders(String[] names) Retrieves all `MimeHeader` objects whose name does not match a name in the given array.
abstract public void removeAllMimeHeaders() Removes all the `MimeHeader` objects for this `SOAPEnvelope` object.
abstract public void removeMimeHeader(String header) Removes all MIME headers that match the given name.
abstract public void setContent(Source source) throws SOAPException Sets the content of the `SOAPEnvelope` object with the data from the given `Source` object.
public void setContentId(String contentId) { setMimeHeader("Content-Id", contentId); } Sets the value of the MIME header named "Content-Id" to the given `String`.
public void setContentLocation(String contentLocation) { setMimeHeader("Content-Location", contentLocation); } Sets the value of the MIME header "Content-Location" to the given `String`.
abstract public void setMimeHeader(String name, String value) Changes the first header entry that matches the given header name so that its value is the given value, adding a new header with the given name and value if no existing header is a match. If there is a match, this method clears all existing values for the first header that matches and sets the given value instead. If more than one header has the given name, this method removes all of the matching headers after the first one. Note that RFC822 headers can contain only US-ASCII characters.