Spring Boot中@Valid 与 @Validated 注解的详解

引言

在Spring Boot应用中，参数校验是确保数据完整性和一致性的重要手段。@Valid和@Validated注解是Spring Boot中用于参数校验的两个核心注解。本文将详细介绍这两个注解的用法、区别以及代码样例。

@Valid注解

功能介绍

@Valid是Java EE提供的标准注解，它是JSR 303规范的一部分，主要用于Hibernate Validation等场景。在Spring Boot中，@Valid注解用于触发参数校验，确保请求参数的合法性。

使用场景

@Valid注解可以用于方法参数、构造函数、方法参数和成员属性上。它主要用于嵌套校验，即对于对象中的属性值（可能是另一个对象）进行校验。

代码样例

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.Valid;public class User {@NotBlank(message = "用户名不能为空")private String username;@NotNull(message = "密码不能为空")private String password;@Validprivate Address address;// Getter 和 Setter
}public class Address {@NotBlank(message = "国家不能为空")private String country;@NotBlank(message = "城市不能为空")private String city;// Getter 和 Setter
}import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;@RestController
public class UserController {@PostMapping("/addUser")public String addUser(@Valid @RequestBody User user, BindingResult bindingResult) {if (bindingResult.hasErrors()) {return "参数校验失败: " + bindingResult.getAllErrors().get(0).getDefaultMessage();}return "用户添加成功";}
}

在上述代码中，User类中的address属性使用了@Valid注解，表示对address对象进行嵌套校验。在UserController中，addUser方法使用了@Valid注解对传入的User对象进行校验，并使用BindingResult捕获校验错误。

@Validated注解

功能介绍

@Validated是Spring框架特有的注解，属于Spring的一部分，也是JSR 303的一个变种。它提供了一些@Valid所没有的额外功能，比如分组验证。@Validated注解可以用在类、方法和方法参数上，但不能用于成员属性。

使用场景

@Validated注解主要用于支持分组验证，可以更细致地控制验证过程。此外，由于它是Spring专有的，因此可以更好地与Spring的其他功能（如Spring的依赖注入）集成。

代码样例

import javax.validation.constraints.Min;
import javax.validation.constraints.NotBlank;
import javax.validation.groups.Default;public interface ValidationGroups {interface Insert extends Default {}interface Update {}
}public class Project {@NotBlank(message = "ID不能为空", groups = ValidationGroups.Update.class)private String id;@NotBlankprivate String name;@Min(value = 1, message = "预算不能小于1", groups = ValidationGroups.Insert.class)private int budget;// Getter 和 Setter
}import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.validation.annotation.Validated;@RestController
public class ProjectController {@PostMapping("/insertProject")public String insertProject(@Validated(value = ValidationGroups.Insert.class) @RequestBody Project project, BindingResult bindingResult) {if (bindingResult.hasErrors()) {return "参数校验失败: " + bindingResult.getAllErrors().get(0).getDefaultMessage();}return "项目插入成功";}@PostMapping("/updateProject")public String updateProject(@Validated(value = ValidationGroups.Update.class) @RequestBody Project project, BindingResult bindingResult) {if (bindingResult.hasErrors()) {return "参数校验失败: " + bindingResult.getAllErrors().get(0).getDefaultMessage();}return "项目更新成功";}
}

在上述代码中，我们定义了一个ValidationGroups接口，用于分组验证。Project类中的id属性在Update分组下必填，而budget属性在Insert分组下必填且不能小于1。在ProjectController中，insertProject方法使用@Validated(value = ValidationGroups.Insert.class)注解对传入的Project对象进行Insert分组的校验，而updateProject方法则使用@Validated(value = ValidationGroups.Update.class)注解进行Update分组的校验。