org.apache.axis2.saaj
Class AttachmentPartImpl

java.lang.Object
  extended byjavax.xml.soap.AttachmentPart
      extended byorg.apache.axis2.saaj.AttachmentPartImpl

public class AttachmentPartImpl
extends javax.xml.soap.AttachmentPart


Constructor Summary
AttachmentPartImpl()
          Bulds a new AttachmentPart.
AttachmentPartImpl(javax.activation.DataHandler dh)
          Bulds a new AttachmentPart with a DataHandler.
 
Method Summary
 void addMimeHeader(java.lang.String name, java.lang.String value)
          Adds a MIME header with the specified name and value to this AttachmentPart object.
 void clearContent()
          Clears out the content of this AttachmentPart object.
 java.util.Iterator getAllMimeHeaders()
          Retrieves all the headers for this AttachmentPart object as an iterator over the MimeHeader objects.
 java.lang.Object getContent()
          Gets the content of this AttachmentPart object as a Java object.
 DataHandler getDataHandler()
          Gets the DataHandler object for this AttachmentPart object.
 java.util.Iterator getMatchingMimeHeaders(java.lang.String[] names)
          Retrieves all MimeHeader objects that match a name in the given array.
 java.lang.String[] getMimeHeader(java.lang.String name)
          Gets all the values of the header identified by the given String.
 java.util.Iterator getNonMatchingMimeHeaders(java.lang.String[] names)
          Retrieves all MimeHeader objects whose name does not match a name in the given array.
 OMText getOMText()
           
 int getSize()
          Returns the number of bytes in this AttachmentPart object.
 boolean matches(javax.xml.soap.MimeHeaders headers)
           
 void removeAllMimeHeaders()
          Removes all the MIME header entries.
 void removeMimeHeader(java.lang.String header)
          Removes all MIME headers that match the given name.
 void setContent(java.lang.Object object, java.lang.String contentType)
          Sets the content of this attachment part to that of the given Object and sets the value of the Content-Type header to the given type.
 void setDataHandler(DataHandler datahandler)
          Sets the given DataHandler object as the data handler for this AttachmentPart object.
 void setMimeHeader(java.lang.String name, java.lang.String value)
          Changes the first header entry that matches the given name to the given value, adding a new header if no existing header matches.
 
Methods inherited from class javax.xml.soap.AttachmentPart
getContentId, getContentLocation, getContentType, setContentId, setContentLocation, setContentType
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AttachmentPartImpl

public AttachmentPartImpl()
Bulds a new AttachmentPart.


AttachmentPartImpl

public AttachmentPartImpl(javax.activation.DataHandler dh)
Bulds a new AttachmentPart with a DataHandler.

Parameters:
dh - the DataHandler
Method Detail

getOMText

public OMText getOMText()
                 throws javax.xml.soap.SOAPException
Throws:
javax.xml.soap.SOAPException

getSize

public int getSize()
            throws javax.xml.soap.SOAPException
Description copied from class: javax.xml.soap.AttachmentPart
Returns the number of bytes in this AttachmentPart object.

Returns:
the size of this AttachmentPart object in bytes or -1 if the size cannot be determined
Throws:
javax.xml.soap.SOAPException - if the content of this attachment is corrupted of if there was an exception while trying to determine the size.

clearContent

public void clearContent()
Description copied from class: javax.xml.soap.AttachmentPart
Clears out the content of this AttachmentPart object. The MIME header portion is left untouched.


getContent

public java.lang.Object getContent()
                            throws javax.xml.soap.SOAPException
Description copied from class: javax.xml.soap.AttachmentPart
Gets the content of this AttachmentPart object as a Java object. The type of the returned Java object depends on (1) the DataContentHandler object that is used to interpret the bytes and (2) the Content-Type given in the header.

For the MIME content types "text/plain", "text/html" and "text/xml", the DataContentHandler object does the conversions to and from the Java types corresponding to the MIME types. For other MIME types,the DataContentHandler object can return an InputStream object that contains the content data as raw bytes.

A JAXM-compliant implementation must, as a minimum, return a java.lang.String object corresponding to any content stream with a Content-Type value of text/plain, a javax.xml.transform.StreamSource object corresponding to a content stream with a Content-Type value of text/xml, a java.awt.Image object corresponding to a content stream with a Content-Type value of image/gif or image/jpeg. For those content types that an installed DataContentHandler object does not understand, the DataContentHandler object is required to return a java.io.InputStream object with the raw bytes.

Returns:
a Java object with the content of this AttachmentPart object
Throws:
javax.xml.soap.SOAPException - if there is no content set into this AttachmentPart object or if there was a data transformation error

setContent

public void setContent(java.lang.Object object,
                       java.lang.String contentType)
Description copied from class: javax.xml.soap.AttachmentPart
Sets the content of this attachment part to that of the given Object and sets the value of the Content-Type header to the given type. The type of the Object should correspond to the value given for the Content-Type. This depends on the particular set of DataContentHandler objects in use.

Parameters:
object - the Java object that makes up the content for this attachment part
contentType - the MIME string that specifies the type of the content
See Also:
getContent()

getDataHandler

public DataHandler getDataHandler()
                           throws javax.xml.soap.SOAPException
Description copied from class: javax.xml.soap.AttachmentPart
Gets the DataHandler object for this AttachmentPart object.

Returns:
the DataHandler object associated with this AttachmentPart object
Throws:
javax.xml.soap.SOAPException - if there is no data in this AttachmentPart object

setDataHandler

public void setDataHandler(DataHandler datahandler)
Description copied from class: javax.xml.soap.AttachmentPart
Sets the given DataHandler object as the data handler for this AttachmentPart object. Typically, on an incoming message, the data handler is automatically set. When a message is being created and populated with content, the setDataHandler method can be used to get data from various data sources into the message.

Parameters:
datahandler - DataHandler object to be set

removeMimeHeader

public void removeMimeHeader(java.lang.String header)
Description copied from class: javax.xml.soap.AttachmentPart
Removes all MIME headers that match the given name.

Parameters:
header - - the string name of the MIME header/s to be removed

removeAllMimeHeaders

public void removeAllMimeHeaders()
Description copied from class: javax.xml.soap.AttachmentPart
Removes all the MIME header entries.


getMimeHeader

public java.lang.String[] getMimeHeader(java.lang.String name)
Description copied from class: javax.xml.soap.AttachmentPart
Gets all the values of the header identified by the given String.

Parameters:
name - the name of the header; example: "Content-Type"
Returns:
a String array giving the value for the specified header
See Also:
setMimeHeader(java.lang.String, java.lang.String)

setMimeHeader

public void setMimeHeader(java.lang.String name,
                          java.lang.String value)
Description copied from class: javax.xml.soap.AttachmentPart
Changes the first header entry that matches the given name to the given value, adding a new header if no existing header matches. This method also removes all matching headers but the first.

Note that RFC822 headers can only contain US-ASCII characters.

Parameters:
name - a String giving the name of the header for which to search
value - a String giving the value to be set for the header whose name matches the given name

addMimeHeader

public void addMimeHeader(java.lang.String name,
                          java.lang.String value)
Description copied from class: javax.xml.soap.AttachmentPart
Adds a MIME header with the specified name and value to this AttachmentPart object.

Note that RFC822 headers can contain only US-ASCII characters.

Parameters:
name - a String giving the name of the header to be added
value - a String giving the value of the header to be added

getAllMimeHeaders

public java.util.Iterator getAllMimeHeaders()
Description copied from class: javax.xml.soap.AttachmentPart
Retrieves all the headers for this AttachmentPart object as an iterator over the MimeHeader objects.

Returns:
an Iterator object with all of the Mime headers for this AttachmentPart object

getMatchingMimeHeaders

public java.util.Iterator getMatchingMimeHeaders(java.lang.String[] names)
Description copied from class: javax.xml.soap.AttachmentPart
Retrieves all MimeHeader objects that match a name in the given array.

Parameters:
names - a String array with the name(s) of the MIME headers to be returned
Returns:
all of the MIME headers that match one of the names in the given array as an Iterator object

getNonMatchingMimeHeaders

public java.util.Iterator getNonMatchingMimeHeaders(java.lang.String[] names)
Description copied from class: javax.xml.soap.AttachmentPart
Retrieves all MimeHeader objects whose name does not match a name in the given array.

Parameters:
names - a String array with the name(s) of the MIME headers not to be returned
Returns:
all of the MIME headers in this AttachmentPart object except those that match one of the names in the given array. The nonmatching MIME headers are returned as an Iterator object.

matches

public boolean matches(javax.xml.soap.MimeHeaders headers)