在现代Web应用开发中，数据验证是一项至关重要的任务，确保应用程序接收到的用户输入符合预期规范，不仅能够提高系统的健壮性，也能有效防止潜在的安全漏洞。Spring Framework通过其内置的Spring Validation模块，为我们提供了强大的数据验证功能，本文将带你深入了解Spring Validation的实现原理及其最佳实践。
一、Spring Validation简介
Spring Validation是基于Java Bean Validation规范（JSR 303/349 for Java EE 6/7，JSR 380 for Java EE 8）实现的，主要依赖的是Hibernate Validator作为默认的实现引擎。它允许我们在Java Bean的属性上声明验证注解，从而在运行时对这些属性进行条件性验证。
在实际项目我们需要对客户端传递到服务端的参数进行校验，用于判定请求参数的合法性，假如请求参 数不合法则不可以再去执行后续的业务了。那如何校验呢？
一种方式是我们在控制层方法中每次都自己进行参数有效值的判断，不合法可以抛出异常，但是工作量 和代码复杂度会比较高；
第二种方式就是采用市场上主流的 Spring Validation 框架去实现校验，所以 Spring Validation 框架的主要作用是 检查参数的基本有效性。
二、集成与配置
1. 引入依赖
在Maven或Gradle构建项目中，我们需要引入Hibernate Validator的相关依赖，例如在Maven的pom.xml文件中添加：
Xml
1<dependency>
2 <groupId>org.springframework.boot</groupId>
3 <artifactId>spring-boot-starter-validation</artifactId>
4</dependency>2.使用注解
Spring Validation提供了丰富的预定义注解，如@NotNull，@NotEmpty，@NotBlank，@Size，@Range等，可以直接应用于实体类的字段上：
@NotNull注解
作用：用于验证对象是否为 null
用法： @NotNull 注解用于对象类型上
示例
@NotNull(message = "用户名不能为null")
private String username;
@NotEmpty注解
作用：用于验证字符串是否为空，并且会检查是否为 null 值（为null值时报错）
用法：用于字符串类型上
示例
@NotEmpty(message = "用户名不能为空")
private String username;
@NotBlank注解
作用：不允许为空白，即不允许是“仅由空格、TAB等空白值组成的字符串”，也不允许为空字符串，也不允许为空值null
用法：用于字符串类型上
示例
@NotBlank(message = "用户名不能为空白串")
private String username;@Size注解
作用：可以指定最小值和最大值限制字符串的长度串，也不允许为空值null
用法：用于字符串类型参数
示例
@Size(min = 6, max = 20, message = "用户名长度必须在6到20之间")
private String username;
@Range 注解
作用：用于验证数字类型字段的取值范围，通过配置min和max属性来限制数值类型参数的值区间 包括最小值和最大值
用法：用于数值类型参数
示例
@Range(min = 1, max = 10, message = "年龄必须在1-10岁之间")
private int age;
@Range(min = 0.1, max = 1.0, message = "成绩必须在0.1到1.0之间")
private double score;
三、验证流程与控制器处理
-
控制器层处理： 在Spring MVC的Controller中，我们可以使用
@Valid注解来触发模型对象的验证，紧接着一个BindingResult对象用于捕获验证结果：1@PostMapping("/users") 2public ResponseEntity<?> createUser(@Valid @RequestBody User user, BindingResult bindingResult) { 3 if (bindingResult.hasErrors()) { 4 // 处理验证错误 5 return handleValidationError(bindingResult); 6 } else { 7 // 验证通过，继续处理业务逻辑 8 userService.createUser(user); 9 return ResponseEntity.ok().build(); 10 } 11} -
自定义注解与验证器： 对于更复杂或特定的验证需求，Spring Validation允许我们自定义注解并编写相应的验证器实现
javax.validation.ConstraintValidator接口：1@Target({ElementType.FIELD}) 2@Retention(RetentionPolicy.RUNTIME) 3@Constraint(validatedBy = EncryptedIdValidator.class) 4public @interface EncryptedId { 5 String message() default "加密ID格式不正确"; 6 Class<?>[] groups() default {}; 7 Class<? extends Payload>[] payload() default {}; 8} 9 10public class EncryptedIdValidator implements ConstraintValidator<EncryptedId, String> { 11 // 实现自定义的验证逻辑 12 ... 13}
四、快速入门
1. 在处理请求的方法的参数列表中，在POJO类型的参数上添加 @Validated 注解，表示需要通过 Spring Validation框架检查此参数，例如UserController中注册功能：
@ApiOperation(value = "注册功能")
@PostMapping("reg")
public JsonResult reg(@RequestBody @Validated UserRegDTO userRegDTO){}
2. 在此POJO类中的属性上，添加对应的检查注解，以配置检查规则， 例如，添加 @NotNull 注解，就表示“不允许为 null ”的规则！
在 UserRegDTO 类
@Data
public class UserRegDTO {
@NotNull
@ApiModelProperty(value = "用户名", required = true, example = "赵丽颖")
private String username;
@ApiModelProperty(value = "密码", required = true, example = "123456")
private String password;
@ApiModelProperty(value = "昵称", required = true, example = "萤火虫")
private String nickname;
}
3. 重启工程，在Knife4j中测试，当提交请求时，如果没有提交username参数，服务器端将响应 400 错误。
同时在终端也会出现异常
五、异常处理与响应
1.处理异常
为了给前端提供友好的反馈，通常我们会统一处理验证失败时的异常，将其转换成HTTP状态码和错误信息：
第1步：全局异常处理器 GlobalExceptionHandler 中定义处理异常方法
@ExceptionHandler
public JsonResult handleBindException(MethodArgumentNotValidException ex){
return new JsonResult(3002, "请求参数错误");
}
第2步：重启工程，在Knife4j中测试
2.明确提示信息
当提交的 username 的值为 null 时，可以发现异常已被处理！
但是，处理结果并不合适，因为，客户端得到此结果后，仍无法明确出现了什么错误！
所有的检查注解都可以配置 message 参数，用于对错误进行描述。
第1步： @NotNull 注解中添加 message 参数
@NotNull(message = "必须提交用户名")
private String username;
第2步：自定义枚举状态码 StatusCode
VALIDATE_ERROR(3002, "参数校验失败")第3步：异常方法中获取提示信息 message
在处理异常时，需要调用 MethodArgumentNotValidException 对象的
getFieldError().getDefaultMessage() 获取以上配置的描述文本
@ExceptionHandler
public JsonResult handleBindException(MethodArgumentNotValidException ex){
/*
ex.getFieldError().getDefaultMessage():获取 @NotNull(message="xxx") 中
message的消息
*/
String message = ex.getFieldError().getDefaultMessage();
return new JsonResult(StatusCode.VALIDATE_ERROR, message);
}
第3步：重启工程，在Knife4j中测试
六、非POJO类参数校验
在 Spring Validation 中，除了对 POJO（Plain Old Java Object）进行校验的功能外，还支持对非 POJO 进行校验，比如 String、Integer、Double 等类型的参数。
1.使用流程
- 在当前方法所在的类上添加 @Validated 注解
- 在参数上添加对应的检查注解
2.使用示例
对于微博详情页的 id 参数进行范围校验，范围只能在1-10之间
第1步：在类 WeiboController 中添加 @Validated 注解
@Validated
public class WeiboController {}
第2步：在控制器方法参数 id 上添加对应的检查注解
public JsonResult selectById(@Range(min = 1, max=10, message = "请提交合法的ID
值！") int id)第3步：重启工程，在Knife4j或者浏览器中测试
七、总结
Spring Validation的使用极大地简化了Java应用程序中的数据验证过程，通过标准化的注解机制实现了业务逻辑和数据验证的分离，提高了代码的可读性和可维护性。同时，它也具有良好的扩展性，让我们能够轻松应对各类复杂的验证场景，确保了系统数据质量的同时提升了用户体验。
通过深入理解和灵活运用Spring Validation，开发者能够在后端建立起坚固的数据过滤防线，为构建安全可靠的应用程序打下坚实基础。而随着RESTful API设计的流行，Spring Validation更是成为了保障API契约得到严格遵循的重要工具之一。
