Spring Boot 中的数据校验是通过结合 Java Bean Validation API（如 Hibernate Validator 实现）和 Spring 的数据绑定与校验机制实现的。本文将深入解析其数据校验原理，帮助你在进阶使用 Spring Boot 时，充分利用其校验能力。

1. 验证注解

Java Bean Validation 提供了一系列的注解用于声明校验规则，如：

• @NotNull：确保字段不为 null。
• @Size：检查集合、数组、字符串长度。
• @Min/@Max：数值范围限制。
• @Email：验证邮箱格式。

这些注解通常直接应用于 Java 类的字段上。

2. Validator 实现

Spring Boot 默认整合了 Hibernate Validator 作为实现。Hibernate Validator 是 Java Bean Validation 的一个参考实现。你可以通过自定义注解和配套的验证器类来扩展或增强验证逻辑。

@Documented  
@Constraint(validatedBy = CustomValidator.class)  
@Target({ElementType.METHOD, ElementType.FIELD})  
@Retention(RetentionPolicy.RUNTIME)  
public @interface CustomConstraint {  
    String message() default "Invalid value";  
    Class<?>[] groups() default {};  
    Class<? extends Payload>[] payload() default {};  
}  
public class CustomValidator implements ConstraintValidator<CustomConstraint, String> {  
    @Override  
    public void initialize(CustomConstraint constraintAnnotation) {}  
    @Override  
    public boolean isValid(String value, ConstraintValidatorContext context) {  
        return value != null && value.matches("[a-zA-Z0-9]+");  
    }  
}  

3. 校验流程

当一个 Spring Controller 接收请求时，Spring 会尝试将请求数据绑定到方法参数中的对象上。完成数据绑定后，自动触发校验。

例如：

@PostMapping("/user")  
public ResponseEntity<String> addUser(@Valid @RequestBody User user, BindingResult result) {  
    if (result.hasErrors()) {  
        return ResponseEntity.badRequest().body(result.getAllErrors().toString());  
    }  
    return ResponseEntity.ok("User is valid");  
}  

在这个例子中，@Valid 注解用于触发数据校验。如果校验失败，BindingResult 将包含所有错误信息。

4. 方法级别校验

除了字段级别，Spring Boot 也支持方法级别的验证。使用 @Validated 可以在方法上校验参数。

@Validated  
public class UserService {  
    public void registerUser(@NotNull @Email String email) {  
        // Register user logic  
    }  
}  

5. 自定义校验处理

在很多应用场景中，默认的错误处理不够灵活。可以通过 @ControllerAdvice 和 @ExceptionHandler 自定义错误处理。

@ControllerAdvice  
public class GlobalExceptionHandler {  
    @ExceptionHandler(MethodArgumentNotValidException.class)  
    public ResponseEntity<String> handleValidationExceptions(MethodArgumentNotValidException ex) {  
        List<String> errors = ex.getBindingResult()  
            .getAllErrors()  
            .stream()  
            .map(DefaultMessageSourceResolvable::getDefaultMessage)  
            .collect(Collectors.toList());  
        return ResponseEntity.badRequest().body(String.join(", ", errors));  
    }  
}  

总结

Spring Boot 的数据校验机制结合了 Java Bean Validation 提供的注解和 Spring 的绑定框架，实现了灵活而强大的数据校验功能。对于复杂的业务需求，可以通过自定义注解和验证器来扩展这一功能。借助这些工具，你可以在 Spring Boot 应用程序中更有效地确保数据的完整性和一致性。