快捷導(dǎo)航

SpringBoot參數(shù)校驗(yàn)示例詳解

更新時(shí)間：2023年10月25日 10:19:35 作者：會(huì)洗碗的CV工程師

SpringBoot自帶了validation工具可以從后端對(duì)前端傳來的參數(shù)進(jìn)行校驗(yàn),本文給大家介紹SpringBoot參數(shù)校驗(yàn)及用法,感興趣的朋友跟隨小編一起看看吧

一、簡(jiǎn)單數(shù)據(jù)類型校驗(yàn)

1.1 編寫相關(guān)Controller

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

在要開啟參數(shù)校驗(yàn)的類上方添加Validated注解，代表該類開啟參數(shù)校驗(yàn)，訪問http://localhost:8080/t1，發(fā)現(xiàn)當(dāng)沒有傳來參數(shù)時(shí)，會(huì)拋出 ConstraintViolationException 異常。接下來讓我們測(cè)試一下啪

1.2 測(cè)試結(jié)果

可以看到不能為空，表示t1路徑下第一個(gè)參數(shù)不能為空，接下來我們輸入?yún)?shù)看看

如果我們不想輸出這種提示信息，我們還可以自定義提示信息，這時(shí)就要在注解添加message屬性，屬性值代表錯(cuò)誤信息

public String t1(@NotBlank(message = "名字不能為空") String name){
    System.out.println(name);
    return name;
}

再運(yùn)行看看

這樣就正常了。

二、異常處理

好嘍，在上面我們可以看到異常頁面不太好看，這樣我們可以配置自定義的程序出現(xiàn)錯(cuò)誤跳轉(zhuǎn)的錯(cuò)誤頁面。

當(dāng)拋出 ConstraintViolationException 異常后，我們可以使用SpringMVC的異常處理器，也可以使用SpringBoot自帶的異常處理機(jī)制。
當(dāng)程序出現(xiàn)了異常，SpringBoot會(huì)使用自帶的 BasicErrorController 對(duì)象處理異常。該處理器會(huì)默認(rèn)跳轉(zhuǎn)到/resources/templates/error.html頁面。

2.1 錯(cuò)誤頁面

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="UTF-8">
    <title>錯(cuò)誤頁面</title>
</head>
<body>
<h1>服務(wù)器開小差了~</h1>
</body>
</html>

2.2 測(cè)試結(jié)果

OK，可以正常顯示錯(cuò)誤頁面

三、參數(shù)校驗(yàn)相關(guān)注解

參數(shù)校驗(yàn)相關(guān)注解

注解	作用
@NotNull	判斷包裝類是否為null
@NotBlank	判斷字符串是否為null或者是空串(去掉首尾空格)
@NotEmpty	判斷集合是否為空
@Length	判斷字符的長(zhǎng)度(最大或者最小)
@Min	判斷數(shù)值最小值
@Max	判斷數(shù)值最大值
@Email	判斷郵箱是否合法

3.1 測(cè)試Controller

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

OK，我們這個(gè)測(cè)試方法主要就是有四個(gè)參數(shù)，第一個(gè)name不能為空，且長(zhǎng)度最小為1且不能超過5，第二個(gè)參數(shù)是年齡age，最小值為0且不能超過150，第三個(gè)參數(shù)值就是address，這是一個(gè)集合，不能為空，第四個(gè)參數(shù)是郵箱，郵箱格式也要正確。

3.2 測(cè)試結(jié)果

OK，接下來我們測(cè)試一下什么都沒有輸入，直接測(cè)試

接下來輸入如下圖

四、對(duì)象類型參數(shù)校驗(yàn)

SpringBoot也可以校驗(yàn)對(duì)象參數(shù)中的每個(gè)屬性，用法如下：

4.1 添加實(shí)體類

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 添加測(cè)試方法

    @RequestMapping("/t3")
    public String t3(@Validated Student student, BindingResult brs){
        // 判斷是否有參數(shù)異常
        if(brs.hasErrors()){
            // 所有參數(shù)異常
            List<ObjectError> list = brs.getAllErrors();
            // 遍歷參數(shù)異常輸出信息
            list.forEach(System.out::println);
            return "參數(shù)異常";
        }
        System.out.println(student);
        return "success";
    }