org.hibernate.validator.cfg.context.ConstraintDefinitionContext Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of bean-validator Show documentation

JSR 380's RI, Hibernate Validator version ${hibernate-validator.version} and its dependencies repackaged as OSGi bundle

There is a newer version: 5.1.0

/*
 * Hibernate Validator, declare and validate application constraints
 *
 * License: Apache License, Version 2.0
 * See the license.txt file in the root directory or .
 */
package org.hibernate.validator.cfg.context;

import java.lang.annotation.Annotation;

import javax.validation.ConstraintValidator;

import org.hibernate.validator.Incubating;


/**
 * Constraint mapping creational context representing a constraint (i.e. annotation type). Allows to define which
 * validators should validate this constraint.
 *
 * @param  The annotation type represented by this context.
 *
 * @author Yoann Rodiere
 */
public interface ConstraintDefinitionContext extends ConstraintMappingTarget {

	/**
	 * Specifies whether validators already mapped to this constraint (i.e. defined in the annotation declaration
	 * through {@link javax.validation.Constraint#validatedBy()} or the validation engine defaults) should
	 * be included or not.
	 *
	 * @param includeExistingValidators Whether or not to use already-mapped validators when validating this constraint.
	 * @return This context for method chaining.
	 */
	ConstraintDefinitionContext includeExistingValidators(boolean includeExistingValidators);

	/**
	 * Adds a new validator to validate this constraint.
	 *
	 * @param validator The validator to add.
	 *
	 * @return This context for method chaining.
	 */
	ConstraintDefinitionContext validatedBy(Class> validator);

	/**
	 * Allows to configure a validation implementation using a Lambda expression or method reference. Useful for simple
	 * validations without the need for accessing constraint properties or customization of error messages etc.
	 * 
	 *
	 * @param type The type of the value to validate
	 * @return This context for method chaining
	 */
	@Incubating
	 ConstraintValidatorDefinitionContext validateType(Class type);

	/**
	 * Allows to specify a validation implementation for the given constraint and data type using a Lambda expression or
	 * method reference.
	 */
	@Incubating
	interface ConstraintValidatorDefinitionContext {

		/**
		 * Applies the given Lambda expression or referenced method to values to be validated. It is guaranteed that
		 * {@code null} is never passed to these expressions or methods.
		 */
		ConstraintDefinitionContext with(ValidationCallable vc);
	}

	/**
	 * Callable implementing a validation routine. Usually given as method reference or Lambda expression.
	 */
	@FunctionalInterface
	@Incubating
	interface ValidationCallable {
		boolean isValid(T object);
	}
}