org.hibernate.validator.constraintvalidation

Interface HibernateConstraintValidatorContext

All Superinterfaces:

javax.validation.ConstraintValidatorContext

public interface HibernateConstraintValidatorContext
extends javax.validation.ConstraintValidatorContext

A custom ConstraintValidatorContext which allows to set additional message parameters for interpolation.

Author:

Hardy Ferentschik, Gunnar Morling, Guillaume Smet

Nested Class Summary

Nested classes/interfaces inherited from interface javax.validation.ConstraintValidatorContext

javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder

Method Summary

Modifier and Type	Method and Description
HibernateConstraintValidatorContext	addExpressionVariable(String name, Object value) Allows to set an additional expression variable which will be available as an EL variable during interpolation.
HibernateConstraintValidatorContext	addMessageParameter(String name, Object value) Allows to set an additional named parameter which can be interpolated in the constraint violation message.
TimeProvider	getTimeProvider() Returns the provider for obtaining the current time, e.g.
HibernateConstraintValidatorContext	withDynamicPayload(Object payload) Allows to set an object that may further describe the violation.

Methods inherited from interface javax.validation.ConstraintValidatorContext

buildConstraintViolationWithTemplate, disableDefaultConstraintViolation, getDefaultConstraintMessageTemplate, unwrap

Method Detail

addMessageParameter

HibernateConstraintValidatorContext addMessageParameter(String name,
                                                        Object value)

Allows to set an additional named parameter which can be interpolated in the constraint violation message. The variable will be available for interpolation for all constraint violations generated for this constraint. This includes the default one as well as all violations created by the ConstraintViolationBuilder. To create multiple constraint violations with different variable values, this method can be called between successive calls to ConstraintValidatorContext.ConstraintViolationBuilder.addConstraintViolation().

For example:

 
 public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {
     HibernateConstraintValidatorContext context = constraintValidatorContext.unwrap( HibernateConstraintValidatorContext.class );

     context.addMessageParameter( "foo", "bar" );
     context.buildConstraintViolationWithTemplate( "{foo}" )
            .addConstraintViolation();

     context.addMessageParameter( "foo", "snafu" );
     context.buildConstraintViolationWithTemplate( "{foo}" )
            .addConstraintViolation();

     return false;
  }
  

 

Parameters:

name - the name under which to bind the parameter, cannot be null

value - the value to be bound to the specified name

Returns:

a reference to itself to allow method chaining

Throws:

IllegalArgumentException - in case the provided name is null

Since:

5.4.1

addExpressionVariable

HibernateConstraintValidatorContext addExpressionVariable(String name,
                                                          Object value)

Allows to set an additional expression variable which will be available as an EL variable during interpolation. The variable will be available for interpolation for all constraint violations generated for this constraint. This includes the default one as well as all violations created by the ConstraintViolationBuilder. To create multiple constraint violations with different variable values, this method can be called between successive calls to ConstraintValidatorContext.ConstraintViolationBuilder.addConstraintViolation().

For example:

 
 public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {
     HibernateConstraintValidatorContext context = constraintValidatorContext.unwrap( HibernateConstraintValidatorContext.class );

     context.addExpressionVariable( "foo", "bar" );
     context.buildConstraintViolationWithTemplate( "${foo}" )
            .addConstraintViolation();

     context.addExpressionVariable( "foo", "snafu" );
     context.buildConstraintViolationWithTemplate( "${foo}" )
            .addConstraintViolation();

     return false;
  }
  

 

Parameters:

name - the name under which to bind the expression variable, cannot be null

value - the value to be bound to the specified name

Returns:

a reference to itself to allow method chaining

Throws:

IllegalArgumentException - in case the provided name is null

getTimeProvider

TimeProvider getTimeProvider()

Returns the provider for obtaining the current time, e.g. when validating the Future and Past constraints.

Returns:

the provider for obtaining the current time, never null. If no specific provider has been configured during bootstrap, a default implementation using the current system time and the current default time zone will be returned.

Since:

5.2

withDynamicPayload

HibernateConstraintValidatorContext withDynamicPayload(Object payload)

Allows to set an object that may further describe the violation. The user is responsible himself to ensure that this payload is serializable in case the javax.validation.ConstraintViolation has to be serialized.

Parameters:

payload - an object representing additional information about the violation

Returns:

a reference to itself to allow method chaining

Since:

5.3