Package jakarta.validation
Interface ConstraintValidatorContext.ConstraintViolationBuilder
-
- Enclosing interface:
- ConstraintValidatorContext
public static interface ConstraintValidatorContext.ConstraintViolationBuilder
ConstraintViolation
builder allowing to optionally associate the violation report to a sub path.To create the
ConstraintViolation
, one must call either one of theaddConstraintViolation()
methods available in one of the interfaces of the fluent API.If another method is called after
addConstraintViolation()
onConstraintViolationBuilder
or any of its associated objects anIllegalStateException
is raised.
-
-
Nested Class Summary
-
Method Summary
-
-
-
Method Detail
-
addNode
ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext addNode(String name)
Deprecated.Adds a node to the path theConstraintViolation
will be associated to.name
describes a single property. In particular, dot (.) is not allowed.- Parameters:
name
- property name- Returns:
- a builder representing node
name
-
addPropertyNode
ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext addPropertyNode(String name)
Adds a property node to the path theConstraintViolation
will be associated to.name
describes a single property. In particular, dot (.) is not allowed.- Parameters:
name
- property name- Returns:
- a builder representing node
name
- Throws:
IllegalArgumentException
- if the name is null- Since:
- 1.1
-
addBeanNode
ConstraintValidatorContext.ConstraintViolationBuilder.LeafNodeBuilderCustomizableContext addBeanNode()
Adds a bean node (class-level) to the path theConstraintViolation
will be associated to. Note that bean nodes are always leaf nodes.- Returns:
- a builder representing the bean node
- Since:
- 1.1
-
addContainerElementNode
ConstraintValidatorContext.ConstraintViolationBuilder.ContainerElementNodeBuilderCustomizableContext addContainerElementNode(String name, Class<?> containerType, Integer typeArgumentIndex)
Adds a container element node to the path theConstraintViolation
will be associated to.- Parameters:
name
- the node namecontainerType
- the type of the containertypeArgumentIndex
- the index of the type argument- Returns:
- a builder representing the container element node
- Throws:
IllegalArgumentException
- if the index is not valid- Since:
- 2.0
-
addParameterNode
ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext addParameterNode(int index)
Adds a method parameter node to the path theConstraintViolation
will be associated to. The parameter index must be valid (i.e. within the boundaries of the method parameter indexes). May only be called from within cross-parameter validators.- Parameters:
index
- the parameter index- Returns:
- a builder representing the index-th parameter node
- Throws:
IllegalArgumentException
- if the index is not valid- Since:
- 1.1
-
addConstraintViolation
ConstraintValidatorContext addConstraintViolation()
Adds the newConstraintViolation
to be generated if the constraint validator marks the value as invalid.Methods of this
ConstraintViolationBuilder
instance and its nested objects throwIllegalStateException
from now on.- Returns:
- the
ConstraintValidatorContext
instance theConstraintViolationBuilder
comes from
-
-