org.hibernate.validator.internal.metadata.core

Class ConstraintHelper

java.lang.Object

org.hibernate.validator.internal.metadata.core.ConstraintHelper

public class ConstraintHelper
extends java.lang.Object

Keeps track of builtin constraints and their validator implementations, as well as already resolved validator definitions.

Author:

Hardy Ferentschik, Alaa Nassef, Gunnar Morling, Guillaume Smet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	GROUPS
static java.lang.String	MESSAGE
static java.lang.String	PAYLOAD
static java.lang.String	VALIDATION_APPLIES_TO

Constructor Summary

Constructors

Constructor and Description
ConstraintHelper()

Method Summary

Modifier and Type	Method and Description
void	clear()
<A extends java.lang.annotation.Annotation> java.util.List<ConstraintValidatorDescriptor<A>>	findValidatorDescriptors(java.lang.Class<A> annotationType, javax.validation.constraintvalidation.ValidationTarget validationTarget) Returns those validator descriptors for the given constraint annotation matching the given target.
<A extends java.lang.annotation.Annotation> java.util.List<ConstraintValidatorDescriptor<A>>	getAllValidatorDescriptors(java.lang.Class<A> annotationType) Returns the constraint validator classes for the given constraint annotation type, as retrieved from Constraint.validatedBy(), internally registered validators for built-in constraints XML configuration and programmatically registered validators (see ConstraintMapping.constraintDefinition(Class)). The result is cached internally.
<A extends java.lang.annotation.Annotation> java.util.List<java.lang.annotation.Annotation>	getConstraintsFromMultiValueConstraint(A multiValueConstraint) Returns the constraints which are part of the given multi-value constraint.
boolean	isConstraintAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Checks whether the specified annotation is a valid constraint annotation.
boolean	isConstraintComposition(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
boolean	isJdkAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation)
boolean	isMultiValueConstraint(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Checks whether a given annotation is a multi value constraint or not.
<A extends java.lang.annotation.Annotation> void	putValidatorDescriptors(java.lang.Class<A> annotationType, java.util.List<ConstraintValidatorDescriptor<A>> validatorDescriptors, boolean keepExistingClasses) Registers the given validator descriptors with the given constraint annotation type.

Methods inherited from class java.lang.Object

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

Field Detail

GROUPS

public static final java.lang.String GROUPS

See Also:

Constant Field Values

PAYLOAD

public static final java.lang.String PAYLOAD

See Also:

Constant Field Values

MESSAGE

public static final java.lang.String MESSAGE

See Also:

Constant Field Values

VALIDATION_APPLIES_TO

public static final java.lang.String VALIDATION_APPLIES_TO

See Also:

Constant Field Values

Constructor Detail

ConstraintHelper

public ConstraintHelper()

Method Detail

getAllValidatorDescriptors

public <A extends java.lang.annotation.Annotation> java.util.List<ConstraintValidatorDescriptor<A>> getAllValidatorDescriptors(java.lang.Class<A> annotationType)

Returns the constraint validator classes for the given constraint annotation type, as retrieved from

• Constraint.validatedBy(),
• internally registered validators for built-in constraints
• XML configuration and
• programmatically registered validators (see ConstraintMapping.constraintDefinition(Class)).

The result is cached internally.

Type Parameters:

A - the type of the annotation

Parameters:

annotationType - The constraint annotation type.

Returns:

The validator classes for the given type.

findValidatorDescriptors

public <A extends java.lang.annotation.Annotation> java.util.List<ConstraintValidatorDescriptor<A>> findValidatorDescriptors(java.lang.Class<A> annotationType,
                                                                                                                             javax.validation.constraintvalidation.ValidationTarget validationTarget)

Returns those validator descriptors for the given constraint annotation matching the given target.

Type Parameters:

A - the type of the annotation

Parameters:

annotationType - The annotation of interest.

validationTarget - The target, either annotated element or parameters.

Returns:

A list with matching validator descriptors.

putValidatorDescriptors

public <A extends java.lang.annotation.Annotation> void putValidatorDescriptors(java.lang.Class<A> annotationType,
                                                                                java.util.List<ConstraintValidatorDescriptor<A>> validatorDescriptors,
                                                                                boolean keepExistingClasses)

Registers the given validator descriptors with the given constraint annotation type.

Type Parameters:

A - the type of the annotation

Parameters:

annotationType - The constraint annotation type

validatorDescriptors - The validator descriptors to register

keepExistingClasses - Whether already-registered validators should be kept or not

isMultiValueConstraint

public boolean isMultiValueConstraint(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Checks whether a given annotation is a multi value constraint or not.

Parameters:

annotationType - the annotation type to check.

Returns:

true if the specified annotation is a multi value constraints, false otherwise.

getConstraintsFromMultiValueConstraint

public <A extends java.lang.annotation.Annotation> java.util.List<java.lang.annotation.Annotation> getConstraintsFromMultiValueConstraint(A multiValueConstraint)

Returns the constraints which are part of the given multi-value constraint.

Invoke isMultiValueConstraint(Class) prior to calling this method to check whether a given constraint actually is a multi-value constraint.

Type Parameters:

A - the type of the annotation

Parameters:

multiValueConstraint - the multi-value constraint annotation from which to retrieve the contained constraints

Returns:

A list of constraint annotations, may be empty but never null.

isConstraintAnnotation

public boolean isConstraintAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Checks whether the specified annotation is a valid constraint annotation. A constraint annotation has to fulfill the following conditions:

• Must be annotated with Constraint
• Define a message parameter
• Define a group parameter
• Define a payload parameter

Parameters:

annotationType - The annotation type to test.

Returns:

true if the annotation fulfills the above conditions, false otherwise.

isConstraintComposition

public boolean isConstraintComposition(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

isJdkAnnotation

public boolean isJdkAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation)

clear

public void clear()