Package org.apache.commons.validator

Class EmailValidator

java.lang.Object

org.apache.commons.validator.EmailValidator

Deprecated.

Use the new EmailValidator in the routines package. This class will be removed in a future release.

public class EmailValidator
extends java.lang.Object

Perform email validations.

This class is a Singleton; you can retrieve the instance via the getInstance() method.

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

This implementation is not guaranteed to catch all possible errors in an email address. For example, an address like nobody@noplace.somedog will pass validator, even though there is no TLD "somedog"

.

Since:

Validator 1.1

Version:

$Revision: 1649191 $

Field Summary

Fields

Modifier and Type	Field	Description
private static java.lang.String	ATOM	Deprecated.
private static java.util.regex.Pattern	ATOM_PATTERN	Deprecated.
private static java.util.regex.Pattern	DOMAIN_PATTERN	Deprecated.
private static EmailValidator	EMAIL_VALIDATOR	Deprecated. Singleton instance of this class.
private static java.util.regex.Pattern	IP_DOMAIN_PATTERN	Deprecated.
private static java.lang.String	QUOTED_USER	Deprecated.
private static java.lang.String	SPECIAL_CHARS	Deprecated.
private static java.util.regex.Pattern	TLD_PATTERN	Deprecated.
private static java.util.regex.Pattern	USER_PATTERN	Deprecated.
private static java.lang.String	VALID_CHARS	Deprecated.
private static java.lang.String	WORD	Deprecated.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EmailValidator()	Deprecated. Protected constructor for subclasses to use.

Method Summary

Modifier and Type	Method	Description
static EmailValidator	getInstance()	Deprecated. Returns the Singleton instance of this validator.
boolean	isValid(java.lang.String email)	Deprecated. Checks if a field has a valid e-mail address.
protected boolean	isValidDomain(java.lang.String domain)	Deprecated. Returns true if the domain component of an email address is valid.
protected boolean	isValidIpAddress(java.lang.String ipAddress)	Deprecated. Validates an IP address.
protected boolean	isValidSymbolicDomain(java.lang.String domain)	Deprecated. Validates a symbolic domain name.
protected boolean	isValidUser(java.lang.String user)	Deprecated. Returns true if the user component of an email address is valid.
protected java.lang.String	stripComments(java.lang.String emailStr)	Deprecated. Recursively remove comments, and replace with a single space.

Methods inherited from class java.lang.Object

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

Field Detail

SPECIAL_CHARS

private static final java.lang.String SPECIAL_CHARS

Deprecated.

See Also:

Constant Field Values

VALID_CHARS

private static final java.lang.String VALID_CHARS

Deprecated.

See Also:

Constant Field Values

QUOTED_USER

private static final java.lang.String QUOTED_USER

Deprecated.

See Also:

Constant Field Values

ATOM

private static final java.lang.String ATOM

Deprecated.

See Also:

Constant Field Values

WORD

private static final java.lang.String WORD

Deprecated.

See Also:

Constant Field Values

IP_DOMAIN_PATTERN

private static final java.util.regex.Pattern IP_DOMAIN_PATTERN

Deprecated.

TLD_PATTERN

private static final java.util.regex.Pattern TLD_PATTERN

Deprecated.

USER_PATTERN

private static final java.util.regex.Pattern USER_PATTERN

Deprecated.

DOMAIN_PATTERN

private static final java.util.regex.Pattern DOMAIN_PATTERN

Deprecated.

ATOM_PATTERN

private static final java.util.regex.Pattern ATOM_PATTERN

Deprecated.

EMAIL_VALIDATOR

private static final EmailValidator EMAIL_VALIDATOR

Deprecated.

Singleton instance of this class.

Constructor Detail

EmailValidator

protected EmailValidator()

Deprecated.

Protected constructor for subclasses to use.

Method Detail

getInstance

public static EmailValidator getInstance()

Deprecated.

Returns the Singleton instance of this validator.

Returns:

singleton instance of this validator.

isValid

public boolean isValid(java.lang.String email)

Deprecated.

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(java.lang.String domain)

Deprecated.

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

Parameters:

domain - being validated.

Returns:

true if the email address's domain is valid.

isValidUser

protected boolean isValidUser(java.lang.String user)

Deprecated.

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

Parameters:

user - being validated

Returns:

true if the user name is valid.

isValidIpAddress

protected boolean isValidIpAddress(java.lang.String ipAddress)

Deprecated.

Validates an IP address. Returns true if valid.

Parameters:

ipAddress - IP address

Returns:

true if the ip address is valid.

isValidSymbolicDomain

protected boolean isValidSymbolicDomain(java.lang.String domain)

Deprecated.

Validates a symbolic domain name. Returns true if it's valid.

Parameters:

domain - symbolic domain name

Returns:

true if the symbolic domain name is valid.

stripComments

protected java.lang.String stripComments(java.lang.String emailStr)

Deprecated.

Recursively remove comments, and replace with a single space. The simpler regexps in the Email Addressing FAQ are imperfect - they will miss escaped chars in atoms, for example. Derived From Mail::RFC822::Address

Parameters:

emailStr - The email address

Returns:

address with comments removed.