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参数校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Jackson自定义序列化反序列化注解加解密字段详解
这篇文章主要介绍了Jackson自定义序列化反序列化注解加解密字段详解,一些场景中,数据库字段用于存储json格式数据,处于安全的考虑,该json数据中,某些敏感信息字段需要做加密存储,例如身份证号、手机号等,需要的朋友可以参考下
2023-11-11
Java实现PDF转为Word文档的示例代码
众所周知，PDF文档除了具有较强稳定性和兼容性外, 还具有较强的安全性，在工作中可以有效避免别人无意中对文档内容进行修改。本文将分为以下两部分介绍如何在保持布局的情况下将PDF转为Word文档，希望对大家有所帮助
2023-01-01
SpringBoot参数校验全指南分享
这篇文章主要介绍了SpringBoot参数校验全指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2026-05-05
JAVA 枚举相关知识汇总
这篇文章主要介绍了JAVA 枚举相关知识，文中讲解的非常详细，代码帮助大家更好的参考和学习，感兴趣的朋友可以了解下
2020-06-06
springMVC自定义注解,用AOP来实现日志记录的方法
下面小编就为大家分享一篇springMVC自定义注解,用AOP来实现日志记录的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-01-01
maven版本冲突的原籍及几种解决方法
Maven版本冲突是指在使用Maven构建项目时,由于依赖传递机制导致同一个依赖的不同版本被引入项目中,从而引发的兼容性问题,下面就来介绍几种解决方法,感兴趣的可以了解一下
2025-12-12
MyBatis各种类型查询数据参数绑定的实现
本文主要介绍了MyBatis各种类型查询数据参数绑定的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-06-06
Spring MVC如何实现接口Controller定义控制器
这篇文章主要介绍了Spring MVC如何实现接口Controller定义控制器，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-02-02
JPA实现多条件分页查询
这篇文章主要介绍了JPA实现多条件分页查询方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-07-07
Java中数组和List的互相转换问题小结
这篇文章主要介绍了Java中数组和List的互相转换问题小结,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2024-03-03