org.apache.commons.mail

Class MultiPartEmail

java.lang.Object

org.apache.commons.mail.Email

org.apache.commons.mail.MultiPartEmail

Direct Known Subclasses:

HtmlEmail

public class MultiPartEmail
extends Email

A multipart email.

This class is used to send multi-part internet email like messages with attachments.

To create a multi-part email, call the default constructor and then you can call setMsg() to set the message and call the different attach() methods.

Since:

1.0

Field Summary

Fields inherited from class org.apache.commons.mail.Email

ATTACHMENTS, CONTENT_TYPE, EMAIL_BODY, EMAIL_SUBJECT, FILE_SERVER, ISO_8859_1, KOI8_R, MAIL_DEBUG, MAIL_HOST, MAIL_PORT, MAIL_SMTP_AUTH, MAIL_SMTP_CONNECTIONTIMEOUT, MAIL_SMTP_FROM, MAIL_SMTP_PASSWORD, MAIL_SMTP_SOCKET_FACTORY_CLASS, MAIL_SMTP_SOCKET_FACTORY_FALLBACK, MAIL_SMTP_SOCKET_FACTORY_PORT, MAIL_SMTP_TIMEOUT, MAIL_SMTP_USER, MAIL_TRANSPORT_PROTOCOL, MAIL_TRANSPORT_TLS, RECEIVER_EMAIL, RECEIVER_NAME, SENDER_EMAIL, SENDER_NAME, SMTP, TEXT_HTML, TEXT_PLAIN, US_ASCII

Constructor Summary

Constructors

Constructor and Description
MultiPartEmail()

Method Summary

Modifier and Type	Method and Description
Email	addPart(MimeMultipart multipart) Add a new part to the email.
Email	addPart(MimeMultipart multipart, int index) Add a new part to the email.
Email	addPart(java.lang.String partContent, java.lang.String partContentType) Add a new part to the email.
MultiPartEmail	attach(javax.activation.DataSource ds, java.lang.String name, java.lang.String description) Attach a file specified as a DataSource interface.
MultiPartEmail	attach(javax.activation.DataSource ds, java.lang.String name, java.lang.String description, java.lang.String disposition) Attach a file specified as a DataSource interface.
MultiPartEmail	attach(EmailAttachment attachment) Attach an EmailAttachment.
MultiPartEmail	attach(java.io.File file) Attach a file.
MultiPartEmail	attach(java.net.URL url, java.lang.String name, java.lang.String description) Attach a file located by its URL.
MultiPartEmail	attach(java.net.URL url, java.lang.String name, java.lang.String description, java.lang.String disposition) Attach a file located by its URL.
void	buildMimeMessage() Does the work of actually building the MimeMessage.
java.lang.String	getSubType() Get the MIME subtype of the email.
boolean	isBoolHasAttachments() Checks whether there are attachments.
void	setBoolHasAttachments(boolean b) Sets whether there are attachments.
Email	setMsg(java.lang.String msg) Set the message of the email.
void	setSubType(java.lang.String aSubType) Set the MIME subtype of the email.

Methods inherited from class org.apache.commons.mail.Email

addBcc, addBcc, addBcc, addBcc, addCc, addCc, addCc, addCc, addHeader, addReplyTo, addReplyTo, addReplyTo, addTo, addTo, addTo, addTo, getBccAddresses, getBounceAddress, getCcAddresses, getFromAddress, getHeader, getHeaders, getHostName, getMailSession, getMimeMessage, getReplyToAddresses, getSentDate, getSmtpPort, getSocketConnectionTimeout, getSocketTimeout, getSslSmtpPort, getSubject, getToAddresses, isSendPartial, isSSL, isSSLCheckServerIdentity, isSSLOnConnect, isStartTLSEnabled, isStartTLSRequired, isTLS, send, sendMimeMessage, setAuthentication, setAuthenticator, setBcc, setBounceAddress, setCc, setCharset, setContent, setContent, setDebug, setFrom, setFrom, setFrom, setHeaders, setHostName, setMailSession, setMailSessionFromJNDI, setPopBeforeSmtp, setReplyTo, setSendPartial, setSentDate, setSmtpPort, setSocketConnectionTimeout, setSocketTimeout, setSSL, setSSLCheckServerIdentity, setSSLOnConnect, setSslSmtpPort, setStartTLSEnabled, setStartTLSRequired, setSubject, setTLS, setTo, updateContentType

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiPartEmail

public MultiPartEmail()

Method Detail

setSubType

public void setSubType(java.lang.String aSubType)

Set the MIME subtype of the email.

Parameters:

aSubType - MIME subtype of the email

Since:

1.0

getSubType

public java.lang.String getSubType()

Get the MIME subtype of the email.

Returns:

MIME subtype of the email

Since:

1.0

addPart

public Email addPart(java.lang.String partContent,
                     java.lang.String partContentType)
              throws EmailException

Add a new part to the email.

Parameters:

partContent - The content.

partContentType - The content type.

Returns:

An Email.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

addPart

public Email addPart(MimeMultipart multipart)
              throws EmailException

Add a new part to the email.

Parameters:

multipart - The MimeMultipart.

Returns:

An Email.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

addPart

public Email addPart(MimeMultipart multipart,
                     int index)
              throws EmailException

Add a new part to the email.

Parameters:

multipart - The part to add.

index - The index to add at.

Returns:

The email.

Throws:

EmailException - An error occurred while adding the part.

Since:

1.0

setMsg

public Email setMsg(java.lang.String msg)
             throws EmailException

Set the message of the email.

Specified by:

setMsg in class Email

Parameters:

msg - A String.

Returns:

An Email.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

buildMimeMessage

public void buildMimeMessage()
                      throws EmailException

Does the work of actually building the MimeMessage. Please note that a user rarely calls this method directly and only if he/she is interested in the sending the underlying MimeMessage without commons-email.

Overrides:

buildMimeMessage in class Email

Throws:

EmailException - if there was an error.

Since:

1.0

attach

public MultiPartEmail attach(java.io.File file)
                      throws EmailException

Attach a file.

Parameters:

file - A file attachment

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.3

attach

public MultiPartEmail attach(EmailAttachment attachment)
                      throws EmailException

Attach an EmailAttachment.

Parameters:

attachment - An EmailAttachment.

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

attach

public MultiPartEmail attach(java.net.URL url,
                             java.lang.String name,
                             java.lang.String description)
                      throws EmailException

Attach a file located by its URL. The disposition of the file is set to mixed.

Parameters:

url - The URL of the file (may be any valid URL).

name - The name field for the attachment.

description - A description for the attachment.

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

attach

public MultiPartEmail attach(java.net.URL url,
                             java.lang.String name,
                             java.lang.String description,
                             java.lang.String disposition)
                      throws EmailException

Attach a file located by its URL.

Parameters:

url - The URL of the file (may be any valid URL).

name - The name field for the attachment.

description - A description for the attachment.

disposition - Either mixed or inline.

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

attach

public MultiPartEmail attach(javax.activation.DataSource ds,
                             java.lang.String name,
                             java.lang.String description)
                      throws EmailException

Attach a file specified as a DataSource interface.

Parameters:

ds - A DataSource interface for the file.

name - The name field for the attachment.

description - A description for the attachment.

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

attach

public MultiPartEmail attach(javax.activation.DataSource ds,
                             java.lang.String name,
                             java.lang.String description,
                             java.lang.String disposition)
                      throws EmailException

Attach a file specified as a DataSource interface.

Parameters:

ds - A DataSource interface for the file.

name - The name field for the attachment.

description - A description for the attachment.

disposition - Either mixed or inline.

Returns:

A MultiPartEmail.

Throws:

EmailException - see javax.mail.internet.MimeBodyPart for definitions

Since:

1.0

isBoolHasAttachments

public boolean isBoolHasAttachments()

Checks whether there are attachments.

Returns:

true if there are attachments

Since:

1.0

setBoolHasAttachments

public void setBoolHasAttachments(boolean b)

Sets whether there are attachments.

Parameters:

b - the attachments flag

Since:

1.0