bean验证领域的黑马——Jakarta Validation，告诉你它和hibernate-validator以及spring-boot-starter-validation的区别

Java 中强大的 Bean 验证框架：Jakarta Validation、Hibernate-Validator 和 Spring-Boot-Starter-Validation

简介

数据验证在任何现代应用程序中都至关重要。它有助于确保在存储或处理之前数据的一致性和完整性。Java 中有许多强大的 Bean 验证框架，例如 Jakarta Validation、Hibernate-Validator 和 Spring-Boot-Starter-Validation。本文将深入探讨这些框架，它们的差异以及如何创建自定义验证注解。

Jakarta Validation：规范基础

Jakarta Validation 是一个定义 Bean 验证规范的开源项目。它提供了一系列规则和注解，用于验证 Java Bean。它允许您对字段和对象应用各种约束，例如非空、类型检查和范围验证。

Hibernate-Validator：规范的参考实现

Hibernate-Validator 是 Jakarta Validation 规范的参考实现。它为 Java Bean 提供了全面的验证功能。它支持所有 Jakarta Validation 规则，并提供附加功能，例如：

• 自定义验证注解
• 级联验证
• 分组验证

Spring-Boot-Starter-Validation：Spring Boot 的整合

Spring-Boot-Starter-Validation 是 Spring Boot 提供的一个启动器，用于简化对 Bean 验证的支持。它集成了 Hibernate-Validator，并提供了额外的功能，例如：

• 自动配置 Hibernate-Validator
• 常用验证注解
• 对 Spring MVC 的支持

框架之间的区别

• 规范与实现： Jakarta Validation 是一个规范，而 Hibernate-Validator 和 Spring-Boot-Starter-Validation 是它的实现。
• 功能范围： Hibernate-Validator 完全支持 Jakarta Validation 规范，而 Spring-Boot-Starter-Validation 则提供了附加功能。
• Spring Boot 整合： Spring-Boot-Starter-Validation 是 Spring Boot 的一部分，它提供了与 Spring MVC 的无缝集成。

自定义验证注解

有时，标准验证注解不足以满足特定需求。Jakarta Validation 允许您创建自己的自定义验证注解。以下是如何创建自定义验证注解：

1. 创建一个继承自 ConstraintValidator 的类。
2. 实现 isValid() 方法，其中包含验证逻辑。
3. 使用 @Constraint 注解标注自定义验证注解。

代码示例：

// 自定义非空注解
@Documented
@Constraint(validatedBy = {NotBlankValidator.class})
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface NotBlank {

    String message() default "字段不能为空";

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

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

// NotBlank 验证器
public class NotBlankValidator implements ConstraintValidator<NotBlank, String> {

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value != null && !value.trim().isEmpty();
    }
}

使用自定义验证注解：

// 用户实体类
public class User {

    @NotBlank
    private String name;

    @NotBlank
    private String email;

    // ... 其他属性
}

总结

Jakarta Validation、Hibernate-Validator 和 Spring-Boot-Starter-Validation 为 Java 开发人员提供了强大的 Bean 验证框架。它们可以帮助确保数据的完整性和一致性，从而提高应用程序的可靠性。了解这些框架之间的差异并创建自定义验证注解可以使您满足特定的验证需求。

常见问题解答

1. 哪种框架最适合我的项目？

   • 如果您需要自定义验证功能或 Spring Boot 整合，则 Spring-Boot-Starter-Validation 是一个很好的选择。
   • 如果您需要一个成熟且全面的验证库，则 Hibernate-Validator 是一个不错的选择。
   • 如果您只需要基本的验证功能，则 Jakarta Validation 可以满足您的需求。

2. 如何选择合适的验证规则？

   • 考虑您的数据类型和特定业务需求。
   • 查阅 Jakarta Validation 规范以了解可用的规则。
   • 研究社区创建的自定义验证注解。

3. 如何使用级联验证？

   • 在嵌套的对象上使用 @Valid 注解。
   • 确保嵌套对象的字段具有适当的验证注解。

4. 如何进行分组验证？

   • 为验证规则创建不同的组。
   • 使用 @groups 注解指定要验证的组。

5. 如何调试验证错误？

   • 检查控制台输出或异常堆栈中的验证错误消息。
   • 使用调试工具（例如 IDE 或日志记录框架）来查看验证过程。