com.atlassian.mail

Class MailUtils

java.lang.Object

com.atlassian.mail.MailUtils

public class MailUtils
extends Object

This class contains a bunch of static helper methods that make life a bit easier particularly with the processing of Parts.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MailUtils.Attachment Very simple representation of a mail attachment after it has been extracted from a message.

Constructor Summary

Constructors

Constructor and Description
MailUtils()

Method Summary

Modifier and Type	Method and Description
static javax.mail.internet.MimeBodyPart	createAttachmentMimeBodyPart(String path) Produces a mimebodypart object from an attachment file path.
static javax.mail.internet.MimeBodyPart	createZippedAttachmentMimeBodyPart(String path)
static String	fixMimeEncodedFilename(String filename) This method may be used to fix any mime encoded filenames that have been returned by javamail.
static MailUtils.Attachment[]	getAttachments(javax.mail.Message message) Gets all parts of a message that are attachments rather than alternative inline bits.
static String	getBody(javax.mail.Message message) Get the body of the message as a String.
static String	getBody(javax.mail.Message message, GetBodyOptions options)
static String	getContentId(javax.mail.Part part) Return content id or empty string for given email part.
static String	getContentType(javax.mail.Part part) Helper which returns the pure mime/subMime content type less any other extra parameters which may accompany the header value.
static String	getContentType(String headerValue) Helper which extracts the content type from a header value removing parameters and so on.
static String	getLocalHostName() Get the local host name from InetAddress and return it in a form suitable for use in an email address or Message-ID.
static List<String>	getSenders(javax.mail.Message message) Returns a List of trimmed non-null email addresses from the given potentially dirty pile of addresses listed as senders on the given message.
static boolean	hasRecipient(String matchEmail, javax.mail.Message message)
static boolean	isAttachment(javax.mail.Part part)
static boolean	isContentEmpty(javax.mail.Part part) Tests if the content of the part content is empty.
static boolean	isIpAddress(String hostname) Returns true if the given host name is just an IP address, not a domain name
static boolean	isPartAttachment(javax.mail.Part part) Tests if the provided part is an attachment.
static boolean	isPartHtml(javax.mail.Part part) Tests if a particular part content type is text/html.
static boolean	isPartInline(javax.mail.Part part) This method uses a number of checks to determine if the given part actually represents an inline (typically image) part.
static boolean	isPartMessageType(javax.mail.Part part) Tests if the provided part's content type is message/rfc822
static boolean	isPartPlainText(javax.mail.Part part) Tests if the provided part content type is text/plain.
static boolean	isPartRelated(javax.mail.Part part) Tests if the provided part's content type is multipart/related
static boolean	isPartSignaturePKCS7(javax.mail.Part part) Tests if a part is actually a signature.
static javax.mail.internet.InternetAddress[]	parseAddresses(String addresses) Parse addresses from a comma (and space) separated string into the proper array

Methods inherited from class java.lang.Object

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

Constructor Detail

MailUtils

public MailUtils()

Method Detail

parseAddresses

public static javax.mail.internet.InternetAddress[] parseAddresses(String addresses)
                                                            throws javax.mail.internet.AddressException

Parse addresses from a comma (and space) separated string into the proper array

Throws:

javax.mail.internet.AddressException

getBody

public static String getBody(javax.mail.Message message)
                      throws javax.mail.MessagingException

Get the body of the message as a String. The algorithm for finding the body is as follows:

1. If the message is a single part, and that part is text/plain, return it.
2. If the message is a single part, and that part is text/html, convert it to text (stripping out the HTML) and return it.
3. If the message is multi-part, return the first text/plain part that isn't marked explicitly as an attachment.
4. If the message is multi-part, but does not contain any text/plain parts, return the first text/html part that isn't marked explicitly as an attachment, converting it to text and stripping the HTML.
5. If nothing is found in any of the steps above, return null.

Note: If the message contains nested multipart parts, an HTML part nested at a higher level will take precedence over a text part nested deeper.

Parameters:

message - The message to retrieve the body from

Returns:

The message body, or null if the message could not be parsed

Throws:

javax.mail.MessagingException - If there was an error getting the content from the message

getBody

public static String getBody(javax.mail.Message message,
                             GetBodyOptions options)
                      throws javax.mail.MessagingException

Throws:

javax.mail.MessagingException

Since:

v2.7.11

getAttachments

public static MailUtils.Attachment[] getAttachments(javax.mail.Message message)
                                             throws javax.mail.MessagingException,
                                                    IOException

Gets all parts of a message that are attachments rather than alternative inline bits.

Parameters:

message - the message from which to extract the attachments

Returns:

an array of the extracted attachments

Throws:

javax.mail.MessagingException

IOException

isAttachment

public static boolean isAttachment(javax.mail.Part part)
                            throws javax.mail.MessagingException

Throws:

javax.mail.MessagingException

hasRecipient

public static boolean hasRecipient(String matchEmail,
                                   javax.mail.Message message)
                            throws javax.mail.MessagingException

Returns:

true if at least one of the recipients matches the email address given.

Throws:

javax.mail.MessagingException

getSenders

public static List<String> getSenders(javax.mail.Message message)
                               throws javax.mail.MessagingException

Returns a List of trimmed non-null email addresses from the given potentially dirty pile of addresses listed as senders on the given message.

Parameters:

message - the message from which to get senders.

Returns:

a nice List of email addresses.

Throws:

javax.mail.MessagingException - if the senders can't be retrieved from message.

createAttachmentMimeBodyPart

public static javax.mail.internet.MimeBodyPart createAttachmentMimeBodyPart(String path)
                                                                     throws javax.mail.MessagingException

Produces a mimebodypart object from an attachment file path. An attachment needs to be in this form to be attached to an email for sending

Parameters:

path -

Returns:

Throws:

javax.mail.MessagingException

createZippedAttachmentMimeBodyPart

public static javax.mail.internet.MimeBodyPart createZippedAttachmentMimeBodyPart(String path)
                                                                           throws javax.mail.MessagingException

Throws:

javax.mail.MessagingException

isPartHtml

public static boolean isPartHtml(javax.mail.Part part)
                          throws javax.mail.MessagingException

Tests if a particular part content type is text/html.

Parameters:

part - The part being tested.

Returns:

true if the part content type is text/html

Throws:

javax.mail.MessagingException - if javamail complains

isPartPlainText

public static boolean isPartPlainText(javax.mail.Part part)
                               throws javax.mail.MessagingException

Tests if the provided part content type is text/plain.

Parameters:

part - The part being tested.

Returns:

true if the part content type is text/plain

Throws:

javax.mail.MessagingException - if javamail complains

isPartMessageType

public static boolean isPartMessageType(javax.mail.Part part)
                                 throws javax.mail.MessagingException

Tests if the provided part's content type is message/rfc822

Parameters:

part - The part being tested.

Returns:

true if the part content type is message/rfc822

Throws:

javax.mail.MessagingException - if javamail complains

isPartRelated

public static boolean isPartRelated(javax.mail.Part part)
                             throws javax.mail.MessagingException

Tests if the provided part's content type is multipart/related

Parameters:

part - The part being tested.

Returns:

true if the part content type is multipart/related

Throws:

javax.mail.MessagingException - if javamail complains

getContentType

public static String getContentType(javax.mail.Part part)
                             throws javax.mail.MessagingException

Helper which returns the pure mime/subMime content type less any other extra parameters which may accompany the header value.

Parameters:

part - the mail part to extract the content-type from.

Returns:

the pure mime/subMime type

Throws:

javax.mail.MessagingException - if retrieving the part's Content-Type header fails

getContentType

public static String getContentType(String headerValue)

Helper which extracts the content type from a header value removing parameters and so on.

Parameters:

headerValue - The header value.

Returns:

The actual content type

isContentEmpty

public static boolean isContentEmpty(javax.mail.Part part)
                              throws javax.mail.MessagingException,
                                     IOException

Tests if the content of the part content is empty. The definition of empty depends on whether the content is text or binary.

Text content for content types like plain/text and html/text is defined as being empty if it contains an empty string after doing a trim(). If the string contains 50 spaces it is still empty whilst a string with a solitary "a" isnt.

For binary content (like images) if the content contains 0 bytes it is empty whilst anything with 1 or more bytes is NOT considered empty.

Parameters:

part - a mail part - may or may not have content.

Returns:

true/false if the content is deemed empty as per above rules.

Throws:

javax.mail.MessagingException - if retrieving content fails.

IOException - if retrieving content fails or reading content input stream fails.

isPartInline

public static boolean isPartInline(javax.mail.Part part)
                            throws javax.mail.MessagingException

This method uses a number of checks to determine if the given part actually represents an inline (typically image) part. Some email clients (aka lotus notes) dont appear to correctly set the disposition to inline so a number of additional checks are required, hence the multi staged approached.

eg. inline images from notes wont have a inline disposition but will have a content id and will also have their content base64 encoded. This approach helps us correctly identify inline images or other binary parts.

Parameters:

part - The part being tested.

Returns:

True if the part is inline false in all other cases.

Throws:

javax.mail.MessagingException - as thrown by java mail

getContentId

public static String getContentId(javax.mail.Part part)
                           throws javax.mail.MessagingException

Return content id or empty string for given email part.

Parameters:

part - the email part

Returns:

content id (without the wrapping "< and >" character) or empty in case of content id is not there

Throws:

javax.mail.MessagingException

isPartAttachment

public static boolean isPartAttachment(javax.mail.Part part)
                                throws javax.mail.MessagingException

Tests if the provided part is an attachment. Note this method does not test if the content is empty etc it merely tests whether or not the part is an attachment of some sort.

Parameters:

part - The part being tested.

Throws:

javax.mail.MessagingException - if javamail complains

fixMimeEncodedFilename

public static String fixMimeEncodedFilename(String filename)
                                     throws IOException

This method may be used to fix any mime encoded filenames that have been returned by javamail. No harm can occur from calling this method unnecessarily except for wasting a few cpu cycles...

Very probably a MIME-encoded filename - see http://java.sun.com/products/javamail/FAQ.html#encodefilename

Parameters:

filename -

Returns:

The fixed filename.

Throws:

IOException - MimeUtility.decodeText(java.lang.String)

isPartSignaturePKCS7

public static boolean isPartSignaturePKCS7(javax.mail.Part part)
                                    throws javax.mail.MessagingException

Tests if a part is actually a signature. This is required to fix JRA-9933.

Parameters:

part - a mail part. The part is assumed to have a content-type header.

Returns:

true if the content-type header matches the standard PKCS7 mime types

Throws:

javax.mail.MessagingException - if retrieving the Content-Type from the part fails.

getLocalHostName

public static String getLocalHostName()

Get the local host name from InetAddress and return it in a form suitable for use in an email address or Message-ID.

isIpAddress

public static boolean isIpAddress(String hostname)

Returns true if the given host name is just an IP address, not a domain name

RFC 1123: 'a dotted-decimal number must be enclosed within "[ ]" brackets for SMTP mail'

Note that this method returning true does not guarantee that the value is a valid IP address, it just states that it is not a valid domain name, and it only contains valid characters for an IP address.

Parameters:

hostname - the host name to check

Returns:

true if the given host name is an IP address.