javax.validation

Interface ConstraintValidator<A extends Annotation,T>

All Known Implementing Classes:

AssertFalseValidator, AssertTrueValidator, CreditCardNumberValidator, DecimalMaxValidatorForNumber, DecimalMaxValidatorForString, DecimalMinValidatorForNumber, DecimalMinValidatorForString, DigitsValidatorForNumber, DigitsValidatorForString, EmailValidator, FutureValidatorForCalendar, FutureValidatorForDate, FutureValidatorForReadableInstant, FutureValidatorForReadablePartial, LengthValidator, MaxValidatorForNumber, MaxValidatorForString, MinValidatorForNumber, MinValidatorForString, NotBlankValidator, NotNullValidator, NullValidator, PastValidatorForCalendar, PastValidatorForDate, PastValidatorForReadableInstant, PastValidatorForReadablePartial, PatternValidator, SafeHtmlValidator, ScriptAssertValidator, SizeValidatorForArray, SizeValidatorForArraysOfBoolean, SizeValidatorForArraysOfByte, SizeValidatorForArraysOfChar, SizeValidatorForArraysOfDouble, SizeValidatorForArraysOfFloat, SizeValidatorForArraysOfInt, SizeValidatorForArraysOfLong, SizeValidatorForArraysOfShort, SizeValidatorForCollection, SizeValidatorForMap, SizeValidatorForString, URLValidator

public interface ConstraintValidator<A extends Annotation,T>

Defines the logic to validate a given constraint A for a given object type T. Implementations must comply to the following restriction:

• T must resolve to a non parameterized type
• or generic parameters of T must be unbounded wildcard types

Author:

Emmanuel Bernard, Hardy Ferentschik

Method Summary

Methods

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

Method Detail

initialize

void initialize(A constraintAnnotation)

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.

Parameters:

constraintAnnotation - annotation instance for a given constraint declaration

isValid

boolean isValid(T value,
              ConstraintValidatorContext context)

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.

Parameters:

value - object to validate

context - context in which the constraint is evaluated

Returns:

false if value does not pass the constraint