org.apache.axiom.attachments

Class AttachmentsDelegate

java.lang.Object

org.apache.axiom.attachments.AttachmentsDelegate

Direct Known Subclasses:

AttachmentSet, MIMEMessage

abstract class AttachmentsDelegate
extends java.lang.Object

Attachments delegate. An Attachments object may actually represent two fairly different things (depending on the constructor that is used):

• A MIME multipart message that comprises a root part and a set of attachment parts. Axiom uses deferred parsing to process the message, i.e. the parts and their content are loaded on-demand.
• A programmatically created set of attachment parts. In that case, the root part is not included.

Since the behavior of the Attachments instance is fairly different in the two cases, this should be considered a flaw in the API design. Unfortunately it is not possible to fix this without breaking existing code. In particular, in Axis2 the Attachments API is heavily used by application code. Therefore a delegation pattern is used so that internally these two cases can be represented using distinct classes.

Note that this class is intentionally not public. It is for internal use only. However, in a later Axiom version we may want to refactor this API to make it public, in which case Attachments would simply become a legacy adapter.

Constructor Summary

Constructors

Constructor and Description
AttachmentsDelegate()

Method Summary

Modifier and Type	Method and Description
(package private) abstract void	addDataHandler(java.lang.String contentID, javax.activation.DataHandler dataHandler)
(package private) abstract java.util.Set	getContentIDs(boolean fetchAll)
(package private) abstract long	getContentLength()
(package private) abstract javax.mail.internet.ContentType	getContentType()
(package private) abstract javax.activation.DataHandler	getDataHandler(java.lang.String contentID)
(package private) abstract IncomingAttachmentStreams	getIncomingAttachmentStreams()
(package private) abstract LifecycleManager	getLifecycleManager()
(package private) abstract java.util.Map	getMap()
(package private) abstract java.lang.String	getRootPartContentID()
(package private) abstract java.lang.String	getRootPartContentType()
(package private) abstract java.io.InputStream	getRootPartInputStream(boolean preserve)
(package private) abstract void	removeDataHandler(java.lang.String blobContentID)
(package private) abstract void	setLifecycleManager(LifecycleManager manager)

Methods inherited from class java.lang.Object

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

Constructor Detail

AttachmentsDelegate

AttachmentsDelegate()

Method Detail

getContentType

abstract javax.mail.internet.ContentType getContentType()

getLifecycleManager

abstract LifecycleManager getLifecycleManager()

setLifecycleManager

abstract void setLifecycleManager(LifecycleManager manager)

getDataHandler

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

addDataHandler

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

removeDataHandler

abstract void removeDataHandler(java.lang.String blobContentID)

getRootPartInputStream

abstract java.io.InputStream getRootPartInputStream(boolean preserve)
                                             throws OMException

Throws:

OMException

getRootPartContentID

abstract java.lang.String getRootPartContentID()

getRootPartContentType

abstract java.lang.String getRootPartContentType()

getIncomingAttachmentStreams

abstract IncomingAttachmentStreams getIncomingAttachmentStreams()

getContentIDs

abstract java.util.Set getContentIDs(boolean fetchAll)

getMap

abstract java.util.Map getMap()

getContentLength

abstract long getContentLength()
                        throws java.io.IOException

Throws:

java.io.IOException