java.lang.Object
- javax.mail.Multipart
- - javax.mail.internet.MimeMultipart

```
public class MimeMultipart
extends Multipart
```
The MimeMultipart class is an implementation of the abstract Multipart class that uses MIME conventions for the multipart data.
A MimeMultipart is obtained from a MimePart whose primary type is "multipart" (by invoking the part's getContent() method) or it can be created by a client as part of creating a new MimeMessage.
The default multipart subtype is "mixed". The other multipart subtypes, such as "alternative", "related", and so on, can be implemented as subclasses of MimeMultipart with additional methods to implement the additional semantics of that type of multipart content. The intent is that service providers, mail JavaBean writers and mail clients will write many such subclasses and their Command Beans, and will install them into the JavaBeans Activation Framework, so that any JavaMail implementation and its clients can transparently find and use these classes. Thus, a MIME multipart handler is treated just like any other type handler, thereby decoupling the process of providing multipart handlers from the JavaMail API. Lacking these additional MimeMultipart subclasses, all subtypes of MIME multipart data appear as MimeMultipart objects.
An application can directly construct a MIME multipart object of any subtype by using the MimeMultipart(String subtype) constructor. For example, to create a "multipart/alternative" object, use new MimeMultipart("alternative").
The mail.mime.multipart.ignoremissingendboundary property may be set to false to cause a MessagingException to be thrown if the multipart data does not end with the required end boundary line. If this property is set to true or not set, missing end boundaries are not considered an error and the final body part ends at the end of the data.
The mail.mime.multipart.ignoremissingboundaryparameter System property may be set to false to cause a MessagingException to be thrown if the Content-Type of the MimeMultipart does not include a boundary parameter. If this property is set to true or not set, the multipart parsing code will look for a line that looks like a bounary line and use that as the boundary separating the parts.
The mail.mime.multipart.ignoreexistingboundaryparameter System property may be set to true to cause any boundary to be ignored and instead search for a boundary line in the message as with mail.mime.multipart.ignoremissingboundaryparameter.
Normally, when writing out a MimeMultipart that contains no body parts, or when trying to parse a multipart message with no body parts, a MessagingException is thrown. The MIME spec does not allow multipart content with no body parts. The mail.mime.multipart.allowempty System property may be set to true to override this behavior. When writing out such a MimeMultipart, a single empty part will be included. When reading such a multipart, a MimeMultipart will be created with no body parts.

Constructor Summary

Constructors
Constructor	Description
`MimeMultipart()`	Default constructor.
`MimeMultipart(java.lang.String subtype)`	Construct a MimeMultipart object of the given subtype.
`MimeMultipart(java.lang.String subtype, BodyPart... parts)`	Construct a MimeMultipart object of the given subtype and with the given body parts.
`MimeMultipart(javax.activation.DataSource ds)`	Constructs a MimeMultipart object and its bodyparts from the given DataSource.
`MimeMultipart(BodyPart... parts)`	Construct a MimeMultipart object of the default "mixed" subtype, and with the given body parts.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`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 BodyPart.
`BodyPart`	`getBodyPart(java.lang.String CID)`	Get the MimeBodyPart referred to by the given ContentID (CID).
`int`	`getCount()`	Return the number of enclosed BodyPart objects.
`java.lang.String`	`getPreamble()`	Get the preamble text, if any, that appears before the first body part of this multipart.
`boolean`	`isComplete()`	Return true if the final boundary line for this multipart was seen.
`void`	`removeBodyPart(int index)`	Remove the part at specified location (starting from 0).
`boolean`	`removeBodyPart(BodyPart part)`	Remove the specified part from the multipart message.
`void`	`setPreamble(java.lang.String preamble)`	Set the preamble text to be included before the first body part.
`void`	`setSubType(java.lang.String subtype)`	Set the subtype.
`void`	`writeTo(java.io.OutputStream os)`	Iterates through all the parts and outputs each MIME part separated by a boundary.

Methods inherited from class javax.mail.Multipart
getContentType, getParent, setParent

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MimeMultipart
```
public MimeMultipart()
```
    Default constructor. An empty MimeMultipart object is created. Its content type is set to "multipart/mixed". A unique boundary string is generated and this string is setup as the "boundary" parameter for the contentType field.
    MimeBodyParts may be added later.
  - MimeMultipart
```
public MimeMultipart(java.lang.String subtype)
```
    Construct a MimeMultipart object of the given subtype. A unique boundary string is generated and this string is setup as the "boundary" parameter for the contentType field. Calls the initializeProperties() method.
    MimeBodyParts may be added later.
    
    Parameters:
    
    subtype - the MIME content subtype
  - MimeMultipart
```
public MimeMultipart(BodyPart... parts)
              throws MessagingException
```
    Construct a MimeMultipart object of the default "mixed" subtype, and with the given body parts. More body parts may be added later.
    
    Parameters:
    
    parts - the body parts
    
    Throws:
    
    MessagingException - for failures
    
    Since:
    
    JavaMail 1.5
  - MimeMultipart
```
public MimeMultipart(java.lang.String subtype,
                     BodyPart... parts)
              throws MessagingException
```
    Construct a MimeMultipart object of the given subtype and with the given body parts. More body parts may be added later.
    
    Parameters:
    
    subtype - the MIME content subtype
    
    parts - the body parts
    
    Throws:
    
    MessagingException - for failures
    
    Since:
    
    JavaMail 1.5
  - MimeMultipart
```
public MimeMultipart(javax.activation.DataSource ds)
              throws MessagingException
```
    Constructs a MimeMultipart object and its bodyparts from the given DataSource.
    This constructor handles as a special case the situation where the given DataSource is a MultipartDataSource object. In this case, this method just invokes the superclass (i.e., Multipart) constructor that takes a MultipartDataSource object.
    Otherwise, the DataSource is assumed to provide a MIME multipart byte stream. The parsed flag is set to false. When the data for the body parts are needed, the parser extracts the "boundary" parameter from the content type of this DataSource, skips the 'preamble' and reads bytes till the terminating boundary and creates MimeBodyParts for each part of the stream.
    
    Parameters:
    
    ds - DataSource, can be a MultipartDataSource
    
    Throws:
    
    ParseException - for failures parsing the message
    
    MessagingException - for other failures
- Method Detail
  - setSubType
```
public void setSubType(java.lang.String subtype)
                throws MessagingException
```
    Set the subtype. This method should be invoked only on a new MimeMultipart object created by the client. The default subtype of such a multipart object is "mixed".
    
    Parameters:
    
    subtype - Subtype
    
    Throws:
    
    MessagingException - for failures
  - getCount
```
public int getCount()
             throws MessagingException
```
    Return the number of enclosed BodyPart objects.
    
    Overrides:
    
    getCount in class Multipart
    
    Returns:
    
    number of parts
    
    Throws:
    
    MessagingException - for failures
    
    See Also:
    
    Multipart.parts
  - getBodyPart
```
public BodyPart getBodyPart(int index)
                     throws MessagingException
```
    Get the specified BodyPart. BodyParts are numbered starting at 0.
    
    Overrides:
    
    getBodyPart in class Multipart
    
    Parameters:
    
    index - the index of the desired BodyPart
    
    Returns:
    
    the Part
    
    Throws:
    
    MessagingException - if no such BodyPart exists
  - getBodyPart
```
public BodyPart getBodyPart(java.lang.String CID)
                     throws MessagingException
```
    Get the MimeBodyPart referred to by the given ContentID (CID). Returns null if the part is not found.
    
    Parameters:
    
    CID - the ContentID of the desired part
    
    Returns:
    
    the Part
    
    Throws:
    
    MessagingException - for failures
  - removeBodyPart
```
public boolean removeBodyPart(BodyPart part)
                       throws MessagingException
```
    Remove the specified part from the multipart message. Shifts all the parts after the removed part down one.
    
    Overrides:
    
    removeBodyPart in class Multipart
    
    Parameters:
    
    part - The part to remove
    
    Returns:
    
    true if part removed, false otherwise
    
    Throws:
    
    MessagingException - if no such Part exists
    
    IllegalWriteException - if the underlying implementation does not support modification of existing values
  - removeBodyPart
```
public void removeBodyPart(int index)
                    throws MessagingException
```
    Remove the part at specified location (starting from 0). Shifts all the parts after the removed part down one.
    
    Overrides:
    
    removeBodyPart in class Multipart
    
    Parameters:
    
    index - Index of the part to remove
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the given index is out of range.
    
    IllegalWriteException - if the underlying implementation does not support modification of existing values
    
    MessagingException - for other failures
  - addBodyPart
```
public void addBodyPart(BodyPart part)
                 throws MessagingException
```
    Adds a Part to the multipart. The BodyPart is appended to the list of existing Parts.
    
    Overrides:
    
    addBodyPart in class Multipart
    
    Parameters:
    
    part - The Part to be appended
    
    Throws:
    
    IllegalWriteException - if the underlying implementation does not support modification of existing values
    
    MessagingException - for other failures
  - addBodyPart
```
public void addBodyPart(BodyPart part,
                        int index)
                 throws MessagingException
```
    Adds a BodyPart at position 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.
    
    Overrides:
    
    addBodyPart in class Multipart
    
    Parameters:
    
    part - The BodyPart to be inserted
    
    index - Location where to insert the part
    
    Throws:
    
    IllegalWriteException - if the underlying implementation does not support modification of existing values
    
    MessagingException - for other failures
  - isComplete
```
public boolean isComplete()
                   throws MessagingException
```
    Return true if the final boundary line for this multipart was seen. When parsing multipart content, this class will (by default) terminate parsing with no error if the end of input is reached before seeing the final multipart boundary line. In such a case, this method will return false. (If the System property "mail.mime.multipart.ignoremissingendboundary" is set to false, parsing such a message will instead throw a MessagingException.)
    
    Returns:
    
    true if the final boundary line was seen
    
    Throws:
    
    MessagingException - for failures
    
    Since:
    
    JavaMail 1.4
  - getPreamble
```
public java.lang.String getPreamble()
                             throws MessagingException
```
    Get the preamble text, if any, that appears before the first body part of this multipart. Some protocols, such as IMAP, will not allow access to the preamble text.
    
    Returns:
    
    the preamble text, or null if no preamble
    
    Throws:
    
    MessagingException - for failures
    
    Since:
    
    JavaMail 1.4
  - setPreamble
```
public void setPreamble(java.lang.String preamble)
                 throws MessagingException
```
    Set the preamble text to be included before the first body part. Applications should generally not include any preamble text. In some cases it may be helpful to include preamble text with instructions for users of pre-MIME software. The preamble text should be complete lines, including newlines.
    
    Parameters:
    
    preamble - the preamble text
    
    Throws:
    
    MessagingException - for failures
    
    Since:
    
    JavaMail 1.4
  - writeTo
```
public void writeTo(java.io.OutputStream os)
             throws java.io.IOException,
                    MessagingException
```
    Iterates through all the parts and outputs each MIME part separated by a boundary.
    
    Specified by:
    
    writeTo in class Multipart
    
    Parameters:
    
    os - the stream to write to
    
    Throws:
    
    java.io.IOException - if an IO related exception occurs
    
    MessagingException - for other failures

Class MimeMultipart

Constructor Summary

Method Summary

Methods inherited from class javax.mail.Multipart

Methods inherited from class java.lang.Object

Constructor Detail

MimeMultipart

MimeMultipart

MimeMultipart

MimeMultipart

MimeMultipart

Method Detail

setSubType

getCount

getBodyPart

getBodyPart

removeBodyPart

removeBodyPart

addBodyPart

addBodyPart

isComplete

getPreamble

setPreamble

writeTo