Package jakarta.validation.metadata

Interface ConstraintDescriptor<T extends java.lang.annotation.Annotation>

  • Type Parameters:
    T - the constraint's annotation type
    public interface ConstraintDescriptor<T extends java.lang.annotation.Annotation>
    Describes a single constraint and its composing constraints.
    Author:
    Emmanuel Bernard, Hardy Ferentschik

    • Method Detail

      • getAnnotation

        T getAnnotation()
        Returns the annotation describing the constraint declaration. If a composing constraint, attribute values are reflecting the overridden attributes of the composing constraint
        Returns:
        the annotation for this constraint

      • getMessageTemplate

        java.lang.String getMessageTemplate()
        The non-interpolated error message
        Returns:
        the non-interpolated error message
        Since:
        1.1

      • getGroups

        java.util.Set<java.lang.Class<?>> getGroups()
        The set of groups the constraint is applied on. If the constraint declares no group, a set with only the Default group is returned.
        Returns:
        the groups the constraint is applied on

      • getPayload

        java.util.Set<java.lang.Class<? extends Payload>> getPayload()
        The set of payload the constraint hosts.
        Returns:
        payload classes hosted on the constraint or an empty set if none

      • getValidationAppliesTo

        ConstraintTarget getValidationAppliesTo()
        The ConstraintTarget value of validationAppliesTo if the constraint hosts it or null otherwise.
        Returns:
        the ConstraintTarget value or null
        Since:
        1.1

      • getConstraintValidatorClasses

        java.util.List<java.lang.Class<? extends ConstraintValidator<T,​?>>> getConstraintValidatorClasses()
        List of the constraint validation implementation classes.
        Returns:
        list of the constraint validation implementation classes

      • getAttributes

        java.util.Map<java.lang.String,​java.lang.Object> getAttributes()
        Returns a map containing the annotation attribute names as keys and the annotation attribute values as value.

        If this constraint is used as part of a composed constraint, attribute values are reflecting the overridden attribute of the composing constraint.

        Returns:
        a map containing the annotation attribute names as keys and the annotation attribute values as value

      • getComposingConstraints

        java.util.Set<ConstraintDescriptor<?>> getComposingConstraints()
        Return a set of composing ConstraintDescriptors where each descriptor describes a composing constraint. ConstraintDescriptor instances of composing constraints reflect overridden attribute values in getAttributes() and getAnnotation().
        Returns:
        a set of ConstraintDescriptor objects or an empty set in case there are no composing constraints

      • isReportAsSingleViolation

        boolean isReportAsSingleViolation()
        Returns:
        true if the constraint is annotated with ReportAsSingleViolation

      • unwrap

        <U> U unwrap​(java.lang.Class<U> type)
        Returns an instance of the specified type allowing access to provider-specific APIs.

        If the Jakarta Validation provider implementation does not support the specified class, a ValidationException is thrown.

        Type Parameters:
        U - the type of the object to be returned
        Parameters:
        type - the class of the object to be returned
        Returns:
        an instance of the specified class
        Throws:
        ValidationException - if the provider does not support the call
        Since:
        2.0