org.codemonkey.simplejavamail

Class EmailAddressValidationCriteria

java.lang.Object

org.codemonkey.simplejavamail.EmailAddressValidationCriteria

public class EmailAddressValidationCriteria
extends Object

Defines a set of restriction flags for email address validation. To remain completely true to RFC 2822, all flags should be set to true.

Author:

Benny Bottema

See Also:

EmailAddressValidationCriteria(boolean, boolean)

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	allowDomainLiterals
private boolean	allowQuotedIdentifiers
static EmailAddressValidationCriteria	RFC_COMPLIANT Criteria which is most RFC 2822 compliant and allows all compiant address forms, including the more exotic ones.

Constructor Summary

Constructors

Constructor and Description
EmailAddressValidationCriteria(boolean allowDomainLiterals, boolean allowQuotedIdentifiers)

Method Summary

Modifier and Type	Method and Description
boolean	isAllowDomainLiterals()
boolean	isAllowQuotedIdentifiers()

Methods inherited from class java.lang.Object

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

Field Detail

allowDomainLiterals

private final boolean allowDomainLiterals

allowQuotedIdentifiers

private final boolean allowQuotedIdentifiers

RFC_COMPLIANT

public static final EmailAddressValidationCriteria RFC_COMPLIANT

Criteria which is most RFC 2822 compliant and allows all compiant address forms, including the more exotic ones.

See Also:

EmailAddressValidationCriteria(boolean, boolean)

Constructor Detail

EmailAddressValidationCriteria

public EmailAddressValidationCriteria(boolean allowDomainLiterals,
                                      boolean allowQuotedIdentifiers)

Parameters:

allowDomainLiterals -

• This flag states whether domain literals are allowed in the email address, e.g.:

  someone@[192.168.1.100] or
  john.doe@[23:33:A2:22:16:1F] or
  me@[my computer]

  The RFC says these are valid email addresses, but most people don't like allowing them. If you don't want to allow them, and only want to allow valid domain names (RFC 1035, x.y.z.com, etc), change this constant to false.

  Its default value is true to remain RFC 2822 compliant, but you should set it depending on what you need for your application.

allowQuotedIdentifiers -

• This flag states whether quoted identifiers are allowed (using quotes and angle brackets around the raw address) are allowed, e.g.:

  "John Smith" <john.smith@somewhere.com>

  The RFC says this is a valid mailbox. If you don't want to allow this, because for example, you only want users to enter in a raw address (john.smith@somewhere.com - no quotes or angle brackets), then change this constant to false.

  Its default value is true to remain RFC 2822 compliant, but you should set it depending on what you need for your application.

Method Detail

isAllowDomainLiterals

public final boolean isAllowDomainLiterals()

isAllowQuotedIdentifiers

public final boolean isAllowQuotedIdentifiers()