org.apache.axiom.attachments
Class Attachments

java.lang.Object
  org.apache.axiom.attachments.Attachments

All Implemented Interfaces:

OMAttachmentAccessor

public class Attachments
extends java.lang.Object
implements OMAttachmentAccessor

Field Summary

protected static org.apache.commons.logging.Log

log

Constructor Summary

Attachments()
Use this constructor when instantiating this to store the attachments set programatically through the SwA API.

Attachments(java.io.InputStream inStream, java.lang.String contentTypeString)
Sets file cache to false.

Attachments(java.io.InputStream inStream, java.lang.String contentTypeString, boolean fileCacheEnable, java.lang.String attachmentRepoDir, java.lang.String fileThreshold)
Moves the pointer to the beginning of the first MIME part.

Attachments(java.io.InputStream inStream, java.lang.String contentTypeString, boolean fileCacheEnable, java.lang.String attachmentRepoDir, java.lang.String fileThreshold, int contentLength)
Moves the pointer to the beginning of the first MIME part.

Attachments(LifecycleManager manager, java.io.InputStream inStream, java.lang.String contentTypeString, boolean fileCacheEnable, java.lang.String attachmentRepoDir, java.lang.String fileThreshold)
Moves the pointer to the beginning of the first MIME part.

Attachments(LifecycleManager manager, java.io.InputStream inStream, java.lang.String contentTypeString, boolean fileCacheEnable, java.lang.String attachmentRepoDir, java.lang.String fileThreshold, int contentLength)
Moves the pointer to the beginning of the first MIME part.

Method Summary

void	addDataHandler(java.lang.String contentID, javax.activation.DataHandler dataHandler) Programatically adding an SOAP with Attachments(SwA) Attachment.
java.lang.String[]	getAllContentIDs() Get the content IDs of all MIME parts in the message.
java.lang.String	getAttachmentSpecType() Identify the type of message (MTOM or SOAP with attachments) represented by this object.
java.util.List	getContentIDList() Get the content IDs of the already loaded MIME parts in the message.
java.util.Set	getContentIDSet() Get the content IDs of all MIME parts in the message.
long	getContentLength() If the Attachments is backed by an InputStream, then this method returns the length of the message contents (Length of the entire message - Length of the Transport Headers)
javax.activation.DataHandler	getDataHandler(java.lang.String contentID) Get the DataHandler object for the MIME part with a given content ID.
java.io.InputStream	getIncomingAttachmentsAsSingleStream() Returns the rest of mime stream.
IncomingAttachmentStreams	getIncomingAttachmentStreams() Stream based access
LifecycleManager	getLifecycleManager()
java.util.Map	getMap() Get a map of all MIME parts in the message.
java.lang.String	getSOAPPartContentID() Get the content ID of the SOAP part or the MIME message.
java.lang.String	getSOAPPartContentType() Get the content type of the SOAP part of the MIME message.
java.io.InputStream	getSOAPPartInputStream()
void	removeDataHandler(java.lang.String blobContentID) Removes the DataHandler corresponding to the given contenID.
protected void	setEndOfStream(boolean value) endOfStreamReached will be set to true if the message ended in MIME Style having "--" suffix with the last mime boundary
void	setLifecycleManager(LifecycleManager manager)

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.apache.commons.logging.Log log

Constructor Detail

Attachments

public Attachments(LifecycleManager manager,
                   java.io.InputStream inStream,
                   java.lang.String contentTypeString,
                   boolean fileCacheEnable,
                   java.lang.String attachmentRepoDir,
                   java.lang.String fileThreshold)
            throws OMException

Moves the pointer to the beginning of the first MIME part. Reads till first MIME boundary is found or end of stream is reached.

Parameters:

inStream -

contentTypeString -

fileCacheEnable -

attachmentRepoDir -

Throws:

OMException

Attachments

public Attachments(LifecycleManager manager,
                   java.io.InputStream inStream,
                   java.lang.String contentTypeString,
                   boolean fileCacheEnable,
                   java.lang.String attachmentRepoDir,
                   java.lang.String fileThreshold,
                   int contentLength)
            throws OMException

Moves the pointer to the beginning of the first MIME part. Reads till first MIME boundary is found or end of stream is reached.

Parameters:

inStream -

contentTypeString -

fileCacheEnable -

attachmentRepoDir -

fileThreshold -

contentLength -

Throws:

OMException

Attachments

public Attachments(java.io.InputStream inStream,
                   java.lang.String contentTypeString,
                   boolean fileCacheEnable,
                   java.lang.String attachmentRepoDir,
                   java.lang.String fileThreshold)
            throws OMException

Moves the pointer to the beginning of the first MIME part. Reads till first MIME boundary is found or end of stream is reached.

Parameters:

inStream -

contentTypeString -

fileCacheEnable -

attachmentRepoDir -

Throws:

OMException

Attachments

public Attachments(java.io.InputStream inStream,
                   java.lang.String contentTypeString,
                   boolean fileCacheEnable,
                   java.lang.String attachmentRepoDir,
                   java.lang.String fileThreshold,
                   int contentLength)
            throws OMException

Moves the pointer to the beginning of the first MIME part. Reads till first MIME boundary is found or end of stream is reached.

Parameters:

inStream -

contentTypeString -

fileCacheEnable -

attachmentRepoDir -

fileThreshold -

contentLength -

Throws:

OMException

Attachments

public Attachments(java.io.InputStream inStream,
                   java.lang.String contentTypeString)
            throws OMException

Sets file cache to false.

Parameters:

inStream -

contentTypeString -

Throws:

OMException

Attachments

public Attachments()

Use this constructor when instantiating this to store the attachments set programatically through the SwA API.

Method Detail

getLifecycleManager

public LifecycleManager getLifecycleManager()

setLifecycleManager

public void setLifecycleManager(LifecycleManager manager)

getAttachmentSpecType

public java.lang.String getAttachmentSpecType()

Identify the type of message (MTOM or SOAP with attachments) represented by this object.

Returns:

One of the MTOMConstants.MTOM_TYPE, MTOMConstants.SWA_TYPE or MTOMConstants.SWA_TYPE_12 constants.

Throws:

OMException - if the message doesn't have one of the supported types, i.e. is neither MTOM nor SOAP with attachments

getDataHandler

public javax.activation.DataHandler getDataHandler(java.lang.String contentID)

Get the DataHandler object for the MIME part with a given content ID.

Specified by:

getDataHandler in interface OMAttachmentAccessor

Parameters:

contentID - the raw content ID (without the surrounding angle brackets and cid: prefix) of the MIME part

Returns:

the DataHandler of the MIME part referred by the content ID or null if the MIME part referred by the content ID does not exist

addDataHandler

public void addDataHandler(java.lang.String contentID,
                           javax.activation.DataHandler dataHandler)

Programatically adding an SOAP with Attachments(SwA) Attachment. These attachments will get serialized only if SOAP with Attachments is enabled.

Parameters:

contentID -

dataHandler -

removeDataHandler

public void removeDataHandler(java.lang.String blobContentID)

Removes the DataHandler corresponding to the given contenID. If it is not present, then trying to find it calling the getNextPart() till the required part is found.

Parameters:

blobContentID -

getSOAPPartInputStream

public java.io.InputStream getSOAPPartInputStream()
                                           throws OMException

Returns:

the InputStream which includes the SOAP Envelope. It assumes that the root mime part is always pointed by "start" parameter in content-type.

Throws:

OMException

getSOAPPartContentID

public java.lang.String getSOAPPartContentID()

Get the content ID of the SOAP part or the MIME message. This content ID is determined as follows:

• If the content type of the MIME message has a start parameter, then the content ID will be extracted from that parameter.
• Otherwise the content ID of the first MIME part of the MIME message is returned.

Returns:

the content ID of the SOAP part (without the surrounding angle brackets)

getSOAPPartContentType

public java.lang.String getSOAPPartContentType()

Get the content type of the SOAP part of the MIME message.

Returns:

the content type of the SOAP part

Throws:

OMException - if the content type could not be determined

getIncomingAttachmentStreams

public IncomingAttachmentStreams getIncomingAttachmentStreams()
                                                       throws java.lang.IllegalStateException

Stream based access

Returns:

The stream container of type IncomingAttachmentStreams

Throws:

java.lang.IllegalStateException - if application has alreadt started using Part's directly

getAllContentIDs

public java.lang.String[] getAllContentIDs()

Get the content IDs of all MIME parts in the message. This includes the content ID of the SOAP part as well as the content IDs of the attachments. Note that if this object has been created from a stream, a call to this method will force reading of all MIME parts that have not been fetched from the stream yet.

Returns:

an array with the content IDs in order of appearance in the message

getContentIDSet

public java.util.Set getContentIDSet()

Get the content IDs of all MIME parts in the message. This includes the content ID of the SOAP part as well as the content IDs of the attachments. Note that if this object has been created from a stream, a call to this method will force reading of all MIME parts that have not been fetched from the stream yet.

Returns:

the set of content IDs

getMap

public java.util.Map getMap()

Get a map of all MIME parts in the message. This includes the SOAP part as well as the attachments. Note that if this object has been created from a stream, a call to this method will force reading of all MIME parts that have not been fetched from the stream yet.

Returns:

A map of all MIME parts in the message, with content IDs as keys and DataHandler objects as values.

getContentIDList

public java.util.List getContentIDList()

Get the content IDs of the already loaded MIME parts in the message. This includes the content ID of the SOAP part as well as the content IDs of the attachments. If this object has been created from a stream, only the content IDs of the MIME parts that have already been fetched from the stream are returned. If this is not the desired behavior, getAllContentIDs() or getContentIDSet() should be used instead.

Returns:

List of content IDs in order of appearance in message

getContentLength

public long getContentLength()
                      throws java.io.IOException

If the Attachments is backed by an InputStream, then this method returns the length of the message contents (Length of the entire message - Length of the Transport Headers)

Returns:

length of message content or -1 if Attachments is not backed by an InputStream

Throws:

java.io.IOException

setEndOfStream

protected void setEndOfStream(boolean value)

endOfStreamReached will be set to true if the message ended in MIME Style having "--" suffix with the last mime boundary

Parameters:

value -

getIncomingAttachmentsAsSingleStream

public java.io.InputStream getIncomingAttachmentsAsSingleStream()
                                                         throws java.lang.IllegalStateException

Returns the rest of mime stream. It will contain all attachments without soappart (first attachment) with headers and mime boundary. Raw content!

Throws:

java.lang.IllegalStateException