|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.xml.soap.AttachmentPart
org.apache.axis2.saaj.AttachmentPartImpl
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 |
public AttachmentPartImpl()
AttachmentPart
.
public AttachmentPartImpl(javax.activation.DataHandler dh)
AttachmentPart
with a DataHandler
.
dh
- the DataHandler
Method Detail |
public OMText getOMText() throws javax.xml.soap.SOAPException
javax.xml.soap.SOAPException
public int getSize() throws javax.xml.soap.SOAPException
javax.xml.soap.AttachmentPart
AttachmentPart
object.
AttachmentPart
object
in bytes or -1 if the size cannot be determined
javax.xml.soap.SOAPException
- if the content of this
attachment is corrupted of if there was an exception
while trying to determine the size.public void clearContent()
javax.xml.soap.AttachmentPart
AttachmentPart
object. The MIME header portion is left
untouched.
public java.lang.Object getContent() throws javax.xml.soap.SOAPException
javax.xml.soap.AttachmentPart
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.
AttachmentPart
object
javax.xml.soap.SOAPException
- if there is no content set
into this AttachmentPart
object or if there
was a data transformation errorpublic void setContent(java.lang.Object object, java.lang.String contentType)
javax.xml.soap.AttachmentPart
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.
object
- the Java object that makes up
the content for this attachment partcontentType
- the MIME string that
specifies the type of the contentgetContent()
public DataHandler getDataHandler() throws javax.xml.soap.SOAPException
javax.xml.soap.AttachmentPart
DataHandler
object for this
AttachmentPart
object.
DataHandler
object associated with
this AttachmentPart
object
javax.xml.soap.SOAPException
- if there is
no data in this AttachmentPart
objectpublic void setDataHandler(DataHandler datahandler)
javax.xml.soap.AttachmentPart
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.
datahandler
- DataHandler
object to
be setpublic void removeMimeHeader(java.lang.String header)
javax.xml.soap.AttachmentPart
header
- - the string name of the MIME
header/s to be removedpublic void removeAllMimeHeaders()
javax.xml.soap.AttachmentPart
public java.lang.String[] getMimeHeader(java.lang.String name)
javax.xml.soap.AttachmentPart
String
.
name
- the name of the header; example:
"Content-Type"
String
array giving the value for the
specified headersetMimeHeader(java.lang.String, java.lang.String)
public void setMimeHeader(java.lang.String name, java.lang.String value)
javax.xml.soap.AttachmentPart
Note that RFC822 headers can only contain US-ASCII characters.
name
- a String
giving the
name of the header for which to searchvalue
- a String
giving the
value to be set for the header whose name matches the
given namepublic void addMimeHeader(java.lang.String name, java.lang.String value)
javax.xml.soap.AttachmentPart
AttachmentPart
object.
Note that RFC822 headers can contain only US-ASCII characters.
name
- a String
giving the
name of the header to be addedvalue
- a String
giving the
value of the header to be addedpublic java.util.Iterator getAllMimeHeaders()
javax.xml.soap.AttachmentPart
AttachmentPart
object as an iterator over the
MimeHeader
objects.
Iterator
object with all of the Mime
headers for this AttachmentPart
objectpublic java.util.Iterator getMatchingMimeHeaders(java.lang.String[] names)
javax.xml.soap.AttachmentPart
MimeHeader
objects that match
a name in the given array.
names
- a String
array with
the name(s) of the MIME headers to be returned
Iterator
objectpublic java.util.Iterator getNonMatchingMimeHeaders(java.lang.String[] names)
javax.xml.soap.AttachmentPart
MimeHeader
objects whose name
does not match a name in the given array.
names
- a String
array with
the name(s) of the MIME headers not to be returned
AttachmentPart
object except those that match one
of the names in the given array. The nonmatching MIME
headers are returned as an Iterator
object.public boolean matches(javax.xml.soap.MimeHeaders headers)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |