spring boot validation参数校验与分组嵌套各种类型及使用小结

更新时间：2023年09月25日 15:13:49 作者：一只小余

参数校验基本上是controller必做的事情，毕竟前端传过来的一切都不可信，validation可以简化这一操作，这篇文章主要介绍了spring boot validation参数校验分组嵌套各种类型及使用小结,需要的朋友可以参考下

写在前面：

参数校验基本上是controller必做的事情，毕竟前端传过来的一切都不可信。但是每次if(StrUtil.isNotNull())啥的有时候多还难写。validation可以简化这一操作。

项目构建

采用boot3，主要依赖为spring web 和validation

主要依赖：

&lt;dependency&gt;
&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
&lt;artifactId&gt;spring-boot-starter-validation&lt;/artifactId&gt;
&lt;/dependency&gt;

项目结构

问题展示

先来个简单的案例

@RestController
public class ValidationController {
@GetMapping("/get")
public String get(String name,String age){
System.out.println(name);
System.out.println(age);
return "ok";
}
}

点击这个就可以发送请求了

发送出去不会做任何校验

这个的处理我们可以选择加上@RequestParam注解。@RequestParam默认属性require为true，就是必须要传值，

public String get(@RequestParam String name,@RequestParam String age)

报错返回

封装成实体类也是一样的。

但是这样只能做非null判断，不能做复杂的判断。在body里面的时候更加不会校验了

validation使用

那么validation又如何做到呢。

快速入门

需求：get请求中，name长度在2-10，age在10-100岁之间且都不为null。

@GetMapping("/get")
public String get(@Length(max = 10,min = 2) String name,
@Min(10)@Max(100) String age){
System.out.println("name = " + name);
System.out.println("age = " + age);
return "ok";
}

为null发送，好ok一点用没有。

我查资料发现需要参数前面加上启动校验@Validated或者@Valid注解，但是无论我怎么放到都是没有校验。全部无效。

我之前研究了半天，然后才发现，如果想要这样校验的话，需要在controller类上面加上@Validated且Valid都不行。

如果是实体类接收就不一样了。直接在方法就可以了

注释

到这里基本使用应该就差不多知道了。现在来进行注解的学习。

注解通用属性基本上都有的

属性	描述
message	错误返回描述
groups	分组，可以进行更加灵活的选择。
payload

无参注解，无必须传的值

注解	限制	类型
@Null	限制只能为null	接收任何类型，这个应该用的比较少
@NotNull	限制必须不为null	接收任何类型
@AssertFalse	限制必须为false	支持的类型包括 boolean 和 Boolean。null 元素被视为有效。
@AssertTrue	限制必须为true	支持的类型包括 boolean 和 Boolean。null 元素被视为有效。
@Future	限制必须是一个将来的日期	大部分的时间类如果Date、Calendar、Instant、LocalDate等。null 元素被视为有效
@Past	限制必须是过去的时刻、日期或时间	和上面一样
@PastOrPresent	带注释的元素必须是过去或现在的时刻、日期或时间	同上
@NotEmpty	带批注的元素不得为 null和空	CharSequence（计算字符序列的长度）Collection （集合大小）Map （大小）数组（计算数组长度）
@NotBlank	带批注的元素不得且 null 必须至少包含一个非空格字符	CharSequence
@Positive	带注释的元素必须是严格的正数（即 0 被视为无效值）。	BigDecimal、BigInteger、byteintlong、 short及其floatdouble各自的包装器
@PositiveOrZero	正数或0	同上

大小注解，用于限值大小

注解	限制	类型
@DecimalMax(value，inclusive)	限制必须为一个不大于指定值的value数字，inclusive：指定指定的最小值是包含的还是排除的true为不包括最小值	BigDecimal、BigInteger、CharSequence、byte、 shortintlong及其各自的包装器，请注意， double 由于舍入错误，不支持（某些 float 提供程序可能会提供一些近似支持）。null 元素被视为有效。
@DecimalMin(value，inclusive)	限制必须为一个不小于指定值的value数字，inclusive：最大值是否包括	同上
@Digits(integer,fraction)	必须是接受范围内的数字，且整数部分的位数不能超过integer，小数部分的位数不能超过fraction	同上
@Max(value)	限制必须为一个不大于指定值的数字	同上
@Min(value)	限制必须为一个不小于指定值的数字	同上
@Length(min = 6, max = 16)	指定传入的字符串的长度	字符串
@Size(max,min)	限制字符长度必须在min到max之间【不是数字】	同notempty，集合类数组和字符
@Range	带批注的元素必须在适当的范围内。	应用于数值或数值的字符串表示形式。

基于正则类型

注解	限制	类型
@Pattern(value)	限制必须符合指定的正则表达式	CharSequence，null有效
@Email	验证注解的元素值是Email，可选值regexp，flags也可以通过正则表达式和flag指定自定义的email格式。因为每个人要求的邮箱可能格式也不一样，如我可以通过regexp设置后缀必须为@qq.com	CharSequence，null有效
@CreditCardNumber	信用卡校验	同上
@URL	批注的字符串是否为 URL基于正则表达式的。	同上
@UUID	批注的字符序列是否为有效的 UUID，version指定版本variant变体，letterCase所需的字母大小写默认情况下只有小写有效，allowNil如果 nil UUID 有效根据默认值 nil UUID 00000000-0000-0000-0000-000000000000 有效，allowEmpty允许空字符串。默认情况下不允许空字符串

脚本注解

@ScriptAssert
它根据批注元素计算脚本表达式。此约束可用于实现验证例程，脚本表达式可以用任何脚本或表达式语言编写，在类路径上可以找到 JSR 223 （“JavaTM 平台脚本”）兼容引擎。下面的清单显示了使用 JDK 附带的 JavaScript 引擎的示例：
我看到的时候给我震惊了一下，他注解写的啥？？任何表达式语言？？不过可能是我没见过世面，或者是知识点用的少，java6就支持JavaScript。不过一般很少用吧。

下面是一个校验时间的脚本

@ScriptAssert(lang = "javascript", script = "_this.startDate.before(_this.endDate)")   
public class CalendarEvent {
     private Date startDate;
     private Date endDate;
     //...
}

注意！！！java11开始就移除了NashornScriptEngineFactory，所以11以上需要添加依赖才可以使用javascript需要新增

        <dependency>
            <groupId>org.openjdk.nashorn</groupId>
            <artifactId>nashorn-core</artifactId>
            <version>15.4</version>
        </dependency>

没有通过

修改时间通过了

Valid与Validated区别

Validated是Valid的加强版

使用范围

经过我的层层验证

controller类上：
在controller类上只有使用validated，将开启所有的路径参数验证，对实体类（路径和body）无效
方法上：
全部无效，无论是路径还说body，2个注解都没用。
入参上：
只有在对body或者路径参数实体类或者添加注解才有效，2个都有效，对单独的类型无效
实体类的属性上
Valid有效，且路径参数有效，body无效，body需要自己参数开启，无论参数是否加验证注解

两者是否能用于成员属性（字段）上直接影响能否提供嵌套验证的功能。

分组

@Validated：提供了一个分组功能，可以在入参验证时，根据不同的分组采用不同的验证机制。没有添加分组属性时，默认验证没有分组的验证属性。Valid是不能进行分组的，灵活性更差。

public class DemoQuery {
    @Length(max = 10, min = 2,groups = {Demo1.class, Demo2.class},message = "name长度不符合要求")
    private String name;
    @Min(value = 10,groups = {Demo1.class}) @Max(100)
    @NotNull
    private Integer age;
}

    @PostMapping("/post2")
    public String post2(@Validated({Demo2.class}) @RequestBody DemoQuery query, @NotNull String id) {
        System.out.println("name = " + query.getName());
        System.out.println("age = " + query.getAge());
        System.out.println("id = " + id);
        return "ok";
    }

不通过

通过

改为demo1

嵌套验证

新增一个类

@Data
public class NestedQuery {
    @NotNull
    private String id;
    @Valid
    @NotNull
    private DemoQuery querys;
}

    @GetMapping("/nested")
    public String nested(@Validated NestedQuery query, BindingResult bindingResult) {
        System.out.println("id = " + query.getId());
        System.out.println("query = " + query.getQuerys());
        System.out.println(bindingResult);
        return "ok";
    }

发送返回的居然是ok，

但是在控制台，验证说出错了，说明嵌套的错误不会直接返回，而是会记录。需要自己处理一下。

如

Assert.isTrue(!bindingResult.hasErrors(),"参数错误");

结束：收工，累死了。

到此这篇关于spring boot validation参数校验及分组嵌套各种类型及使用小结的文章就介绍到这了,更多相关spring boot validation参数校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解spring boot starter redis配置文件
spring-boot-starter-Redis主要是通过配置RedisConnectionFactory中的相关参数去实现连接redis service。下面通过本文给大家介绍在spring boot的配置文件中redis的基本配置，需要的的朋友参考下
2017-07-07
Java中Synchronized锁的使用和原理详解
这篇文章主要介绍了Java中Synchronized锁的使用和原理详解,synchronized是 Java 内置的关键字，它提供了一种独占的加锁方式,synchronized的获取和释放锁由JVM实现，用户不需要显示的释放锁，非常方便,需要的朋友可以参考下
2023-07-07
Servlet+JDBC实现登陆功能的小例子(带验证码)
这篇文章主要介绍了Servlet+JDBC实现登陆功能的小例子(带验证码)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-06-06
Java中easypoi的使用之导入校验
因工作需要,使用easypoi导入表格,并进行校验,将表格中有问题的地方,给出提示信息,以表格形式返回,下面这篇文章主要给大家介绍了关于Java中easypoi的使用之导入校验的相关资料,需要的朋友可以参考下
2023-03-03
Java并发 CompletableFuture异步编程的实现
这篇文章主要介绍了Java并发 CompletableFuture异步编程的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-01-01
Java 中的 BufferedWriter 介绍_动力节点Java学院整理
BufferedWriter 是缓冲字符输出流。它继承于Writer。接下来通过本文给大家分享Java 中的 BufferedWriter知识，需要的朋友参考下吧
2017-05-05
java中枚举原来还可以这么用
这篇文章主要给大家介绍了关于java枚举原来还可以这么用的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用java具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-09-09
关于spring中单例Bean引用原型Bean产生的问题及解决
这篇文章主要介绍了关于spring中单例Bean引用原型Bean产生的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-06-06
详解Spring MVC事务配置
这篇文章主要介绍了详解Spring MVC事务配置，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-04-04
java使用RSA工具进行信息加解密
我们在开发中需要对用户敏感数据进行加解密,比如密码等信息,这篇文章主要为大家详细介绍了java如何使用RSA工具进行信息加解密,感兴趣的小伙伴可以了解下
2023-12-12