votorola.g.mail

Class InternetAddressX

java.lang.Object

InternetAddressX

@ThreadSafe
public final class InternetAddressX
extends Object

Internet (email) address utilities.

See Also:

ietf.org/html/rfc822

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	VALID_PATTERN_BARE_DOMNAME The pattern of valid email address consisting of the bare addr-spec having no personal part and no angle braces, and with no domain literals (like joe@[192.168.1.100]).

Method Summary

Methods

Modifier and Type	Method and Description
static String	canonicalAddress(String address) Converts an email address to canonical form.
static void	canonicalize(InternetAddress iAddress) Converts an email address to canonical form.
static String	localPart(InternetAddress iAddress) Returns the local-part of the address.
static String	localPart(String addrSpec) Returns the local-part of the address.
static String	newValidAddress(String loc, String dom) Constructs an email address from a local-part and a domain name, and validates it.
static UnsupportedEncodingException	trySetPersonal(InternetAddress iAddress, String name) Same as setPersonal(name), but returns any UnsupportedEncodingException that occurs, rather than throwing it.
static UnsupportedEncodingException	trySetPersonal(InternetAddress iAddress, String name, String charset) Same as setPersonal(name,charset), but returns any UnsupportedEncodingException that occurs, rather than throwing it.

Methods inherited from class java.lang.Object

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

Field Detail

VALID_PATTERN_BARE_DOMNAME

public static final Pattern VALID_PATTERN_BARE_DOMNAME

The pattern of valid email address consisting of the bare addr-spec having no personal part and no angle braces, and with no domain literals (like joe@[192.168.1.100]).

See Also:

AddressValidationP

Method Detail

canonicalAddress

public static String canonicalAddress(String address)
                               throws AddressException

Converts an email address to canonical form. The canonical form is the bare addr-spec having no personal part and no angle braces, and with the domain name in lower case. This method does strict parsing.

Throws:

AddressException

See Also:

canonicalize(InternetAddress), VALID_PATTERN_BARE_DOMNAME

canonicalize

public static void canonicalize(InternetAddress iAddress)

Converts an email address to canonical form.

See Also:

canonicalAddress(String)

localPart

public static String localPart(InternetAddress iAddress)
                        throws AddressException

Returns the local-part of the address. This is the part prior to the '@' character in the addr-spec. It is typically a user name.

Parameters:

iAddress - a single (non-group) address

Throws:

AddressException - if the address is a group address, or contains no local-part

localPart

public static String localPart(String addrSpec)
                        throws AddressException

Returns the local-part of the address. This is the part prior to the '@' character. It is typically a user name.

Parameters:

addrSpec - the bare addr-spec of an email address, having no personal part and no angle braces

Throws:

AddressException - if addrSpec contains no local-part

newValidAddress

public static String newValidAddress(String loc,
                     String dom)
                              throws AddressException

Constructs an email address from a local-part and a domain name, and validates it.

Parameters:

loc - the local-part

dom - the domain name

Throws:

AddressException - if loc or dom is null, or if the resulting address cannot be validated

See Also:

VALID_PATTERN_BARE_DOMNAME

trySetPersonal

public static UnsupportedEncodingException trySetPersonal(InternetAddress iAddress,
                                          String name)

Same as setPersonal(name), but returns any UnsupportedEncodingException that occurs, rather than throwing it.

Returns:

any UnsupportedEncodingException that occured

trySetPersonal

public static UnsupportedEncodingException trySetPersonal(InternetAddress iAddress,
                                          String name,
                                          String charset)

Same as setPersonal(name,charset), but returns any UnsupportedEncodingException that occurs, rather than throwing it.

Returns:

any UnsupportedEncodingException that occured