| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Multipart mp = new MimeMultipart();
Based on 106 examples
public abstract class Multipart extends Object
Multipart is a container that holds multiple body parts. Multipart provides methods to retrieve and set its subparts.
Multipart also acts as the base class for the content object returned by most Multipart DataContentHandlers. For example, invoking getContent() on a DataHandler whose source is a "multipart/signed" data source may return an appropriate subclass of Multipart.
Some messaging systems provide different subtypes of Multiparts. For example, MIME specifies a set of subtypes that include "alternative", "mixed", "related", "parallel", "signed", etc.
Multipart is an abstract class. Subclasses provide actual implementations.
Field Summary | |
---|---|
protected String |
contentType
This field specifies the content-type of this multipart object. |
protected Part |
parent
The Part containing this Multipart ,
if known. |
protected Vector |
parts
Vector of BodyPart objects. |
Constructor Summary | |
---|---|
protected |
Default constructor. |
Method Summary | |
---|---|
void |
addBodyPart(BodyPart part) Adds a Part to the multipart. |
void |
addBodyPart(BodyPart part, int index) Adds a BodyPart at position index .
|
BodyPart |
getBodyPart(int index) Get the specified Part. |
String |
Return the content-type of this Multipart. |
int |
getCount() Return the number of enclosed BodyPart objects. |
Part |
Return the Part that contains this Multipart
object, or null if not known.
|
boolean |
removeBodyPart(BodyPart part) Remove the specified part from the multipart message. |
void |
removeBodyPart(int index) Remove the part at specified location (starting from 0). |
protected void |
Setup this Multipart object from the given MultipartDataSource. |
void |
Set the parent of this Multipart to be the specified
Part .
|
abstract void |
writeTo(OutputStream os) Output an appropriately encoded bytestream to the given OutputStream. |
Field Detail |
---|
protected String contentType
protected Part parent
Part
containing this Multipart
,
if known.
protected Vector parts
Constructor Detail |
---|
protected Multipart()
Method Detail |
---|
public synchronized void addBodyPart(BodyPart part) throws MessagingException
part
- The Part to be appendedMessagingException
public synchronized void addBodyPart(BodyPart part, int index) throws MessagingException
index
.
If index
is not the last one in the list,
the subsequent parts are shifted up. If index
is larger than the number of parts present, the
BodyPart is appended to the end.
part
- The BodyPart to be insertedindex
- Location where to insert the partMessagingException
public synchronized BodyPart getBodyPart(int index) throws MessagingException
index
- the index of the desired PartMessagingException
public String getContentType()
This implementation just returns the value of the
contentType
field.
public synchronized int getCount() throws MessagingException
MessagingException
public synchronized Part getParent()
Part
that contains this Multipart
object, or null
if not known.
public synchronized boolean removeBodyPart(BodyPart part) throws MessagingException
part
- The part to removeMessagingException
- if no such Part existspublic synchronized void removeBodyPart(int index) throws MessagingException
index
- Index of the part to removeMessagingException
protected synchronized void setMultipartDataSource(MultipartDataSource mp) throws MessagingException
The method adds the MultipartDataSource's BodyPart objects into this Multipart. This Multipart's contentType is set to that of the MultipartDataSource.
This method is typically used in those cases where one has a multipart data source that has already been pre-parsed into the individual body parts (for example, an IMAP datasource), but needs to create an appropriate Multipart subclass that represents a specific multipart subtype.
mp
- Multipart datasourceMessagingException
public synchronized void setParent(Part parent)
Multipart
to be the specified
Part
. Normally called by the Message
or BodyPart
setContent(Multipart)
method.
parent
may be null
if the
Multipart
is being removed from its containing
Part
.
parent
public abstract void writeTo(OutputStream os) throws IOException, MessagingException
os
IOException
- if an IO related exception occursMessagingException
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |