轻松掌握Java Bean Validation，验证你的Java bean！

闲谈

2023-03-06 09:49:32

Java Bean Validation：简化数据验证，提升应用可靠性

在现代应用程序开发中，用户输入验证至关重要。Java Bean Validation 应运而生，为 Java bean 的验证提供了标准化的解决方案。基于 JSR 380 标准，它已成为 Java 生态系统中不可或缺的组件。

Java Bean Validation 的强大功能

注解驱动的验证： 只需在 Java bean 的字段上添加注解，即可验证输入数据，无需编写繁琐的验证代码。
支持多种数据类型： 支持基本类型、字符串、集合、枚举等多种数据类型。
自定义验证注解： 允许创建自定义验证注解，满足特定业务需求。
分组验证： 根据不同场景对 Java bean 进行验证。
本地化消息： 支持本地化消息，根据不同的语言环境输出错误消息。

Java Bean Validation 实战指南

1. 引入依赖： 在项目中引入 Java Bean Validation 依赖，通常是 javax.validation:validation-api。

2. 添加注解： 在 Java bean 的字段上添加适当的注解，如 @NotNull、@Size、@Pattern。

3. 实现 ValidatorFactory： 创建一个 ValidatorFactory 实例，用于创建 Validator 对象。

4. 创建 Validator 对象： 使用 ValidatorFactory 创建 Validator 对象，用于执行验证。

5. 执行验证： 使用 Validator 对象验证 Java bean，如果验证失败，将返回一个包含违反约束的 Set<ConstraintViolation> 对象。

代码示例：

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;

public class ValidationExample {

    public static void main(String[] args) {
        // 创建 ValidatorFactory
        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();

        // 创建 Validator
        Validator validator = factory.getValidator();

        // 创建要验证的 Java bean
        Person person = new Person();
        person.setName(null); // 违反 @NotNull 约束

        // 执行验证
        Set<ConstraintViolation<Person>> violations = validator.validate(person);

        // 检查违反的约束
        if (!violations.isEmpty()) {
            for (ConstraintViolation<Person> violation : violations) {
                System.out.println(violation.getMessage());
            }
        }
    }

    public static class Person {
        @NotNull
        private String name;

        // 省略 getter 和 setter 方法
    }
}

常见问题解答

Java Bean Validation 的优点是什么？
- 简化验证、减少冗余代码、支持多种数据类型和分组验证。
如何创建自定义验证注解？
- 编写一个带有 @Constraint 和 @Documented 注解的类，实现 ConstraintValidator 接口。
如何进行分组验证？
- 在验证注解上指定 groups 参数，如 @Size(groups = { ValidationGroup1.class })。
如何实现本地化消息？
- 创建一个 ValidationMessages 类，并使用 Validation.byDefault().providerResolver() 获取验证提供者。
如何使用 Java Bean Validation 进行 REST API 验证？
- 使用 javax.validation.constraints 包中的注解，并使用 @Valid 注解在控制器方法中指定验证。