jodd.mail

Class EmailAddress

java.lang.Object

jodd.mail.EmailAddress

public class EmailAddress
extends java.lang.Object

Storage for personal name and email address. Serves as an email address adapter between various formats.

Field Summary

Fields

Modifier and Type	Field and Description
static EmailAddress[]	EMPTY_ARRAY

Constructor Summary

Constructors

Constructor and Description
EmailAddress(java.lang.String personalName, java.lang.String email) Creates new address by specifying email and personal name.

Method Summary

Modifier and Type	Method and Description
static jakarta.mail.internet.InternetAddress[]	convert(EmailAddress[] addresses) Convert from array of EmailAddress to array of InternetAddress.
java.lang.String	getEmail() Returns email address.
java.lang.String	getPersonalName() Returns personal name.
static EmailAddress[]	of(jakarta.mail.Address... addresses) Converts array of Address to EmailAddress.
static EmailAddress	of(jakarta.mail.Address address) Creates new email address from InternetAddress.
static EmailAddress	of(jakarta.mail.internet.InternetAddress internetAddress) Creates new email address from InternetAddress.
static EmailAddress[]	of(java.lang.String... addresses) Converts array of String to EmailAddress.
static EmailAddress	of(java.lang.String address) Creates new address by specifying one of the following: "foo@bar.com" - only email address. "Jenny Doe &lt;foo@bar.com&gt;" - first part of the string is personal name, and the other part is email, surrounded with < and >.
static EmailAddress	of(java.lang.String personalName, java.lang.String email)
jakarta.mail.internet.InternetAddress	toInternetAddress() Creates new InternetAddress from current data.
java.lang.String	toString() Returns string representation of this.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_ARRAY

public static final EmailAddress[] EMPTY_ARRAY

Constructor Detail

EmailAddress

public EmailAddress(java.lang.String personalName,
                    java.lang.String email)

Creates new address by specifying email and personal name.

Parameters:

personalName - personal name.

email - email address.

Method Detail

of

public static EmailAddress of(java.lang.String personalName,
                              java.lang.String email)

See Also:

EmailAddress(String, String)

of

public static EmailAddress of(java.lang.String address)

Creates new address by specifying one of the following:

• "foo@bar.com" - only email address.
• "Jenny Doe &lt;foo@bar.com&gt;" - first part of the string is personal name, and the other part is email, surrounded with < and >.

Parameters:

address - String containing address to convert.

of

public static EmailAddress of(jakarta.mail.internet.InternetAddress internetAddress)

Creates new email address from InternetAddress.

Parameters:

internetAddress - InternetAddress to convert

of

public static EmailAddress of(jakarta.mail.Address address)

Creates new email address from InternetAddress.

Parameters:

address - Address to convert.

getEmail

public java.lang.String getEmail()

Returns email address.

Returns:

email address.

getPersonalName

public java.lang.String getPersonalName()

Returns personal name.

Returns:

personal name. Value may be null.

toString

public java.lang.String toString()

Returns string representation of this.

Overrides:

toString in class java.lang.Object

Returns:

String representation of this.

toInternetAddress

public jakarta.mail.internet.InternetAddress toInternetAddress()
                                                        throws jakarta.mail.internet.AddressException

Creates new InternetAddress from current data.

Returns:

InternetAddress from current data.

Throws:

jakarta.mail.internet.AddressException

of

public static EmailAddress[] of(jakarta.mail.Address... addresses)

Converts array of Address to EmailAddress.

Parameters:

addresses - array of Addresses to convert.

Returns:

an array of EmailAddress.

of

public static EmailAddress[] of(java.lang.String... addresses)

Converts array of String to EmailAddress.

Parameters:

addresses - array of Strings to convert.

Returns:

an array of EmailAddress.

convert

public static jakarta.mail.internet.InternetAddress[] convert(EmailAddress[] addresses)
                                                       throws jakarta.mail.MessagingException

Convert from array of EmailAddress to array of InternetAddress.

Parameters:

addresses - EmailMessage

Returns:

array of InternetAddress. Returns empty array if addresses was null.

Throws:

jakarta.mail.MessagingException - if there are failures