org.hibernate.validator.internal.constraintvalidators

Class EmailValidator

java.lang.Object

org.hibernate.validator.internal.constraintvalidators.EmailValidator

All Implemented Interfaces:

ConstraintValidator<Email,CharSequence>

public class EmailValidator
extends Object
implements ConstraintValidator<Email,CharSequence>

Checks that a given character sequence (e.g. string) is a well-formed email address.

The specification of a valid email can be found in RFC 2822 and one can come up with a regular expression matching all valid email addresses as per specification. However, as this article discusses it is not necessarily practical to implement a 100% compliant email validator. This implementation is a trade-off trying to match most email while ignoring for example emails with double quotes or comments.

Author:

Emmanuel Bernard, Hardy Ferentschik

Constructor Summary

Constructors

Constructor and Description
EmailValidator()

Method Summary

Methods

Modifier and Type	Method and Description
void	initialize(Email annotation) Initialize the validator in preparation for isValid calls.
boolean	isValid(CharSequence value, ConstraintValidatorContext context) Implement the validation logic.

Methods inherited from class java.lang.Object

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

Constructor Detail

EmailValidator

public EmailValidator()

Method Detail

initialize

public void initialize(Email annotation)

Description copied from interface: ConstraintValidator

Initialize the validator in preparation for isValid calls. The constraint annotation for a given constraint declaration is passed.

This method is guaranteed to be called before any use of this instance for validation.

Specified by:

initialize in interface ConstraintValidator<Email,CharSequence>

Parameters:

annotation - annotation instance for a given constraint declaration

isValid

public boolean isValid(CharSequence value,
              ConstraintValidatorContext context)

Description copied from interface: ConstraintValidator

Implement the validation logic. The state of value must not be altered. This method can be accessed concurrently, thread-safety must be ensured by the implementation.

Specified by:

isValid in interface ConstraintValidator<Email,CharSequence>

Parameters:

value - object to validate

context - context in which the constraint is evaluated

Returns:

false if value does not pass the constraint