Spring验证框架

简介

Spring验证框架是Spring生态系统中的一个核心组件，用于在应用程序中实现数据验证逻辑。它基于JSR-380（Bean Validation 2.0）规范，并与Spring的核心功能深度集成，为开发者提供了一种声明式的方式来验证Java对象。

主要特点包括：

• 支持注解驱动的验证规则
• 与Spring MVC无缝集成
• 可扩展的验证器接口
• 国际化支持

核心概念

验证注解

Spring验证框架提供了一系列标准注解来定义验证规则：

注解	描述
@NotNull	验证字段不为null
@Size(min, max)	验证集合或字符串大小在范围内
@Min	验证数字最小值
@Max	验证数字最大值
@Email	验证电子邮件格式
@Pattern	验证字符串匹配正则表达式

验证器接口

Spring提供了Validator接口，包含两个核心方法：

• supports(Class) - 检查验证器是否支持给定类
• validate(Object, Errors) - 执行实际验证

基本用法

声明式验证

以下是一个使用注解验证的简单示例：

public class User {
    @NotNull
    @Size(min=2, max=30)
    private String name;
    
    @Email
    private String email;
    
    @Min(18)
    private int age;
    
    // getters and setters
}

编程式验证

可以通过Validator接口实现编程式验证：

public class UserValidator implements Validator {
    @Override
    public boolean supports(Class<?> clazz) {
        return User.class.isAssignableFrom(clazz);
    }
    
    @Override
    public void validate(Object target, Errors errors) {
        User user = (User) target;
        if (user.getName().length() < 2) {
            errors.rejectValue("name", "name.too.short");
        }
    }
}

Spring MVC集成

在Spring MVC中，验证可以自动执行：

@PostMapping("/users")
public String createUser(@Valid @ModelAttribute User user, BindingResult result) {
    if (result.hasErrors()) {
        return "userForm";
    }
    // 处理有效用户
    return "redirect:/success";
}

自定义验证 =

自定义注解

可以创建自定义验证注解：

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

自定义验证器

实现ConstraintValidator接口：

public class PhoneNumberValidator implements ConstraintValidator<PhoneNumber, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value != null && value.matches("^\\+?[0-9]{10,15}$");
    }
}

验证组 =

验证组允许在不同场景下应用不同的验证规则：

public interface BasicValidation {}
public interface AdvancedValidation extends BasicValidation {}

public class User {
    @NotNull(groups = BasicValidation.class)
    private String username;
    
    @Size(min=8, groups = AdvancedValidation.class)
    private String password;
}

// 使用特定组验证
validator.validate(user, AdvancedValidation.class);

错误处理

验证错误可以通过多种方式处理：

if (bindingResult.hasErrors()) {
    List<FieldError> errors = bindingResult.getFieldErrors();
    for (FieldError error : errors) {
        System.out.println(error.getField() + ": " + error.getDefaultMessage());
    }
}

实际案例 =

用户注册表单验证

一个完整的用户注册验证示例：

@Controller
public class RegistrationController {
    @GetMapping("/register")
    public String showForm(User user) {
        return "register";
    }
    
    @PostMapping("/register")
    public String submitForm(@Valid User user, BindingResult result) {
        if (result.hasErrors()) {
            return "register";
        }
        // 保存用户
        return "redirect:/success";
    }
}

public class User {
    @NotNull
    @Size(min=2, max=30)
    private String name;
    
    @Email
    private String email;
    
    @Pattern(regexp="^(?=.*[A-Za-z])(?=.*\\d)[A-Za-z\\d]{8,}$")
    private String password;
    
    // getters and setters
}

性能考虑

• 验证应该在早期进行，避免无效数据进入业务逻辑
• 对于复杂验证，考虑缓存验证结果
• 批量操作时，考虑使用并行验证

高级主题 =

跨字段验证

验证多个字段之间的关系：

@AssertTrue(message = "密码必须匹配")
private boolean isPasswordValid() {
    return password != null && password.equals(passwordConfirmation);
}

验证消息国际化

可以通过资源文件自定义错误消息：

# messages.properties
NotNull.user.name=用户名不能为空
Size.user.name=用户名长度必须在2到30个字符之间

常见问题 =

问题	解决方案
验证不生效	确保添加了@Valid注解
自定义消息不显示	检查消息资源文件配置
嵌套对象验证	使用@Valid注解嵌套属性

总结

Spring验证框架提供了强大而灵活的数据验证机制，从简单的字段验证到复杂的业务规则验证。通过注解驱动的方式，开发者可以轻松实现各种验证需求，同时保持代码的整洁和可维护性。