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

Class AbstractInstantBasedTimeValidator<C extends Annotation,T>

java.lang.Object

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

All Implemented Interfaces:

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

Direct Known Subclasses:

AbstractFutureInstantBasedValidator, AbstractFutureOrPresentInstantBasedValidator, AbstractPastInstantBasedValidator, AbstractPastOrPresentInstantBasedValidator

public abstract class AbstractInstantBasedTimeValidator<C extends Annotation,T>
extends Object
implements HibernateConstraintValidator<C,T>

Base class for all time validators that use an Instant to be compared to the time reference.

Author:

Alaa Nassef, Guillaume Smet

Field Summary

Fields

Modifier and Type	Field	Description
protected Clock	referenceClock

Constructor Summary

Constructors

Constructor	Description
AbstractInstantBasedTimeValidator()

Method Summary

Modifier and Type	Method	Description
protected abstract Duration	getEffectiveTemporalValidationTolerance(Duration absoluteTemporalValidationTolerance)	Returns the temporal validation tolerance to apply.
protected abstract Instant	getInstant(T value)	Returns the Instant measured from Epoch.
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

AbstractInstantBasedTimeValidator

public AbstractInstantBasedTimeValidator()

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>

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>

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.

getInstant

protected abstract Instant getInstant(T value)

Returns the Instant measured from Epoch.

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.