Package org.hibernate.validator.internal.constraintvalidators.bv.time

Class AbstractJavaTimeValidator<C extends Annotation,T extends TemporalAccessor & Comparable<? super T>>

java.lang.Object

org.hibernate.validator.internal.constraintvalidators.bv.time.AbstractJavaTimeValidator<C,T>

All Implemented Interfaces:

ConstraintValidator<C,T>, HibernateConstraintValidator<C,T>

Direct Known Subclasses:

AbstractFutureJavaTimeValidator, AbstractFutureOrPresentJavaTimeValidator, AbstractPastJavaTimeValidator, AbstractPastOrPresentJavaTimeValidator

public abstract class AbstractJavaTimeValidator<C extends Annotation,T extends TemporalAccessor & Comparable<? super T>>
extends Object
implements HibernateConstraintValidator<C,T>

Base class for all time validators that are based on the java.time package.

Author:

Alaa Nassef, Guillaume Smet

Field Summary

Fields

Modifier and Type	Field	Description
protected Clock	referenceClock

Constructor Summary

Constructors

Constructor	Description
AbstractJavaTimeValidator()

Method Summary

Modifier and Type	Method	Description
protected abstract Duration	getEffectiveTemporalValidationTolerance(Duration absoluteTemporalValidationTolerance)	Returns the temporal validation tolerance to apply.
protected abstract T	getReferenceValue(Clock reference)	Returns an object of the validated type corresponding to the current time reference as provided by the ClockProvider.
void	initialize(ConstraintDescriptor<C> constraintDescriptor, HibernateConstraintValidatorInitializationContext initializationContext)	Initializes the validator in preparation for ConstraintValidator.isValid(Object, ConstraintValidatorContext) calls.
protected abstract boolean	isValid(int result)	Returns whether the result of the comparison between the validated value and the time reference is considered valid.
boolean	isValid(T 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

Methods inherited from interface jakarta.validation.ConstraintValidator

initialize

Field Detail

referenceClock

protected Clock referenceClock

Constructor Detail

AbstractJavaTimeValidator

public AbstractJavaTimeValidator()

Method Detail

initialize

public void initialize(ConstraintDescriptor<C> constraintDescriptor,
                       HibernateConstraintValidatorInitializationContext initializationContext)

Description copied from interface: HibernateConstraintValidator

Initializes the validator in preparation for ConstraintValidator.isValid(Object, ConstraintValidatorContext) calls. It is an alternative to ConstraintValidator.initialize(Annotation) method. Should be used if any additional information except annotation is needed to initialize a validator. Note, when using HibernateConstraintValidator user should only override one of the methods, either HibernateConstraintValidator.initialize(ConstraintDescriptor, HibernateConstraintValidatorInitializationContext) or ConstraintValidator.initialize(Annotation). Both methods will be called during initialization, starting with HibernateConstraintValidator.initialize(ConstraintDescriptor, HibernateConstraintValidatorInitializationContext).

Specified by:

initialize in interface HibernateConstraintValidator<C extends Annotation,T extends TemporalAccessor & Comparable<? super T>>

Parameters:

constraintDescriptor - a constraint descriptor for a given constraint declaration

initializationContext - an initialization context for a current ConstraintValidatorFactory

isValid

public boolean isValid(T 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<C extends Annotation,T extends TemporalAccessor & Comparable<? super T>>

Parameters:

value - object to validate

context - context in which the constraint is evaluated

Returns:

false if value does not pass the constraint

getEffectiveTemporalValidationTolerance

protected abstract Duration getEffectiveTemporalValidationTolerance(Duration absoluteTemporalValidationTolerance)

Returns the temporal validation tolerance to apply.

getReferenceValue

protected abstract T getReferenceValue(Clock reference)

Returns an object of the validated type corresponding to the current time reference as provided by the ClockProvider.

isValid

protected abstract boolean isValid(int result)

Returns whether the result of the comparison between the validated value and the time reference is considered valid.