de.alpharogroup.email.utils

Class EmailExtensions

java.lang.Object

de.alpharogroup.email.utils.EmailExtensions

public class EmailExtensions
extends Object

The class EmailExtensions provides methods for create email addresses and validate email addresses.

Constructor Summary

Constructors

Constructor and Description
EmailExtensions()

Method Summary

Modifier and Type	Method and Description
static EmailMessage	addToRecipientToEmailMessage(String recipientEmail, String recipientPersonal, String recipientCharset, EmailMessage emailMessage) Adds a 'to' recipient to the email message.
static Address[]	getAddressArray(Address... address) Gets the address array from the given address objects.
static String	getCharsetFromContentType(String type) Gets the encoding from the header.
static String	getString(DataHandler dataHandler) Gets the string from the given DataHandler.
static Address	newAddress(String address) Creates an Address from the given the email address as String object.
static Address	newAddress(String emailAddress, String personal) Creates from the given the address and personal name an Adress-object.
static Address	newAddress(String address, String personal, String charset) Creates an Address from the given the address and personal name.
static EmailMessage	setFromToEmailMessage(String senderEmail, String senderPersonal, String senderCharset, EmailMessage emailMessage) Sets the from to the email message.
static boolean	validateEmailAdress(String emailAddress) Validate the given email address.

Methods inherited from class java.lang.Object

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

Constructor Detail

EmailExtensions

public EmailExtensions()

Method Detail

addToRecipientToEmailMessage

public static EmailMessage addToRecipientToEmailMessage(String recipientEmail,
                                                        String recipientPersonal,
                                                        String recipientCharset,
                                                        EmailMessage emailMessage)
                                                 throws UnsupportedEncodingException,
                                                        MessagingException

Adds a 'to' recipient to the email message.

Parameters:

recipientEmail - the recipient email

recipientPersonal - the recipient personal

recipientCharset - the recipient charset

emailMessage - the email message

Returns:

the email message

Throws:

UnsupportedEncodingException - is thrown if the encoding not supported

MessagingException - is thrown if the underlying implementation does not support modification of existing values

getAddressArray

public static Address[] getAddressArray(Address... address)

Gets the address array from the given address objects.

Parameters:

address - the address

Returns:

the address array

getCharsetFromContentType

public static String getCharsetFromContentType(String type)
                                        throws MessagingException

Gets the encoding from the header.

Parameters:

type - The string where the encoding is in.

Returns:

's the encoding or null if its nothing found.

Throws:

MessagingException - is thrown if the underlying implementation does not support modification of existing values

getString

public static String getString(DataHandler dataHandler)
                        throws IOException

Gets the string from the given DataHandler.

Parameters:

dataHandler - the data handler

Returns:

the string

Throws:

IOException - Signals that an I/O exception has occurred.

newAddress

public static Address newAddress(String address)
                          throws AddressException,
                                 UnsupportedEncodingException

Creates an Address from the given the email address as String object.

Parameters:

address - The address in RFC822 format.

Returns:

The created InternetAddress-object from the given address.

Throws:

UnsupportedEncodingException - is thrown if the encoding not supported

AddressException - is thrown if the parse failed

newAddress

public static Address newAddress(String emailAddress,
                                 String personal)
                          throws AddressException,
                                 UnsupportedEncodingException

Creates from the given the address and personal name an Adress-object.

Parameters:

emailAddress - The address in RFC822 format.

personal - The personal name.

Returns:

The created Adress-object from the given address and personal name.

Throws:

UnsupportedEncodingException - is thrown if the encoding not supported

AddressException - is thrown if the parse failed

newAddress

public static Address newAddress(String address,
                                 String personal,
                                 String charset)
                          throws AddressException,
                                 UnsupportedEncodingException

Creates an Address from the given the address and personal name.

Parameters:

address - The address in RFC822 format.

personal - The personal name.

charset - MIME charset to be used to encode the name as per RFC 2047.

Returns:

The created InternetAddress-object from the given address and personal name.

Throws:

AddressException - is thrown if the parse failed

UnsupportedEncodingException - is thrown if the encoding not supported

setFromToEmailMessage

public static EmailMessage setFromToEmailMessage(String senderEmail,
                                                 String senderPersonal,
                                                 String senderCharset,
                                                 EmailMessage emailMessage)
                                          throws UnsupportedEncodingException,
                                                 MessagingException

Sets the from to the email message.

Parameters:

senderEmail - the sender email

senderPersonal - the sender personal

senderCharset - the sender charset

emailMessage - the email message

Returns:

the email message

Throws:

UnsupportedEncodingException - is thrown if the encoding not supported

MessagingException - is thrown if the underlying implementation does not support modification of existing values

validateEmailAdress

public static boolean validateEmailAdress(String emailAddress)

Validate the given email address.

Parameters:

emailAddress - the email address

Returns:

true, if successful