SpringBoot学习篇之@Valid与@Validated的区别

目录

1.介绍2.用法

（1）@Valid用法（2）@Validated用法（3）@Validated实现分组校验（4）@Valid 实现嵌套校验

总结：

1.介绍

说明： 其实@Valid 与 @Validated都是做数据校验的，只不过注解位置与用法有点不同。
不同点：
（1）
@Valid是使用Hibernate validation的时候使用。@Validated是只用Spring Validator校验机制使用。
（2）
@Valid 可以嵌套验证
@Validation 不能进行嵌套验证
（3）
@Valid：可以用在方法、构造函数、方法参数和成员属性（field）上。
@Validated：用在类、方法和方法参数上。但不能用于成员属性（field）。
（如果@Validated注解在成员属性上，则会报不适用于field的错误。）
（4）
@Valid：没有分组功能。
@Validated：提供分组功能，可以在参数验证时，根据不同的分组采用不同的验证机制。

2.用法


（1）@Valid用法

a.导入依赖
SpringBoot项目：

1. <dependency>
2.     <groupId>javax.validation</groupId>
3.     <artifactId>validation-api</artifactId>
4.     <version>1.1.0.Final</version>
5. </dependency>
7. <dependency>
8.     <groupId>org.hibernate</groupId>
9.     <artifactId>hibernate-validator</artifactId>
10.     <version>5.4.1.Final</version>
11. </dependency>

复制代码

b.使用前提是实体类中属性使用注解进行校验

1. package com.example.demo.pojo;
3. import lombok.Data;
4. import org.hibernate.validator.constraints.Length;
5. import org.hibernate.validator.constraints.NotBlank;
6. import org.hibernate.validator.constraints.Range;
7. import org.springframework.format.annotation.DateTimeFormat;
9. import javax.persistence.*;
10. import javax.validation.constraints.NotNull;
11. import java.io.Serializable;
12. import java.util.Date;
14. //lombok
15. @Data
16. public class User implements Serializable {
18.     //用户名
19.     @NotBlank(message = "请输入名称")
20.     @Length(message = "名称不能超过个 {max} 字符", max = 10)
21.     private String username;
23.     //年龄
24.     @NotNull(message = "请输入年龄")
25.     @Range(message = "年龄范围为 {min} 到 {max} 之间", min = 1, max = 100)
26.     private String age;
27. }

复制代码

c.在Controller方法参数中加上@Valid注解

1. package com.example.demo.controller;
3. import com.example.demo.pojo.User;
4. import org.slf4j.Logger;
5. import org.slf4j.LoggerFactory;
6. import org.springframework.validation.BindingResult;
7. import org.springframework.validation.ObjectError;
8. import org.springframework.validation.annotation.Validated;
9. import org.springframework.web.bind.annotation.PostMapping;
10. import org.springframework.web.bind.annotation.RequestBody;
11. import org.springframework.web.bind.annotation.ResponseBody;
12. import org.springframework.web.bind.annotation.RestController;
14. import javax.validation.Valid;
15. import java.util.List;
17. @RestController
18. public class UserController {
20.     public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
22.     @PostMapping("/add")
23.     @ResponseBody
24.     public String add(@Validated User user, BindingResult bindingResult){
25.         if(bindingResult.hasErrors()){
26.             List<ObjectError> allErrors = bindingResult.getAllErrors();
27.             allErrors.forEach( v ->{
28.                 logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
29.             });
30.             return "添加失败";
31.         }
32.         return "添加成功";
33.     }
34. }

复制代码

经过测试填写错误数据，会在控制台输出报错信息。

（2）@Validated用法

a.开启校验框架（与上面一样）

1. <!--1.导入JSR303规范-->
2. <dependency>
3.     <groupId>javax.validation</groupId>
4.     <artifactId>validation-api</artifactId>
5. </dependency>
6. <!--使用hibernate框架提供的校验器做实现-->
7. <dependency>
8.     <groupId>org.hibernate.validator</groupId>
9.     <artifactId>hibernate-validator</artifactId>
10. </dependency>

复制代码

c.在需要开启校验功能的类上使用注解@Validated开启校验功能，对具体的字段设置校验规则,这里讲的是可以在类上使用@Validated注解，配合xml数据绑定。

1. @Component
2. @Data
3. @ConfigurationProperties(prefix = "servers")
4. //开启对当前bean的属性注入校验
5. @Validated
6. public class ServerConfig {
7.     //设置具体的规则
8.     @Max(value = 8888,message = "最大值不能超过8888")
9.     @Min(value = 202,message = "最小值不能低于202")
10.     private int port;
11. }

复制代码

（3）@Validated实现分组校验

注意 分组校验就是把条件加入组中，可以自由选择开启那些组的校验方式。
a.分组接口

1. package com.example.demo.pojo;
2. public interface Group {
3.     interface Update{};
4.     interface FindAll{};
5. }

复制代码

b.实体类

1. package com.example.demo.pojo;
3. import lombok.Data;
4. import org.hibernate.validator.constraints.Length;
5. import org.hibernate.validator.constraints.NotBlank;
6. import org.hibernate.validator.constraints.Range;
7. import org.springframework.format.annotation.DateTimeFormat;
9. import javax.persistence.*;
10. import javax.validation.constraints.NotNull;
11. import java.io.Serializable;
12. import java.util.Date;
14. //lombok
15. @Data
16. public class User implements Serializable {
18.     //用户名
19.     @NotBlank(message = "请输入用户名不能为空",groups = {Group.FindAll.class})
20.     @Length(message = "名称不能超过个 {max} 字符", max = 10 ,groups = {Group.FindAll.class})
21.     private String username;
23.     //年龄
24.     @NotBlank(message = "请输入年龄不能为空",groups = {Group.Update.class})
25.     @Range(message = "年龄范围为 {min} 到 {max} 之间", min = 1, max = 100,groups = {Group.Update.class})
26.     private String age;
27. }

复制代码

c.controller接口：
注意 @Validated有参数 value中写分组名称

1. package com.example.demo.controller;
3. import com.example.demo.pojo.Group;
4. import com.example.demo.pojo.User;
5. import org.slf4j.Logger;
6. import org.slf4j.LoggerFactory;
7. import org.springframework.validation.BindingResult;
8. import org.springframework.validation.ObjectError;
9. import org.springframework.validation.annotation.Validated;
10. import org.springframework.web.bind.annotation.PostMapping;
11. import org.springframework.web.bind.annotation.RequestBody;
12. import org.springframework.web.bind.annotation.ResponseBody;
13. import org.springframework.web.bind.annotation.RestController;
15. import javax.validation.Valid;
16. import java.util.List;
18. @RestController
19. public class UserController {
21.     public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
23.     @PostMapping("/add")
24.     @ResponseBody
25.     //注意@Validated有参数 value中写分组名称
26.     public String add(@Validated(value = {Group.Update.class}) User user, BindingResult bindingResult){
27.         if(bindingResult.hasErrors()){
28.             List<ObjectError> allErrors = bindingResult.getAllErrors();
29.             allErrors.forEach( v ->{
30.                 logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
31.             });
32.             return "添加失败";
33.         }
34.         return "添加成功";
35.     }
36. }

复制代码

（4）@Valid 实现嵌套校验

注: 嵌套检测就是在一个User类中，存在另外一个User2类的属性。嵌套检测User同时也检测User2。
a.实体类User

1. package com.example.demo.pojo;
3. import lombok.Data;
4. import org.hibernate.validator.constraints.Length;
5. import org.hibernate.validator.constraints.NotBlank;
6. import org.hibernate.validator.constraints.Range;
7. import org.springframework.format.annotation.DateTimeFormat;
9. import javax.persistence.*;
10. import javax.validation.Valid;
11. import javax.validation.constraints.NotNull;
12. import java.io.Serializable;
13. import java.util.Date;
15. //lombok
16. @Data
17. public class User implements Serializable {
19.     //用户名
20.     @NotBlank(message = "请输入用户名不能为空1")
21.     private String username;
23.     //年龄
24.     @NotBlank(message = "请输入年龄不能为空1")
25.     private String age;
27.     @Valid
28.     @NotNull(message = "user2不能为空1")
29.     private User2 user2;
30. }
31. }

复制代码

b.实体类User2

1. package com.example.demo.pojo;
3. import lombok.Data;
4. import org.hibernate.validator.constraints.Length;
5. import org.hibernate.validator.constraints.NotBlank;
6. import org.hibernate.validator.constraints.Range;
7. import org.springframework.format.annotation.DateTimeFormat;
9. import javax.persistence.*;
10. import javax.validation.Valid;
11. import javax.validation.constraints.NotNull;
12. import java.io.Serializable;
13. import java.util.Date;
15. package com.example.demo.pojo;
17. import lombok.Data;
18. import org.hibernate.validator.constraints.Length;
19. import org.hibernate.validator.constraints.Range;
21. import javax.validation.constraints.NotNull;
22. import java.io.Serializable;
24. //lombok
25. @Data
26. public class User2 implements Serializable {
28.     //用户名
29.     @Length(message = "名称不能超过个 {max} 字符2", max = 10 )
30.     private String username2;
32.     //年龄
34.     @Range(message = "年龄范围为 {min} 到 {max} 之间2", min = 1, max = 100)
35.     private String age2;
36. }

复制代码

c.Controller类（这里使用@Valid）

1. package com.example.demo.controller;
3. import com.example.demo.pojo.Group;
4. import com.example.demo.pojo.User;
5. import org.slf4j.Logger;
6. import org.slf4j.LoggerFactory;
7. import org.springframework.validation.BindingResult;
8. import org.springframework.validation.ObjectError;
9. import org.springframework.validation.annotation.Validated;
10. import org.springframework.web.bind.annotation.PostMapping;
11. import org.springframework.web.bind.annotation.RequestBody;
12. import org.springframework.web.bind.annotation.ResponseBody;
13. import org.springframework.web.bind.annotation.RestController;
15. import javax.validation.Valid;
16. import java.util.List;
18. @RestController
19. public class UserController {
21.     public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
23.     @PostMapping("/add")
24.     @ResponseBody
25.     public String add(@Valid User user, BindingResult bindingResult){
26.         if(bindingResult.hasErrors()){
27.             List<ObjectError> allErrors = bindingResult.getAllErrors();
28.             allErrors.forEach( v ->{
29.                 logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
30.             });
31.             return "添加失败";
32.         }
33.         return "添加成功";
34.     }
35. }

复制代码

总结：

了解这两个注解可以让你的校验数据更加方便。
到此这篇关于SpringBoot学习篇之@Valid与@Validated区别的文章就介绍到这了,更多相关SpringBoot @Valid与@Validated区别内容请搜索中国红客联盟以前的文章或继续浏览下面的相关文章希望大家以后多多支持中国红客联盟！