org.apache.commons.validator

Class EmailValidator


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

Since:
Validator 1.1

Field Summary

private static java.lang.String
ATOM
private static java.lang.String
ATOM_PATTERN
private static java.lang.String
DOMAIN_PATTERN
private static java.lang.String
EMAIL_PATTERN
private static java.lang.String
IP_DOMAIN_PATTERN
private static java.lang.String
LEGAL_ASCII_PATTERN
private static java.lang.String
QUOTED_USER
private static java.lang.String
SPECIAL_CHARS
private static java.lang.String
USER_PATTERN
private static java.lang.String
VALID_CHARS
private static java.lang.String
WORD
private static EmailValidator
instance
Singleton instance of this class.

Constructor Summary

EmailValidator()
Protected constructor for subclasses to use.

Method Summary

static EmailValidator
getInstance()
Returns the Singleton instance of this validator.
boolean
isValid(java.lang.String email)
Checks if a field has a valid e-mail address.
protected boolean
isValidDomain(java.lang.String domain)
Returns true if the domain component of an email address is valid.
protected boolean
isValidIpAddress(Perl5Util ipAddressMatcher)
Validates an IP address.
protected boolean
isValidSymbolicDomain(java.lang.String domain)
Validates a symbolic domain name.
protected boolean
isValidUser(java.lang.String user)
Returns true if the user component of an email address is valid.

Field Details

ATOM

private static final java.lang.String ATOM

Field Value:
"[^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+"


ATOM_PATTERN

private static final java.lang.String ATOM_PATTERN

Field Value:
"/([^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+)/"


DOMAIN_PATTERN

private static final java.lang.String DOMAIN_PATTERN

Field Value:
"/^[^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+(\\.[^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+)*$/"


EMAIL_PATTERN

private static final java.lang.String EMAIL_PATTERN

Field Value:
"/^(.+)@(.+)$/"


IP_DOMAIN_PATTERN

private static final java.lang.String IP_DOMAIN_PATTERN

Field Value:
"/^(\\d{1,3})[.](\\d{1,3})[.](\\d{1,3})[.](\\d{1,3})$/"


LEGAL_ASCII_PATTERN

private static final java.lang.String LEGAL_ASCII_PATTERN

Field Value:
"/^[\\000-\\177]+$/"


QUOTED_USER

private static final java.lang.String QUOTED_USER

Field Value:
"(\\"[^\\"]*\\")"


SPECIAL_CHARS

private static final java.lang.String SPECIAL_CHARS

Field Value:
"\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]"


USER_PATTERN

private static final java.lang.String USER_PATTERN

Field Value:
"/^([^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+|(\\"[^\\"]*\\"))(\\.([^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+|(\\"[^\\"]*\\")))*$/"


VALID_CHARS

private static final java.lang.String VALID_CHARS

Field Value:
"[^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]"


WORD

private static final java.lang.String WORD

Field Value:
"([^\\s\\(\\)<>@,;:\\\\\\\\"\\.\\[\\]]+|(\\"[^\\"]*\\"))"


instance

private static final EmailValidator instance
Singleton instance of this class.

Constructor Details

EmailValidator

protected EmailValidator()
Protected constructor for subclasses to use.

Method Details

getInstance

public static EmailValidator getInstance()
Returns the Singleton instance of this validator.


isValid

public boolean isValid(java.lang.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.


isValidDomain

protected boolean isValidDomain(java.lang.String domain)
Returns true if the domain component of an email address is valid.

Parameters:
domain - being validatied.


isValidIpAddress

protected boolean isValidIpAddress(Perl5Util ipAddressMatcher)
Validates an IP address. Returns true if valid.

Parameters:
ipAddressMatcher - Pattren matcher


isValidSymbolicDomain

protected boolean isValidSymbolicDomain(java.lang.String domain)
Validates a symbolic domain name. Returns true if it's valid.

Parameters:
domain - symbolic domain name


isValidUser

protected boolean isValidUser(java.lang.String user)
Returns true if the user component of an email address is valid.

Parameters:
user - being validated


Copyright (c) 2001-2004 Apache Software Foundation