Module com.sun.xml.messaging.saaj

Package com.sun.xml.messaging.saaj.packaging.mime

Interface MultipartDataSource

All Superinterfaces:

DataSource

public interface MultipartDataSource
extends DataSource

MultipartDataSource is a DataSource that contains body parts. This allows "mail aware" DataContentHandlers to be implemented more efficiently by being aware of such DataSources and using the appropriate methods to access BodyParts.

Note that the data of a MultipartDataSource is also available as an input stream.

This interface will typically be implemented by providers that preparse multipart bodies, for example an IMAP provider.

Version:

1.6, 02/03/27

Author:

John Mani

See Also:

DataSource

Method Summary

Modifier and Type	Method	Description
MimeBodyPart	getBodyPart(int index)	Get the specified MimeBodyPart.
int	getCount()	Return the number of enclosed MimeBodyPart objects.

Methods inherited from interface javax.activation.DataSource

getContentType, getInputStream, getName, getOutputStream

Method Detail

getCount

int getCount()

Return the number of enclosed MimeBodyPart objects.

Returns:

number of parts

getBodyPart

MimeBodyPart getBodyPart(int index)
                  throws MessagingException

Get the specified MimeBodyPart. Parts are numbered starting at 0.

Parameters:

index - the index of the desired MimeBodyPart

Returns:

the MimeBodyPart

Throws:

IndexOutOfBoundsException - if the given index is out of range.

MessagingException - thrown in case of error