Java Bean 数据校验的核心方法

数据校验是保证Java应用数据完整性和安全性的关键步骤。通过合理的数据校验机制，可以有效防止非法数据进入系统，避免潜在的业务逻辑错误或安全漏洞。

使用JSR-303/JSR-349 Bean Validation规范

JSR规范为Java Bean校验提供了标准化的注解方式。常用注解包括：

• @NotNull：校验字段不能为null
• @Size：校验字符串或集合长度范围
• @Min/@Max：校验数值范围
• @Pattern：正则表达式校验
• @Email：校验邮件格式

public class User {
    @NotNull
    @Size(min = 2, max = 30)
    private String name;
    
    @Email
    private String email;
}

Spring框架集成校验

Spring对Bean Validation提供了良好支持，在控制器层可直接使用@Valid注解触发校验：

@PostMapping("/users")
public ResponseEntity createUser(@Valid @RequestBody User user) {
    // 校验通过后处理逻辑
}

校验失败时会抛出MethodArgumentNotValidException，可通过全局异常处理器捕获并返回友好错误信息。

自定义校验规则的实现

当内置注解无法满足需求时，可通过自定义校验注解和验证器扩展功能。

创建自定义注解

@Target({FIELD, PARAMETER})
@Retention(RUNTIME)
@Constraint(validatedBy = PhoneNumberValidator.class)
public @interface PhoneNumber {
    String message() default "Invalid phone number";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

实现约束验证器

public class PhoneNumberValidator implements 
    ConstraintValidator<PhoneNumber, String> {
    
    private static final Pattern PHONE_PATTERN = 
        Pattern.compile("^1[3-9]\\d{9}$");
        
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value == null || PHONE_PATTERN.matcher(value).matches();
    }
}

分组校验的应用场景

通过定义校验分组可以实现不同场景下的差异化校验规则：

public interface BasicInfo {}
public interface FullInfo extends BasicInfo {}

public class User {
    @NotNull(groups = BasicInfo.class)
    private String username;
    
    @NotNull(groups = FullInfo.class)
    private String address;
}

使用时指定校验分组：

validator.validate(user, BasicInfo.class);

校验性能优化策略

对于高并发场景，需要关注校验性能优化：

缓存校验元数据

Hibernate Validator会自动缓存约束注解的解析结果，避免重复解析注解带来的性能损耗。

延迟校验

对复杂对象可采用分步校验策略，先校验基本字段，业务处理前再校验复杂关联字段。

异步校验

对耗时校验（如远程验证）可采用异步方式，通过CompletableFuture等机制实现非阻塞校验。

校验结果处理最佳实践

统一错误响应格式

建议设计统一的校验错误响应结构，包含字段名、错误值和错误描述：

{
    "errors": [
        {
            "field": "email",
            "rejectedValue": "invalid",
            "message": "必须是有效的电子邮件地址"
        }
    ]
}

国际化错误消息

通过ResourceBundle实现错误消息的国际化支持，在约束注解中指定消息key：

@NotNull(message = "{validation.user.name.required}")
private String name;

在messages.properties中配置具体消息：

validation.user.name.required=用户名不能为空