org.jboss.ws.core.soap

Class SOAPMessageImpl

java.lang.Object

javax.xml.soap.SOAPMessage

org.jboss.ws.core.soap.SOAPMessageImpl

public class SOAPMessageImpl
extends SOAPMessage

The root class for all SOAP messages. As transmitted on the "wire", a SOAP message is an XML document or a MIME message whose first body part is an XML/SOAP document.

Author:

Thomas.Diesler@jboss.org, Jason T. Greene

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SOAPMessageImpl.MimeMatchingAttachmentsIterator

Field Summary

Fields inherited from class javax.xml.soap.SOAPMessage

CHARACTER_SET_ENCODING, WRITE_XML_DECLARATION

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttachmentPart(AttachmentPart part) Adds the given AttachmentPart object to this SOAPMessage object.
int	countAttachments() Gets a count of the number of attachments in this message.
AttachmentPart	createAttachmentPart() Creates a new empty AttachmentPart object.
String	decode(String cid)
AttachmentPart	getAttachment(SOAPElement element) Returns an AttachmentPart object that is associated with an attachment that is referenced by this SOAPElement or null if no such attachment exists.
AttachmentPart	getAttachmentByContentId(String cid)
AttachmentPart	getAttachmentByPartName(String partName)
Iterator	getAttachments() Retrieves all the AttachmentPart objects that are part of this SOAPMessage object.
Iterator	getAttachments(MimeHeaders headers) Retrieves all the AttachmentPart objects that have header entries that match the specified headers.
String	getContentDescription() Retrieves a description of this SOAPMessage object's content.
MimeHeaders	getMimeHeaders() Returns all the transport-specific MIME headers for this SOAPMessage object in a transport-independent fashion.
OperationMetaData	getOperationMetaData(EndpointMetaData epMetaData) Get the operation meta data for this SOAP message
Object	getProperty(String property) Retrieves value of the specified property.
SOAPBody	getSOAPBody() Gets the SOAP Body contained in this SOAPMessage object.
SOAPHeader	getSOAPHeader() Gets the SOAP Header contained in this SOAPMessage object.
SOAPPart	getSOAPPart() Gets the SOAP part of this SOAPMessage object.
void	prepareForDOMAccess()
void	removeAllAttachments() Removes all AttachmentPart objects that have been added to this SOAPMessage object.
AttachmentPart	removeAttachmentByContentId(String cid)
void	removeAttachments(MimeHeaders headers) Removes all the AttachmentPart objects that have header entries that match the specified headers.
void	saveChanges() Updates this SOAPMessage object with all the changes that have been made to it.
boolean	saveRequired() Indicates whether this SOAPMessage object needs to have the method saveChanges called on it.
void	setAttachments(Collection<AttachmentPart> parts)
void	setContentDescription(String description) Sets the description of this SOAPMessage object's content with the given description.
void	setMimeHeaders(MimeHeaders headers)
void	setProperty(String property, Object value) Associates the specified value with the specified property.
void	writeTo(OutputStream outs) Writes this SOAPMessage object to the given output stream.

Methods inherited from class javax.xml.soap.SOAPMessage

createAttachmentPart, createAttachmentPart

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getProperty

public Object getProperty(String property)
                   throws SOAPException

Description copied from class: SOAPMessage

Retrieves value of the specified property.

Overrides:

getProperty in class SOAPMessage

Parameters:

property - the name of the property to retrieve

Returns:

the value associated with the named property or null if no such property exists.

Throws:

SOAPException - if the property name is not recognized.

setProperty

public void setProperty(String property,
               Object value)
                 throws SOAPException

Description copied from class: SOAPMessage

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 SOAPMessage.WRITE_XML_DECLARATION and SOAPMessage.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.

Overrides:

setProperty in class SOAPMessage

Parameters:

property - the property with which the specified value is to be associated.

value - the value to be associated with the specified property

Throws:

SOAPException - if the property name is not recognized.

getSOAPBody

public SOAPBody getSOAPBody()
                     throws SOAPException

Description copied from class: SOAPMessage

Gets the SOAP Body contained in this SOAPMessage object.

Overrides:

getSOAPBody in class SOAPMessage

Returns:

the SOAPBody object contained by this SOAPMessage object

Throws:

SOAPException - if the SOAP Body does not exist or cannot be retrieved

getSOAPHeader

public SOAPHeader getSOAPHeader()
                         throws SOAPException

Description copied from class: SOAPMessage

Gets the SOAP Header contained in this SOAPMessage object.

Overrides:

getSOAPHeader in class SOAPMessage

Returns:

the SOAPHeader object contained by this SOAPMessage object

Throws:

SOAPException - if the SOAP Header does not exist or cannot be retrieved

setAttachments

public void setAttachments(Collection<AttachmentPart> parts)
                    throws SOAPException

Throws:

SOAPException

addAttachmentPart

public void addAttachmentPart(AttachmentPart part)

Description copied from class: SOAPMessage

Adds the given AttachmentPart object to this SOAPMessage object. An AttachmentPart object must be created before it can be added to a message.

Specified by:

addAttachmentPart in class SOAPMessage

Parameters:

part - an AttachmentPart object that is to become part of this SOAPMessage object

getAttachmentByContentId

public AttachmentPart getAttachmentByContentId(String cid)
                                        throws SOAPException

Throws:

SOAPException

decode

public String decode(String cid)

removeAttachmentByContentId

public AttachmentPart removeAttachmentByContentId(String cid)

getAttachmentByPartName

public AttachmentPart getAttachmentByPartName(String partName)

createAttachmentPart

public AttachmentPart createAttachmentPart()

Description copied from class: SOAPMessage

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.

Specified by:

createAttachmentPart in class SOAPMessage

Returns:

a new AttachmentPart object that can be populated and added to this SOAPMessage object

getContentDescription

public String getContentDescription()

Description copied from class: SOAPMessage

Retrieves a description of this SOAPMessage object's content.

Specified by:

getContentDescription in class SOAPMessage

Returns:

a String describing the content of this message or null if no description has been set

See Also:

SOAPMessage.setContentDescription(java.lang.String)

setContentDescription

public void setContentDescription(String description)

Description copied from class: SOAPMessage

Sets the description of this SOAPMessage object's content with the given description.

Specified by:

setContentDescription in class SOAPMessage

Parameters:

description - a String describing the content of this message

See Also:

SOAPMessage.getContentDescription()

getMimeHeaders

public MimeHeaders getMimeHeaders()

Description copied from class: SOAPMessage

Returns all the transport-specific MIME headers for this SOAPMessage object in a transport-independent fashion.

Specified by:

getMimeHeaders in class SOAPMessage

Returns:

a MimeHeaders object containing the MimeHeader objects

setMimeHeaders

public void setMimeHeaders(MimeHeaders headers)

getSOAPPart

public SOAPPart getSOAPPart()

Description copied from class: SOAPMessage

Gets the SOAP part of this SOAPMessage object.

SOAPMessage object contains one or more attachments, the SOAP Part must be the first MIME body part in the message.

Specified by:

getSOAPPart in class SOAPMessage

Returns:

the SOAPPart object for this SOAPMessage object

removeAllAttachments

public void removeAllAttachments()

Description copied from class: SOAPMessage

Removes all AttachmentPart objects that have been added to this SOAPMessage object.

This method does not touch the SOAP part.

Specified by:

removeAllAttachments in class SOAPMessage

countAttachments

public int countAttachments()

Description copied from class: SOAPMessage

Gets a count of the number of attachments in this message. This count does not include the SOAP part.

Specified by:

countAttachments in class SOAPMessage

Returns:

the number of AttachmentPart objects that are part of this SOAPMessage object

getAttachments

public Iterator getAttachments()

Description copied from class: SOAPMessage

Retrieves all the AttachmentPart objects that are part of this SOAPMessage object.

Specified by:

getAttachments in class SOAPMessage

Returns:

an iterator over all the attachments in this message

getAttachments

public Iterator getAttachments(MimeHeaders headers)

Description copied from class: SOAPMessage

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.

Specified by:

getAttachments in class SOAPMessage

Parameters:

headers - a MimeHeaders object containing the MIME headers for which to search

Returns:

an iterator over all attachments that have a header that matches one of the given headers

saveChanges

public void saveChanges()
                 throws SOAPException

Description copied from class: SOAPMessage

Updates this SOAPMessage object with all the changes that have been made to it. This method is called automatically when SOAPMessage.writeTo(OutputStream) is called. 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.

Specified by:

saveChanges in class SOAPMessage

Throws:

SOAPException

saveRequired

public boolean saveRequired()

Description copied from class: SOAPMessage

Indicates whether this SOAPMessage object needs to have the method saveChanges called on it.

Specified by:

saveRequired in class SOAPMessage

Returns:

true if saveChanges needs to be called; false otherwise.

writeTo

public void writeTo(OutputStream outs)
             throws IOException

Description copied from class: SOAPMessage

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.

Note that this method does not write the transport-specific MIME Headers of the Message

Specified by:

writeTo in class SOAPMessage

Parameters:

outs - the OutputStream object to which this SOAPMessage object will be written

Throws:

IOException - if an I/O error occurs

getOperationMetaData

public OperationMetaData getOperationMetaData(EndpointMetaData epMetaData)
                                       throws SOAPException

Get the operation meta data for this SOAP message

Throws:

SOAPException

getAttachment

public AttachmentPart getAttachment(SOAPElement element)
                             throws SOAPException

Description copied from class: SOAPMessage

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, 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). 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). other reference mechanisms may be supported by individual implementations of this standard. Contact your vendor for details.

Specified by:

getAttachment in class SOAPMessage

Parameters:

element - The SOAPElement containing the reference to an Attachment

Returns:

the referenced AttachmentPart or null if no such AttachmentPart exists or no reference can be found in this SOAPElement.

Throws:

SOAPException - if there is an error in the attempt to access the attachment

removeAttachments

public void removeAttachments(MimeHeaders headers)

Description copied from class: SOAPMessage

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.

Specified by:

removeAttachments in class SOAPMessage

Parameters:

headers - a MimeHeaders object containing the MIME headers for which to search

prepareForDOMAccess

public void prepareForDOMAccess()
                         throws SOAPException

Throws:

SOAPException