javax.validation.Payload

javax.validation.Payload 是 Java Bean Validation API 中的一个注解，它定义了一个负载（payload），用于在验证错误时传递额外的信息。该注解的作用是为了提供更加详细的错误信息，以便于开发人员更好地了解验证失败的原因。

具体来说，javax.validation.Payload 注解可以用在约束注解定义的时候，指定一个 Class 类型的负载。当验证失败时，验证器可以将这个负载信息传递给 ConstraintValidatorContext 对象，以便于开发人员获取更加详细的错误信息。

举个例子，如果我们定义一个约束注解 @MyConstraint，可以通过 javax.validation.Payload 注解指定一个负载类型 MyPayload：

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = MyConstraintValidator.class)
public @interface MyConstraint {

    String message() default "validation failed";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {MyPayload.class};

}

在验证器 MyConstraintValidator 中，可以通过 ConstraintValidatorContext 对象获取 MyPayload 负载信息：

public class MyConstraintValidator implements ConstraintValidator<MyConstraint, Object> {

    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        if (value == null) {
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("value cannot be null")
                    .addConstraintViolation();
            return false;
        }
        // do validation
        return true;
    }
}

在上面的例子中，如果验证失败，就会通过 ConstraintValidatorContext 对象传递 MyPayload 负载信息，开发人员就可以获取到更加详细的错误信息。