SpringBoot参数校验
作者:mmseoamin日期:2023-12-11

目录

一、简单数据类型校验

1.1 编写相关Controller

1.2 测试结果

二、异常处理

2.1 错误页面

2.2 测试结果

三、参数校验相关注解

3.1 测试Controller

3.2 测试结果

四、对象类型参数校验

4.1 添加实体类

4.2 添加测试方法

4.3 测试结果


SpringBoot自带了validation工具可以从后端对前端传来的参数进行校验,用法如下:

首先得添加依赖

          org.springframework.boot

          spring-boot-starter-validation

一、简单数据类型校验

1.1 编写相关Controller

@Validated
@RestController
public class TestController {
    @GetMapping("/t1")
    // name不能为空
    public String t1(@NotBlank String name){
        System.out.println(name);
        return name;
    }
}

在要开启参数校验的类上方添加Validated注解,代表该类开启参数校验,访问http://localhost:8080/t1,发现当没有传来参数时,会抛出 ConstraintViolationException 异常。 接下来让我们测试一下啪

1.2 测试结果

SpringBoot参数校验,第1张

可以看到不能为空,表示t1路径下第一个参数不能为空,接下来我们输入参数看看

SpringBoot参数校验,第2张

如果我们不想输出这种提示信息,我们还可以自定义提示信息,这时就要在注解添加message属性,属性值代表错误信息

public String t1(@NotBlank(message = "名字不能为空") String name){

    System.out.println(name);

    return name;

}

再运行看看

SpringBoot参数校验,第3张

这样就正常了。

二、异常处理

好喽,在上面我们可以看到异常页面不太好看,这样我们可以配置自定义的程序出现错误跳转的错误页面。

当抛出 ConstraintViolationException 异常后,我们可以使用SpringMVC的异常处理器,也可以使用SpringBoot自带的异常处理机制。

当程序出现了异常,SpringBoot会使用自带的 BasicErrorController 对象处理异常。该处理器会默认跳转到/resources/templates/error.html页面。

2.1 错误页面




    
    错误页面


服务器开小差了~

2.2 测试结果

SpringBoot参数校验,第4张

OK,可以正常显示错误页面

三、参数校验相关注解

参数校验相关注解
注解作用
@NotNull判断包装类是否为null
@NotBlank判断字符串是否为null或者是空串(去掉首尾空格)
@NotEmpty判断集合是否为空
@Length判断字符的长度(最大或者最小)
@Min判断数值最小值
@Max判断数值最大值
@Email判断邮箱是否合法

3.1 测试Controller

    @RequestMapping("/t2")
    public String t2(@NotBlank @Length(min = 1,max = 5) String name,
                     @NotNull @Min(0) @Max(150) Integer age,
                     @NotEmpty @RequestParam List address,
                     @NotBlank @Email String email){
        System.out.println(name);
        System.out.println(age);
        System.out.println(address);
        System.out.println(email);
        return "请求成功";
    }

OK,我们这个测试方法主要就是有四个参数,第一个name不能为空,且长度最小为1且不能超过5,第二个参数是年龄age,最小值为0且不能超过150, 第三个参数值就是address,这是一个集合,不能为空,第四个参数是邮箱,邮箱格式也要正确。

3.2 测试结果

OK,接下来我们测试一下什么都没有输入,直接测试

SpringBoot参数校验,第5张

接下来输入如下图

SpringBoot参数校验,第6张

四、对象类型参数校验

SpringBoot也可以校验对象参数中的每个属性,用法如下:

4.1 添加实体类

package com.example.springbootdemo4.pojo;
import jakarta.validation.constraints.Max;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
public class Student {
    @NotBlank(message = "姓名不能为空")
    private String name;
    @NotNull(message = "年龄不能没有") @Min(6) @Max(18)
    private Integer age;
    public Student() {
    }
    public Student(String name, Integer age) {
        this.name = name;
        this.age = age;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public Integer getAge() {
        return age;
    }
    public void setAge(Integer age) {
        this.age = age;
    }
    @Override
    public String toString() {
        return "Student [" +
                "name='" + name + '\'' +
                ", age=" + age +
                " ]";
    }
}

4.2 添加测试方法

    @RequestMapping("/t3")
    public String t3(@Validated Student student, BindingResult brs){
        // 判断是否有参数异常
        if(brs.hasErrors()){
            // 所有参数异常
            List list = brs.getAllErrors();
            // 遍历参数异常输出信息
            list.forEach(System.out::println);
            return "参数异常";
        }
        System.out.println(student);
        return "success";
    }

4.3 测试结果

SpringBoot参数校验,第7张

SpringBoot参数校验,第8张

可以看到控制台输出可以识别到,

SpringBoot参数校验,第9张

Ok,这里乱码是因为这个模块的JDK版本较高,和项目版本不切合,但是我们可以知道他是表示年龄要在6-18的就好啦

SpringBoot参数校验,第10张