com.jfplugin.mail.core

类 MimeMessageHelper

java.lang.Object

com.jfplugin.mail.core.MimeMessageHelper

public class MimeMessageHelper
extends Object

作者:

farmer

字段概要

字段

限定符和类型	字段和说明
static int	MULTIPART_MODE_MIXED Constant indicating a multipart message with a single root multipart element of type "mixed".
static int	MULTIPART_MODE_MIXED_RELATED Constant indicating a multipart message with a root multipart element "mixed" plus a nested multipart element of type "related".
static int	MULTIPART_MODE_NO Constant indicating a non-multipart message.
static int	MULTIPART_MODE_RELATED Constant indicating a multipart message with a single root multipart element of type "related".

构造器概要

构造器

构造器和说明
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage) Create a new MimeMessageHelper for the given MimeMessage, assuming a simple text message (no multipart content, i.e. no alternative texts and no inline elements or attachments).
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage, boolean multipart) Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage, boolean multipart, String encoding) Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage, int multipartMode) Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage, int multipartMode, String encoding) Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.
MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage, String encoding) Create a new MimeMessageHelper for the given MimeMessage, assuming a simple text message (no multipart content, i.e. no alternative texts and no inline elements or attachments).

方法概要

方法

限定符和类型	方法和说明
void	addAttachment(String attachmentFilename, DataSource dataSource) Add an attachment to the MimeMessage, taking the content from a javax.activation.DataSource.
void	addAttachment(String attachmentFilename, File file) Add an attachment to the MimeMessage, taking the content from a java.io.File.
void	addBcc(javax.mail.internet.InternetAddress bcc)
void	addBcc(String bcc)
void	addBcc(String bcc, String personal)
void	addCc(javax.mail.internet.InternetAddress cc)
void	addCc(String cc)
void	addCc(String cc, String personal)
void	addInline(String contentId, DataSource dataSource) Add an inline element to the MimeMessage, taking the content from a javax.activation.DataSource.
void	addInline(String contentId, File file) Add an inline element to the MimeMessage, taking the content from a java.io.File.
void	addTo(javax.mail.internet.InternetAddress to)
void	addTo(String to)
void	addTo(String to, String personal)
protected void	createMimeMultiparts(javax.mail.internet.MimeMessage mimeMessage, int multipartMode) Determine the MimeMultipart objects to use, which will be used to store attachments on the one hand and text(s) and inline elements on the other hand.
protected String	getDefaultEncoding(javax.mail.internet.MimeMessage mimeMessage) Determine the default encoding for the given MimeMessage.
protected FileTypeMap	getDefaultFileTypeMap(javax.mail.internet.MimeMessage mimeMessage) Determine the default Java Activation FileTypeMap for the given MimeMessage.
String	getEncoding() Return the specific character encoding used for this message, if any.
FileTypeMap	getFileTypeMap() Return the FileTypeMap used by this MimeMessageHelper.
javax.mail.internet.MimeMessage	getMimeMessage() Return the underlying MimeMessage object.
javax.mail.internet.MimeMultipart	getMimeMultipart() Return the underlying MIME "multipart/related" object, if any.
javax.mail.internet.MimeMultipart	getRootMimeMultipart() Return the root MIME "multipart/mixed" object, if any.
boolean	isMultipart() Return whether this helper is in multipart mode, i.e. whether it holds a multipart message.
boolean	isValidateAddresses() Return whether this helper will validate all addresses passed to it.
void	setBcc(javax.mail.internet.InternetAddress bcc)
void	setBcc(javax.mail.internet.InternetAddress[] bcc)
void	setBcc(String bcc)
void	setBcc(String[] bcc)
void	setCc(javax.mail.internet.InternetAddress cc)
void	setCc(javax.mail.internet.InternetAddress[] cc)
void	setCc(String cc)
void	setCc(String[] cc)
void	setFileTypeMap(FileTypeMap fileTypeMap) Set the Java Activation Framework FileTypeMap to use for determining the content type of inline content and attachments that get added to the message.
void	setFrom(javax.mail.internet.InternetAddress from)
void	setFrom(String from)
void	setFrom(String from, String personal)
protected void	setMimeMultiparts(javax.mail.internet.MimeMultipart root, javax.mail.internet.MimeMultipart main) Set the given MimeMultipart objects for use by this MimeMessageHelper.
void	setPriority(int priority) Set the priority ("X-Priority" header) of the message.
void	setReplyTo(javax.mail.internet.InternetAddress replyTo)
void	setReplyTo(String replyTo)
void	setReplyTo(String replyTo, String personal)
void	setSentDate(Date sentDate) Set the sent-date of the message.
void	setSubject(String subject) Set the subject of the message, using the correct encoding.
void	setText(String text) Set the given text directly as content in non-multipart mode or as default body part in multipart mode.
void	setText(String text, boolean html) Set the given text directly as content in non-multipart mode or as default body part in multipart mode.
void	setText(String plainText, String htmlText) Set the given plain text and HTML text as alternatives, offering both options to the email client.
void	setTo(javax.mail.internet.InternetAddress to)
void	setTo(javax.mail.internet.InternetAddress[] to)
void	setTo(String to)
void	setTo(String[] to)
void	setValidateAddresses(boolean validateAddresses) Set whether to validate all addresses which get passed to this helper.
protected void	validateAddress(javax.mail.internet.InternetAddress address) Validate the given mail address.
protected void	validateAddresses(javax.mail.internet.InternetAddress[] addresses) Validate all given mail addresses.

从类继承的方法 java.lang.Object

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

字段详细资料

MULTIPART_MODE_NO

public static final int MULTIPART_MODE_NO

Constant indicating a non-multipart message.

另请参阅:

常量字段值

MULTIPART_MODE_MIXED

public static final int MULTIPART_MODE_MIXED

Constant indicating a multipart message with a single root multipart element of type "mixed". Texts, inline elements and attachements will all get added to that root element.

This was Spring 1.0's default behavior. It is known to work properly on Outlook. However, other mail clients tend to misinterpret inline elements as attachments and/or show attachments inline as well.

另请参阅:

常量字段值

MULTIPART_MODE_RELATED

public static final int MULTIPART_MODE_RELATED

Constant indicating a multipart message with a single root multipart element of type "related". Texts, inline elements and attachements will all get added to that root element.

This was the default behavior from Spring 1.1 up to 1.2 final. This is the "Microsoft multipart mode", as natively sent by Outlook. It is known to work properly on Outlook, Outlook Express, Yahoo Mail, and to a large degree also on Mac Mail (with an additional attachment listed for an inline element, despite the inline element also shown inline). Does not work properly on Lotus Notes (attachments won't be shown there).

另请参阅:

常量字段值

MULTIPART_MODE_MIXED_RELATED

public static final int MULTIPART_MODE_MIXED_RELATED

Constant indicating a multipart message with a root multipart element "mixed" plus a nested multipart element of type "related". Texts and inline elements will get added to the nested "related" element, while attachments will get added to the "mixed" root element.

This is the default since Spring 1.2.1. This is arguably the most correct MIME structure, according to the MIME spec: It is known to work properly on Outlook, Outlook Express, Yahoo Mail, and Lotus Notes. Does not work properly on Mac Mail. If you target Mac Mail or experience issues with specific mails on Outlook, consider using MULTIPART_MODE_RELATED instead.

另请参阅:

常量字段值

构造器详细资料

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage)

Create a new MimeMessageHelper for the given MimeMessage, assuming a simple text message (no multipart content, i.e. no alternative texts and no inline elements or attachments).

The character encoding for the message will be taken from the passed-in MimeMessage object, if carried there. Else, JavaMail's default encoding will be used.

参数:

mimeMessage - MimeMessage to work on

另请参阅:

MimeMessageHelper(javax.mail.internet.MimeMessage, boolean), getDefaultEncoding(javax.mail.internet.MimeMessage), JavaMailSenderImpl.setDefaultEncoding(java.lang.String)

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage,
                 String encoding)

Create a new MimeMessageHelper for the given MimeMessage, assuming a simple text message (no multipart content, i.e. no alternative texts and no inline elements or attachments).

参数:

mimeMessage - MimeMessage to work on

encoding - the character encoding to use for the message

另请参阅:

MimeMessageHelper(javax.mail.internet.MimeMessage, boolean)

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage,
                 boolean multipart)
                  throws javax.mail.MessagingException

Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.

Consider using the MimeMessageHelper constructor that takes a multipartMode argument to choose a specific multipart mode other than MULTIPART_MODE_MIXED_RELATED.

The character encoding for the message will be taken from the passed-in MimeMessage object, if carried there. Else, JavaMail's default encoding will be used.

参数:

mimeMessage - MimeMessage to work on

multipart - whether to create a multipart message that supports alternative texts, inline elements and attachments (corresponds to MULTIPART_MODE_MIXED_RELATED)

抛出:

javax.mail.MessagingException - if multipart creation failed

另请参阅:

MimeMessageHelper(javax.mail.internet.MimeMessage, int), getDefaultEncoding(javax.mail.internet.MimeMessage), JavaMailSenderImpl.setDefaultEncoding(java.lang.String)

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage,
                 boolean multipart,
                 String encoding)
                  throws javax.mail.MessagingException

Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.

Consider using the MimeMessageHelper constructor that takes a multipartMode argument to choose a specific multipart mode other than MULTIPART_MODE_MIXED_RELATED.

参数:

mimeMessage - MimeMessage to work on

multipart - whether to create a multipart message that supports alternative texts, inline elements and attachments (corresponds to MULTIPART_MODE_MIXED_RELATED)

encoding - the character encoding to use for the message

抛出:

javax.mail.MessagingException - if multipart creation failed

另请参阅:

MimeMessageHelper(javax.mail.internet.MimeMessage, int, String)

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage,
                 int multipartMode)
                  throws javax.mail.MessagingException

Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.

The character encoding for the message will be taken from the passed-in MimeMessage object, if carried there. Else, JavaMail's default encoding will be used.

参数:

mimeMessage - MimeMessage to work on

multipartMode - which kind of multipart message to create (MIXED, RELATED, MIXED_RELATED, or NO)

抛出:

javax.mail.MessagingException - if multipart creation failed

另请参阅:

MULTIPART_MODE_NO, MULTIPART_MODE_MIXED, MULTIPART_MODE_RELATED, MULTIPART_MODE_MIXED_RELATED, getDefaultEncoding(javax.mail.internet.MimeMessage), JavaMailSenderImpl.setDefaultEncoding(java.lang.String)

MimeMessageHelper

public MimeMessageHelper(javax.mail.internet.MimeMessage mimeMessage,
                 int multipartMode,
                 String encoding)
                  throws javax.mail.MessagingException

Create a new MimeMessageHelper for the given MimeMessage, in multipart mode (supporting alternative texts, inline elements and attachments) if requested.

参数:

mimeMessage - MimeMessage to work on

multipartMode - which kind of multipart message to create (MIXED, RELATED, MIXED_RELATED, or NO)

encoding - the character encoding to use for the message

抛出:

javax.mail.MessagingException - if multipart creation failed

另请参阅:

MULTIPART_MODE_NO, MULTIPART_MODE_MIXED, MULTIPART_MODE_RELATED, MULTIPART_MODE_MIXED_RELATED

方法详细资料

getMimeMessage

public final javax.mail.internet.MimeMessage getMimeMessage()

Return the underlying MimeMessage object.

createMimeMultiparts

protected void createMimeMultiparts(javax.mail.internet.MimeMessage mimeMessage,
                        int multipartMode)
                             throws javax.mail.MessagingException

Determine the MimeMultipart objects to use, which will be used to store attachments on the one hand and text(s) and inline elements on the other hand.

Texts and inline elements can either be stored in the root element itself (MULTIPART_MODE_MIXED, MULTIPART_MODE_RELATED) or in a nested element rather than the root element directly (MULTIPART_MODE_MIXED_RELATED).

By default, the root MimeMultipart element will be of type "mixed" (MULTIPART_MODE_MIXED) or "related" (MULTIPART_MODE_RELATED). The main multipart element will either be added as nested element of type "related" (MULTIPART_MODE_MIXED_RELATED) or be identical to the root element itself (MULTIPART_MODE_MIXED, MULTIPART_MODE_RELATED).

参数:

mimeMessage - the MimeMessage object to add the root MimeMultipart object to

multipartMode - the multipart mode, as passed into the constructor (MIXED, RELATED, MIXED_RELATED, or NO)

抛出:

javax.mail.MessagingException - if multipart creation failed

另请参阅:

setMimeMultiparts(javax.mail.internet.MimeMultipart, javax.mail.internet.MimeMultipart), MULTIPART_MODE_NO, MULTIPART_MODE_MIXED, MULTIPART_MODE_RELATED, MULTIPART_MODE_MIXED_RELATED

setMimeMultiparts

protected final void setMimeMultiparts(javax.mail.internet.MimeMultipart root,
                     javax.mail.internet.MimeMultipart main)

Set the given MimeMultipart objects for use by this MimeMessageHelper.

参数:

root - the root MimeMultipart object, which attachments will be added to; or null to indicate no multipart at all

main - the main MimeMultipart object, which text(s) and inline elements will be added to (can be the same as the root multipart object, or an element nested underneath the root multipart element)

isMultipart

public final boolean isMultipart()

Return whether this helper is in multipart mode, i.e. whether it holds a multipart message.

另请参阅:

MimeMessageHelper(MimeMessage, boolean)

getRootMimeMultipart

public final javax.mail.internet.MimeMultipart getRootMimeMultipart()
                                                             throws IllegalStateException

Return the root MIME "multipart/mixed" object, if any. Can be used to manually add attachments.

This will be the direct content of the MimeMessage, in case of a multipart mail.

抛出:

IllegalStateException - if this helper is not in multipart mode

另请参阅:

isMultipart(), getMimeMessage(), MimeMultipart.addBodyPart(javax.mail.BodyPart)

getMimeMultipart

public final javax.mail.internet.MimeMultipart getMimeMultipart()
                                                         throws IllegalStateException

Return the underlying MIME "multipart/related" object, if any. Can be used to manually add body parts, inline elements, etc.

This will be nested within the root MimeMultipart, in case of a multipart mail.

抛出:

IllegalStateException - if this helper is not in multipart mode

另请参阅:

isMultipart(), getRootMimeMultipart(), MimeMultipart.addBodyPart(javax.mail.BodyPart)

getDefaultEncoding

protected String getDefaultEncoding(javax.mail.internet.MimeMessage mimeMessage)

Determine the default encoding for the given MimeMessage.

参数:

mimeMessage - the passed-in MimeMessage

返回:

the default encoding associated with the MimeMessage, or null if none found

getEncoding

public String getEncoding()

Return the specific character encoding used for this message, if any.

getDefaultFileTypeMap

protected FileTypeMap getDefaultFileTypeMap(javax.mail.internet.MimeMessage mimeMessage)

Determine the default Java Activation FileTypeMap for the given MimeMessage.

参数:

mimeMessage - the passed-in MimeMessage

返回:

the default FileTypeMap associated with the MimeMessage, or a default ConfigurableMimeFileTypeMap if none found for the message

另请参阅:

ConfigurableMimeFileTypeMap

setFileTypeMap

public void setFileTypeMap(FileTypeMap fileTypeMap)

Set the Java Activation Framework FileTypeMap to use for determining the content type of inline content and attachments that get added to the message.

Default is the FileTypeMap that the underlying MimeMessage carries, if any, or the Activation Framework's default FileTypeMap instance else.

另请参阅:

addInline(java.lang.String, javax.activation.DataSource), addAttachment(java.lang.String, javax.activation.DataSource), getDefaultFileTypeMap(javax.mail.internet.MimeMessage), JavaMailSenderImpl.setDefaultFileTypeMap(javax.activation.FileTypeMap), FileTypeMap.getDefaultFileTypeMap(), ConfigurableMimeFileTypeMap

getFileTypeMap

public FileTypeMap getFileTypeMap()

Return the FileTypeMap used by this MimeMessageHelper.

setValidateAddresses

public void setValidateAddresses(boolean validateAddresses)

Set whether to validate all addresses which get passed to this helper. Default is "false".

Note that this is by default just available for JavaMail >= 1.3. You can override the default validateAddress method for validation on older JavaMail versions (or for custom validation).

另请参阅:

validateAddress(javax.mail.internet.InternetAddress)

isValidateAddresses

public boolean isValidateAddresses()

Return whether this helper will validate all addresses passed to it.

validateAddress

protected void validateAddress(javax.mail.internet.InternetAddress address)
                        throws javax.mail.internet.AddressException

Validate the given mail address. Called by all of MimeMessageHelper's address setters and adders.

Default implementation invokes InternetAddress.validate(), provided that address validation is activated for the helper instance.

Note that this method will just work on JavaMail >= 1.3. You can override it for validation on older JavaMail versions or for custom validation.

参数:

address - the address to validate

抛出:

javax.mail.internet.AddressException - if validation failed

另请参阅:

isValidateAddresses(), InternetAddress.validate()

validateAddresses

protected void validateAddresses(javax.mail.internet.InternetAddress[] addresses)
                          throws javax.mail.internet.AddressException

Validate all given mail addresses. Default implementation simply delegates to validateAddress for each address.

参数:

addresses - the addresses to validate

抛出:

javax.mail.internet.AddressException - if validation failed

另请参阅:

validateAddress(InternetAddress)

setFrom

public void setFrom(javax.mail.internet.InternetAddress from)
             throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setFrom

public void setFrom(String from)
             throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setFrom

public void setFrom(String from,
           String personal)
             throws javax.mail.MessagingException,
                    UnsupportedEncodingException

抛出:

javax.mail.MessagingException

UnsupportedEncodingException

setReplyTo

public void setReplyTo(javax.mail.internet.InternetAddress replyTo)
                throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setReplyTo

public void setReplyTo(String replyTo)
                throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setReplyTo

public void setReplyTo(String replyTo,
              String personal)
                throws javax.mail.MessagingException,
                       UnsupportedEncodingException

抛出:

javax.mail.MessagingException

UnsupportedEncodingException

setTo

public void setTo(javax.mail.internet.InternetAddress to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setTo

public void setTo(javax.mail.internet.InternetAddress[] to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setTo

public void setTo(String to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setTo

public void setTo(String[] to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addTo

public void addTo(javax.mail.internet.InternetAddress to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addTo

public void addTo(String to)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addTo

public void addTo(String to,
         String personal)
           throws javax.mail.MessagingException,
                  UnsupportedEncodingException

抛出:

javax.mail.MessagingException

UnsupportedEncodingException

setCc

public void setCc(javax.mail.internet.InternetAddress cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setCc

public void setCc(javax.mail.internet.InternetAddress[] cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setCc

public void setCc(String cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setCc

public void setCc(String[] cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addCc

public void addCc(javax.mail.internet.InternetAddress cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addCc

public void addCc(String cc)
           throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addCc

public void addCc(String cc,
         String personal)
           throws javax.mail.MessagingException,
                  UnsupportedEncodingException

抛出:

javax.mail.MessagingException

UnsupportedEncodingException

setBcc

public void setBcc(javax.mail.internet.InternetAddress bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setBcc

public void setBcc(javax.mail.internet.InternetAddress[] bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setBcc

public void setBcc(String bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

setBcc

public void setBcc(String[] bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addBcc

public void addBcc(javax.mail.internet.InternetAddress bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addBcc

public void addBcc(String bcc)
            throws javax.mail.MessagingException

抛出:

javax.mail.MessagingException

addBcc

public void addBcc(String bcc,
          String personal)
            throws javax.mail.MessagingException,
                   UnsupportedEncodingException

抛出:

javax.mail.MessagingException

UnsupportedEncodingException

setPriority

public void setPriority(int priority)
                 throws javax.mail.MessagingException

Set the priority ("X-Priority" header) of the message.

参数:

priority - the priority value; typically between 1 (highest) and 5 (lowest)

抛出:

javax.mail.MessagingException - in case of errors

setSentDate

public void setSentDate(Date sentDate)
                 throws javax.mail.MessagingException

Set the sent-date of the message.

参数:

sentDate - the date to set (never null)

抛出:

javax.mail.MessagingException - in case of errors

setSubject

public void setSubject(String subject)
                throws javax.mail.MessagingException

Set the subject of the message, using the correct encoding.

参数:

subject - the subject text

抛出:

javax.mail.MessagingException - in case of errors

setText

public void setText(String text)
             throws javax.mail.MessagingException

Set the given text directly as content in non-multipart mode or as default body part in multipart mode. Always applies the default content type "text/plain".

NOTE: Invoke addInline(java.lang.String, javax.activation.DataSource) after setText; else, mail readers might not be able to resolve inline references correctly.

参数:

text - the text for the message

抛出:

javax.mail.MessagingException - in case of errors

setText

public void setText(String text,
           boolean html)
             throws javax.mail.MessagingException

Set the given text directly as content in non-multipart mode or as default body part in multipart mode. The "html" flag determines the content type to apply.

NOTE: Invoke addInline(java.lang.String, javax.activation.DataSource) after setText; else, mail readers might not be able to resolve inline references correctly.

参数:

text - the text for the message

html - whether to apply content type "text/html" for an HTML mail, using default content type ("text/plain") else

抛出:

javax.mail.MessagingException - in case of errors

setText

public void setText(String plainText,
           String htmlText)
             throws javax.mail.MessagingException

Set the given plain text and HTML text as alternatives, offering both options to the email client. Requires multipart mode.

NOTE: Invoke addInline(java.lang.String, javax.activation.DataSource) after setText; else, mail readers might not be able to resolve inline references correctly.

参数:

plainText - the plain text for the message

htmlText - the HTML text for the message

抛出:

javax.mail.MessagingException - in case of errors

addInline

public void addInline(String contentId,
             DataSource dataSource)
               throws javax.mail.MessagingException

Add an inline element to the MimeMessage, taking the content from a javax.activation.DataSource.

Note that the InputStream returned by the DataSource implementation needs to be a fresh one on each call, as JavaMail will invoke getInputStream() multiple times.

NOTE: Invoke addInline after setText(java.lang.String); else, mail readers might not be able to resolve inline references correctly.

参数:

contentId - the content ID to use. Will end up as "Content-ID" header in the body part, surrounded by angle brackets: e.g. "myId" -> "<myId>". Can be referenced in HTML source via src="cid:myId" expressions.

dataSource - the javax.activation.DataSource to take the content from, determining the InputStream and the content type

抛出:

javax.mail.MessagingException - in case of errors

另请参阅:

addInline(String, java.io.File), #addInline(String, org.springframework.core.io.Resource)

addInline

public void addInline(String contentId,
             File file)
               throws javax.mail.MessagingException

Add an inline element to the MimeMessage, taking the content from a java.io.File.

The content type will be determined by the name of the given content file. Do not use this for temporary files with arbitrary filenames (possibly ending in ".tmp" or the like)!

NOTE: Invoke addInline after setText(java.lang.String); else, mail readers might not be able to resolve inline references correctly.

参数:

contentId - the content ID to use. Will end up as "Content-ID" header in the body part, surrounded by angle brackets: e.g. "myId" -> "<myId>". Can be referenced in HTML source via src="cid:myId" expressions.

file - the File resource to take the content from

抛出:

javax.mail.MessagingException - in case of errors

另请参阅:

setText(java.lang.String), #addInline(String, org.springframework.core.io.Resource), addInline(String, javax.activation.DataSource)

addAttachment

public void addAttachment(String attachmentFilename,
                 DataSource dataSource)
                   throws javax.mail.MessagingException

Add an attachment to the MimeMessage, taking the content from a javax.activation.DataSource.

Note that the InputStream returned by the DataSource implementation needs to be a fresh one on each call, as JavaMail will invoke getInputStream() multiple times.

参数:

attachmentFilename - the name of the attachment as it will appear in the mail (the content type will be determined by this)

dataSource - the javax.activation.DataSource to take the content from, determining the InputStream and the content type

抛出:

javax.mail.MessagingException - in case of errors

另请参阅:

#addAttachment(String, org.springframework.core.io.InputStreamSource), addAttachment(String, java.io.File)

addAttachment

public void addAttachment(String attachmentFilename,
                 File file)
                   throws javax.mail.MessagingException

Add an attachment to the MimeMessage, taking the content from a java.io.File.

The content type will be determined by the name of the given content file. Do not use this for temporary files with arbitrary filenames (possibly ending in ".tmp" or the like)!

参数:

attachmentFilename - the name of the attachment as it will appear in the mail

file - the File resource to take the content from

抛出:

javax.mail.MessagingException - in case of errors

另请参阅:

#addAttachment(String, org.springframework.core.io.InputStreamSource), addAttachment(String, javax.activation.DataSource)