org.simplejavamail.converter.internal.mimemessage

Class MimeMessageHelper

java.lang.Object

org.simplejavamail.converter.internal.mimemessage.MimeMessageHelper

public final class MimeMessageHelper
extends Object

Helper class that deals with javax.mail RFC MimeMessage stuff, as well as DKIM signing.

Method Summary

Modifier and Type	Method and Description
static javax.mail.internet.MimeMessage	produceMimeMessage(Email email, javax.mail.Session session) Creates a new MimeMessage instance coupled to a specific Session instance and prepares it in the email structure, so that it can be filled and send.
static javax.mail.internet.MimeMessage	signMessageWithDKIM(javax.mail.internet.MimeMessage message, Email email) Primes the MimeMessage instance for signing with DKIM.

Methods inherited from class java.lang.Object

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

Method Detail

produceMimeMessage

public static javax.mail.internet.MimeMessage produceMimeMessage(Email email,
                                                                 javax.mail.Session session)
                                                          throws javax.mail.MessagingException,
                                                                 UnsupportedEncodingException

Creates a new MimeMessage instance coupled to a specific Session instance and prepares it in the email structure, so that it can be filled and send.

Fills subject, from,reply-to, content, sent-date, recipients, texts, embedded images, attachments, content and adds all headers.

Parameters:

email - The email message from which the subject and From-address are extracted.

session - The Session to attach the MimeMessage to

Returns:

A fully preparated Message instance, ready to be sent.

Throws:

javax.mail.MessagingException - May be thrown when the message couldn't be processed by JavaMail.

UnsupportedEncodingException - Zie InternetAddress.InternetAddress(String, String).

See Also:

setRecipients(Email, Message), setTexts(Email, MimeMultipart), setEmbeddedImages(Email, MimeMultipart), setAttachments(Email, MimeMultipart)

signMessageWithDKIM

public static javax.mail.internet.MimeMessage signMessageWithDKIM(javax.mail.internet.MimeMessage message,
                                                                  Email email)

Primes the MimeMessage instance for signing with DKIM. The signing itself is performed by DkimMessage and DkimSigner during the physical sending of the message.

Parameters:

message - The message to be signed when sent.

email - The Email that contains the relevant signing information

Returns:

The original mime message wrapped in a new one that performs signing when sent.