加载中…SpringBoot整合Validation进行参数校验
(2022-05-31 20:51:08)目录
依赖
在controller中校验接收到的参数
Validation常用注解
异常处理
多级嵌套校验
分组校验
spring、lombok提供了一些参数校验的注解，比如@Nullable、@NonNull
，但比较鸡肋，常用Validation的注解来校验controller接收到的参数。
以springboot整合validation为例。
依赖
创建时勾选 I/O -> Validation，也可以手动添加依赖
1
2
3
4
5
实质是使用hibernate的遗产 hibernate-validator，也可以直接引入下面的依赖
1
2
3
4
5
在controller中校验接收到的参数
@Controller
@Validated //类上加spring的注解 @Validated
public class TestController {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
@Getter
@Setter
@ToString
@AllArgsConstructor
public class User implements Serializable {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Validation常用注解
@NotNull //常用于校验包装类型、数组，不能为null
@NotEmpty
//校验包装类型、String、数组、集合，不能为null。如果是集合、数组，里面要有元素；如果是字符串，不能为空串，但可以是空格串
@NotBlank
//校验String，不能为null，且不能为空串、空格串
//如果是String，不管前端有没有传该字段、该字段是否有值，后端该字段一定不为null，要用@NotEmpty|@NotBlank不能用@NotNull
//如果是数组（复选框），后端会先检验数组中是否有元素，有才new一个数组来接收，可以用@NotNull来校验
//总结：包装类用NotNull，String用@NotEmpty|@NotBlank，数组用@NotNull|@NotEmpty
@Max(100)
//校验数值型，参数指定允许的最大值（long型），value=100，此处简写了
@Min(1)
@Range(min = 1, max = 100)
//校验数值型的范围，相当于@Min+@Max
@DecimalMax(@DecimalMax(value = "100.00", inclusive =
false)
//校验定点型，可指定String类型的最大值，是否包含该值（默认true）
@DecimalMin("0.0")
@Digits(integer = 4, fraction = 2)
//校验数值型，限定整数部分最多4位，小数部分最多2位
@Future //校验Date，必须大于当前时间，即必须是未来
@Past
@Email //必须是email格式
@URL //必须是url格式
@Length(min = 5, max = 10)
//校验字符串、数组长度（leng），【5,10】
@Size(min = 5, max = 10)
//校验集合的元素个数（size），【5,10】
@Pattern(regexp = "\\d+", message = "只能输入1个或多个阿拉伯数字")
//使用指定的正则表达式进行校验，\d+，第一个\是转义用的
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
以上注解均可指定message，如果不指定会使用默认的message。建议都指定message，返回给用户的提示更友好。
异常处理
不满足校验条件时会直接抛出 ConstraintViolationException
异常，可在全局异常处理中捕获处理，获取message返回给前端
@ControllerAdvice
public class GlobalExceptionHandler {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
多级嵌套校验
@Controller
@Validated
public class TestController {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
@Getter
@Setter
@ToString
public class User implements Serializable {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
如果要检验的参数是实体类，而这个实体类中又嵌套了实体类，如果要校验内嵌的实体类中的成员变量，还需要在内嵌的实体类成员上加@Valid。
spring的 @Validated 不支持多级嵌套校验，Validation的 @Valid 则支持。
分组校验
多个方法都要使用某个实体类作为参数，但对这个实体类的成员变量的校验规则不同，这时可以使用分组校验。
public interface OperateById {
}
public interface FindByUser extends Default {
}
1
2
3
4
5
6
7
8
9
10
11
12
@Getter
@Setter
@ToString
public class User implements Serializable {
//使用groups指定该字段所属的分组，属于多个组时写成数组形式
//如果缺省groups属性，默认为Default.class，属于默认分组
@Pattern(regexp = "[0-9]{11}")
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Controller
@Validated
public class TestController {
}
1
2
3
4
5
6
7
8
9
10
11
12
13
校验时会使用指定分组中的校验规则进行校验。示例中
OperateById分组只校验id字段是否满足@NotNull
默认分组只校验tel字段是否为11位的阿拉伯数字
FindByUser分组会校验id字段是否满足@NotNull、name字段是否满足@NotBlank，因为FindByUser继承了Default，所以也会校验默认分组中的字段
自定义的分组要不要继承Default，视需求而定。
————————————————
版权声明：本文为CSDN博主「chy1984」的原创文章，遵循CC 4.0
BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/chy_18883701161/article/details/109848241
喜欢
0
赠金笔