org.hibernate.validator.internal.constraintvalidators.hv

Class EmailValidator

java.lang.Object

org.hibernate.validator.internal.constraintvalidators.hv.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, Guillaume Smet

Constructor Summary

Constructors

Constructor and Description
EmailValidator()

Method Summary

Modifier and Type	Method and Description
void	initialize(Email annotation) Initializes the validator in preparation for ConstraintValidator.isValid(Object, ConstraintValidatorContext) calls.
boolean	isValid(CharSequence value, ConstraintValidatorContext context) Implements 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

Initializes the validator in preparation for ConstraintValidator.isValid(Object, ConstraintValidatorContext) 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.

The default implementation is a no-op.

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

Implements 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