org.hibernate.validator.internal.engine

Class ValidatorContextImpl

java.lang.Object

org.hibernate.validator.internal.engine.ValidatorContextImpl

All Implemented Interfaces:

ValidatorContext, HibernateValidatorContext

public class ValidatorContextImpl
extends Object
implements HibernateValidatorContext

Author:

Emmanuel Bernard, Hardy Ferentschik, Kevin Pollet <kevin.pollet@serli.com> (C) 2011 SERLI, Gunnar Morling, Chris Beckey <cbeckey@paypal.com>

Constructor Summary

Constructors

Constructor and Description
ValidatorContextImpl(ValidatorFactoryImpl validatorFactory)

Method Summary

Modifier and Type	Method and Description
HibernateValidatorContext	addValidationValueHandler(ValidatedValueUnwrapper<?> handler) Registers the given validated value unwrapper with the bootstrapped validator.
HibernateValidatorContext	allowMultipleCascadedValidationOnReturnValues(boolean allow) Define whether more than one constraint on a return value may be marked for cascading validation are allowed.
HibernateValidatorContext	allowOverridingMethodAlterParameterConstraint(boolean allow) Define whether overriding methods that override constraints should throw a ConstraintDefinitionException.
HibernateValidatorContext	allowParallelMethodsDefineParameterConstraints(boolean allow) Define whether parallel methods that define constraints should throw a ConstraintDefinitionException.
HibernateValidatorContext	constraintValidatorFactory(ConstraintValidatorFactory factory) Defines the constraint validator factory implementation used by the Validator.
HibernateValidatorContext	failFast(boolean failFast) En- or disables the fail fast mode.
Validator	getValidator() Returns an initialized Validator instance respecting the defined state.
HibernateValidatorContext	messageInterpolator(MessageInterpolator messageInterpolator) Defines the message interpolator implementation used by the Validator.
HibernateValidatorContext	parameterNameProvider(ParameterNameProvider parameterNameProvider) Defines the parameter name provider implementation used by the Validator.
HibernateValidatorContext	timeProvider(TimeProvider timeProvider) Registers the given time provider with the bootstrapped validator.
HibernateValidatorContext	traversableResolver(TraversableResolver traversableResolver) Defines the traversable resolver implementation used by the Validator.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.validation.ValidatorContext

addValueExtractor, clockProvider

Constructor Detail

ValidatorContextImpl

public ValidatorContextImpl(ValidatorFactoryImpl validatorFactory)

Method Detail

messageInterpolator

public HibernateValidatorContext messageInterpolator(MessageInterpolator messageInterpolator)

Description copied from interface: ValidatorContext

Defines the message interpolator implementation used by the Validator.

If not set or if null is passed as a parameter, the message interpolator of the ValidatorFactory is used.

Specified by:

messageInterpolator in interface ValidatorContext

Specified by:

messageInterpolator in interface HibernateValidatorContext

Parameters:

messageInterpolator - the MessageInterpolator used by the Validator

Returns:

self following the chaining method pattern

traversableResolver

public HibernateValidatorContext traversableResolver(TraversableResolver traversableResolver)

Description copied from interface: ValidatorContext

Defines the traversable resolver implementation used by the Validator.

If not set or if null is passed as a parameter, the traversable resolver of the ValidatorFactory is used.

Specified by:

traversableResolver in interface ValidatorContext

Specified by:

traversableResolver in interface HibernateValidatorContext

Parameters:

traversableResolver - the TraversableResolver used by the Validator

Returns:

self following the chaining method pattern

constraintValidatorFactory

public HibernateValidatorContext constraintValidatorFactory(ConstraintValidatorFactory factory)

Description copied from interface: ValidatorContext

Defines the constraint validator factory implementation used by the Validator. If not set or if null is passed as a parameter, the constraint validator factory of the ValidatorFactory is used.

Specified by:

constraintValidatorFactory in interface ValidatorContext

Specified by:

constraintValidatorFactory in interface HibernateValidatorContext

Parameters:

factory - the ConstraintValidatorFactory used by the Validator

Returns:

self following the chaining method pattern

parameterNameProvider

public HibernateValidatorContext parameterNameProvider(ParameterNameProvider parameterNameProvider)

Description copied from interface: ValidatorContext

Defines the parameter name provider implementation used by the Validator. If not set or if null is passed as a parameter, the parameter name provider of the ValidatorFactory is used.

Specified by:

parameterNameProvider in interface ValidatorContext

Specified by:

parameterNameProvider in interface HibernateValidatorContext

Parameters:

parameterNameProvider - parameter name provider implementation.

Returns:

self following the chaining method pattern

failFast

public HibernateValidatorContext failFast(boolean failFast)

Description copied from interface: HibernateValidatorContext

En- or disables the fail fast mode. When fail fast is enabled the validation will stop on the first constraint violation detected.

Specified by:

failFast in interface HibernateValidatorContext

Parameters:

failFast - true to enable fail fast, false otherwise.

Returns:

this following the chaining method pattern

addValidationValueHandler

public HibernateValidatorContext addValidationValueHandler(ValidatedValueUnwrapper<?> handler)

Description copied from interface: HibernateValidatorContext

Registers the given validated value unwrapper with the bootstrapped validator. When validating an element which is of a type supported by the unwrapper and which is annotated with UnwrapValidatedValue, the unwrapper will be applied to retrieve the value to validate.

Specified by:

addValidationValueHandler in interface HibernateValidatorContext

Parameters:

handler - the unwrapper to register

Returns:

this following the chaining method pattern

timeProvider

public HibernateValidatorContext timeProvider(TimeProvider timeProvider)

Description copied from interface: HibernateValidatorContext

Registers the given time provider with the bootstrapped validator. This provider will be used to obtain the current time when validating @Future and @Past constraints. If not set or if null is passed as a parameter, the time provider of the ValidatorFactory is used.

Specified by:

timeProvider in interface HibernateValidatorContext

Parameters:

timeProvider - the time provider to register.

Returns:

this following the chaining method pattern

allowOverridingMethodAlterParameterConstraint

public HibernateValidatorContext allowOverridingMethodAlterParameterConstraint(boolean allow)

Description copied from interface: HibernateValidatorContext

Define whether overriding methods that override constraints should throw a ConstraintDefinitionException. The default value is false, i.e. do not allow.

See Section 4.5.5 of the JSR 349 specification, specifically

 "In sub types (be it sub classes/interfaces or interface implementations), no parameter constraints may
 be declared on overridden or implemented methods, nor may parameters be marked for cascaded validation.
 This would pose a strengthening of preconditions to be fulfilled by the caller."
 

Specified by:

allowOverridingMethodAlterParameterConstraint in interface HibernateValidatorContext

Parameters:

allow - flag determining whether validation will allow overriding to alter parameter constraints.

Returns:

this following the chaining method pattern

allowMultipleCascadedValidationOnReturnValues

public HibernateValidatorContext allowMultipleCascadedValidationOnReturnValues(boolean allow)

Description copied from interface: HibernateValidatorContext

Define whether more than one constraint on a return value may be marked for cascading validation are allowed. The default value is false, i.e. do not allow.

See Section 4.5.5 of the JSR 349 specification, specifically

 "One must not mark a method return value for cascaded validation more than once in a line of a class hierarchy.
 In other words, overriding methods on sub types (be it sub classes/interfaces or interface implementations)
 cannot mark the return value for cascaded validation if the return value has already been marked on the
 overridden method of the super type or interface."
 

Specified by:

allowMultipleCascadedValidationOnReturnValues in interface HibernateValidatorContext

Parameters:

allow - flag determining whether validation will allow multiple cascaded validation on return values.

Returns:

this following the chaining method pattern

allowParallelMethodsDefineParameterConstraints

public HibernateValidatorContext allowParallelMethodsDefineParameterConstraints(boolean allow)

Description copied from interface: HibernateValidatorContext

Define whether parallel methods that define constraints should throw a ConstraintDefinitionException. The default value is false, i.e. do not allow.

See Section 4.5.5 of the JSR 349 specification, specifically

 "If a sub type overrides/implements a method originally defined in several parallel types of the hierarchy
 (e.g. two interfaces not extending each other, or a class and an interface not implemented by said class),
 no parameter constraints may be declared for that method at all nor parameters be marked for cascaded validation.
 This again is to avoid an unexpected strengthening of preconditions to be fulfilled by the caller."
 

Specified by:

allowParallelMethodsDefineParameterConstraints in interface HibernateValidatorContext

Parameters:

allow - flag determining whether validation will allow parameter constraints in parallel hierarchies

Returns:

this following the chaining method pattern

getValidator

public Validator getValidator()

Description copied from interface: ValidatorContext

Returns an initialized Validator instance respecting the defined state. Validator instances can be pooled and shared by the implementation.

Specified by:

getValidator in interface ValidatorContext

Returns:

contextualized Validator