getAttachment(SOAPElement soapelement) Returns an AttachmentPart object that is associated with an attachment that is referenced by
this SOAPElement or null if no such attachment exists.
getSOAPPart() Gets the SOAP part of this SOAPMessage object.
public void
removeAllAttachments() Removes all AttachmentPart objects that have been added to this
SOAPMessage object.
public void
removeAttachments(MimeHeaders headers) Removes all the AttachmentPart objects that have header entries that match the specified
headers.
public void
saveChanges() Updates this SOAPMessage object with all the changes that have been made to it.
This method is called automatically when a message is sent or written to by the methods
ProviderConnection.send, SOAPConnection.call, or
SOAPMessage.writeTo.
Adds the given AttachmentPart object to this SOAPMessage object. An
AttachmentPart object must be created before it can be added to a message.
Parameters: attachmentPart - an AttachmentPart object that is to become part of thisSOAPMessage object throws: IllegalArgumentException -
Gets a count of the number of attachments in this message. This count does not include the
SOAP part.
the number of AttachmentPart objects that are part of thisSOAPMessage object
Creates a new empty AttachmentPart object. Note that the method
addAttachmentPart must be called with this new AttachmentPart
object as the parameter in order for it to become an attachment to this
SOAPMessage object.
a new AttachmentPart object that can be populated and added to thisSOAPMessage object
Returns an AttachmentPart object that is associated with an attachment that is referenced by
this SOAPElement or null if no such attachment exists. References can be made via an href
attribute as described in SOAP Messages with Attachments (http://www.w3.org/TR/SOAPattachments#SOAPReferenceToAttachements)
, or via a single Text child node containing a URI as described in the WS-I Attachments
Profile 1.0 for elements of schema type ref:swaRef(ref:swaRef (http://www.wsi.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html")
). These two mechanisms must be supported. The support for references via href attribute also
implies that this method should also be supported on an element that is an xop:Include
element (XOP (http://www.w3.org/2000/xp/Group/3/06/Attachments/XOP.html) ). other reference
mechanisms may be supported by individual implementations of this standard. Contact your
vendor for details.
Parameters: element - - The SOAPElement containing the reference to an Attachment the referenced AttachmentPart or null if no such AttachmentPart exists or noreference can be found in this SOAPElement. throws: SOAPException - - if there is an error in the attempt to access the attachment
Retrieves all the AttachmentPart objects that have header entries that match the specified
headers. Note that a returned attachment could have headers in addition to those specified.
Parameters: headers - a javax.xml.soap.MimeHeaders object containing the MIME headers forwhich to search an iterator over all attachments(javax.xml.soap.AttachmentPart) that have aheader that matches one of the given headers
Retrieves a description of this SOAPMessage object's content.
a String describing the content of this message or null ifno description has been set See Also:SOAPMessageImpl.setContentDescription(String) See Also: setContentDescription(java.lang.String)
Returns all the transport-specific MIME headers for this SOAPMessage object in a
transport-independent fashion.
a MimeHeaders object containing the MimeHeader objects
Retrieves value of the specified property.
Parameters: property - the name of the property to retrieve the value of the property or null if no such property exists throws: SOAPException - if the property name is not recognized
Gets the SOAP Body contained in this SOAPMessage object.
the SOAPBody object contained by this SOAPMessage object throws: javax.xml.soap.SOAPException - if the SOAP Body does not exist or cannot be retrieved
Gets the SOAP Header contained in this SOAPMessage object.
the SOAPHeader object contained by this SOAPMessage object throws: javax.xml.soap.SOAPException - if the SOAP Header does not exist or cannot beretrieved
Removes all the AttachmentPart objects that have header entries that match the specified
headers. Note that the removed attachment could have headers in addition to those specified.
Parameters: headers - - a MimeHeaders object containing the MIME headers for which to search since: SAAJ 1.3
Updates this SOAPMessage object with all the changes that have been made to it.
This method is called automatically when a message is sent or written to by the methods
ProviderConnection.send, SOAPConnection.call, or
SOAPMessage.writeTo. However, if changes are made to a message that was received or to
one that has already been sent, the method saveChanges needs to be called
explicitly in order to save the changes. The method saveChanges also generates
any changes that can be read back (for example, a MessageId in profiles that support a
message id). All MIME headers in a message that is created for sending purposes are
guaranteed to have valid values only after saveChanges has been called.
In addition, this method marks the point at which the data from all constituent
AttachmentPart objects are pulled into the message.
throws: SOAPException - if there was a problem saving changes to this message.
Indicates whether this SOAPMessage object has had the method
SOAPMessageImpl.saveChanges() called on it.
true if saveChanges has been called on this message atleast once; false otherwise.
setContentDescription
public void setContentDescription(String description)(Code)
Sets the description of this SOAPMessage object's content with the given
description.
Parameters: description - a String describing the content of this message See Also:SOAPMessageImpl.getContentDescription() See Also: getContentDescription()
Associates the specified value with the specified property. If there was already a value
associated with this property, the old value is replaced.
The valid property names include WRITE_XML_DECLARATION and
CHARACTER_SET_ENCODING. All of these standard SAAJ properties are prefixed by
"javax.xml.soap". Vendors may also add implementation specific properties. These properties
must be prefixed with package names that are unique to the vendor.
Setting the property WRITE_XML_DECLARATION to "true" will cause an
XML Declaration to be written out at the start of the SOAP message. The default value of
"false" suppresses this declaration.
The property CHARACTER_SET_ENCODING defaults to the value "utf-8"
which causes the SOAP message to be encoded using UTF-8. Setting
CHARACTER_SET_ENCODING to "utf-16" causes the SOAP message to be
encoded using UTF-16.
Some implementations may allow encodings in addition to UTF-8 and UTF-16. Refer to your
vendor's documentation for details.
Parameters: property - the property with which the specified value is to be associated Parameters: value - the value to be associated with the specified property
Writes this SOAPMessage object to the given output stream. The externalization
format is as defined by the SOAP 1.1 with Attachments specification.
If there are no attachments, just an XML stream is written out. For those messages that
have attachments, writeTo writes a MIME-encoded byte stream.
Parameters: out - the OutputStream object to which this SOAPMessage objectwill be written throws: SOAPException - if there was a problem in externalizing this SOAP message throws: IOException - if an I/O error occurs