Package com.networknt.org.apache.commons.validator.routines

Class EmailValidator

java.lang.Object

com.networknt.org.apache.commons.validator.routines.EmailValidator

All Implemented Interfaces:

Serializable

public class EmailValidator
extends Object
implements Serializable

Perform email validations.

Based on a script by Sandeep V. Tamhankar https://javascript.internet.com

This implementation is not guaranteed to catch all possible errors in an email address.

.

Since:

1.4

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EmailValidator(boolean allowLocal)	Protected constructor for subclasses to use.
protected	EmailValidator(boolean allowLocal, boolean allowTld)	Protected constructor for subclasses to use.
	EmailValidator(boolean allowLocal, boolean allowTld, DomainValidator domainValidator)	constructor for creating instances with the specified domainValidator

Method Summary

Modifier and Type	Method	Description
static EmailValidator	getInstance()	Returns the Singleton instance of this validator.
static EmailValidator	getInstance(boolean allowLocal)	Returns the Singleton instance of this validator, with local validation as required.
static EmailValidator	getInstance(boolean allowLocal, boolean allowTld)	Returns the Singleton instance of this validator, with local validation as required.
boolean	isValid(String email)	Checks if a field has a valid e-mail address.
protected boolean	isValidDomain(String domain)	Returns true if the domain component of an email address is valid.
protected boolean	isValidUser(String user)	Returns true if the user component of an email address is valid.

Methods inherited from class java.lang.Object

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

Constructor Detail

EmailValidator

protected EmailValidator(boolean allowLocal)

Protected constructor for subclasses to use.

Parameters:

allowLocal - Should local addresses be considered valid?

EmailValidator

protected EmailValidator(boolean allowLocal,
                         boolean allowTld)

Protected constructor for subclasses to use.

Parameters:

allowLocal - Should local addresses be considered valid?

allowTld - Should TLDs be allowed?

EmailValidator

public EmailValidator(boolean allowLocal,
                      boolean allowTld,
                      DomainValidator domainValidator)

constructor for creating instances with the specified domainValidator

Parameters:

allowLocal - Should local addresses be considered valid?

allowTld - Should TLDs be allowed?

domainValidator - allow override of the DomainValidator. The instance must have the same allowLocal setting.

Since:

1.7

Method Detail

getInstance

public static EmailValidator getInstance()

Returns the Singleton instance of this validator.

Returns:

singleton instance of this validator.

getInstance

public static EmailValidator getInstance(boolean allowLocal)

Returns the Singleton instance of this validator, with local validation as required.

Parameters:

allowLocal - Should local addresses be considered valid?

Returns:

singleton instance of this validator

getInstance

public static EmailValidator getInstance(boolean allowLocal,
                                         boolean allowTld)

Returns the Singleton instance of this validator, with local validation as required.

Parameters:

allowLocal - Should local addresses be considered valid?

allowTld - Should TLDs be allowed?

Returns:

singleton instance of this validator

isValid

public boolean isValid(String email)

Checks if a field has a valid e-mail address.

Parameters:

email - The value validation is being performed on. A null value is considered invalid.

Returns:

true if the email address is valid.

isValidDomain

protected boolean isValidDomain(String domain)

Returns true if the domain component of an email address is valid.

Parameters:

domain - being validated, may be in IDN format

Returns:

true if the email address's domain is valid.

isValidUser

protected boolean isValidUser(String user)

Returns true if the user component of an email address is valid.

Parameters:

user - being validated

Returns:

true if the user name is valid.