SpringBoot使用@Validated處理校驗(yàn)的方法步驟

更新時(shí)間：2024年08月13日 09:12:52 作者：你住過(guò)的屋檐

@Validated?注解的主要目的是啟用和利用?Spring?的驗(yàn)證框架,它可以用于類上也可以用于方法參數(shù)上,本文給大家介紹了SpringBoot使用@Validated優(yōu)雅的處理校驗(yàn)的方法步驟,通過(guò)代碼示例介紹的非常詳細(xì),需要的朋友可以參考下

前言

@Validated 注解的主要目的是啟用和利用 Spring 的驗(yàn)證框架，它可以用于類上也可以用于方法參數(shù)上。用于類上時(shí)，表示該類中的所有方法參數(shù)都需要通過(guò)驗(yàn)證框架進(jìn)行驗(yàn)證；用于方法參數(shù)上時(shí)，則僅表示該參數(shù)需要被驗(yàn)證。選擇哪種方式取決于具體的業(yè)務(wù)需求和個(gè)人偏好。

步驟

1、引入依賴，這是 Spring 用來(lái)實(shí)現(xiàn)數(shù)據(jù)驗(yàn)證的基礎(chǔ)庫(kù)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2、然后我們將注解@Validated放在類上開(kāi)啟驗(yàn)證功能，將注解@Valid放在參數(shù)實(shí)體上代表對(duì)實(shí)體進(jìn)行校驗(yàn)，例如

@RestController
@RequestMapping("/test")
@Validated
public class TestController {
    @PostMapping()
    public R test(@Valid @RequestBody TestDTO dto){
        return R.ok("響應(yīng)成功");
    }
}

3、然后我們?cè)谡?qǐng)求體中隨時(shí)用如下注解即可通過(guò)框架自動(dòng)進(jìn)行驗(yàn)證，我這里是使用統(tǒng)一異常捕捉進(jìn)行全局異常情況攔截，有關(guān)統(tǒng)一異常封裝，大家可以關(guān)注我看我另一篇文章。

統(tǒng)一的參數(shù)異常捕捉

/**
	 *處理參數(shù)校驗(yàn)異常
	 * @param e
	 * @return
	 */
	@ExceptionHandler
	public R handlerException(MethodArgumentNotValidException e) {
		e.printStackTrace();
		BindingResult bindingResult = e.getBindingResult();
		return R.fail(bindingResult.getFieldErrors().get(0).getDefaultMessage());
	}

參數(shù)實(shí)體

import lombok.Data;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
@Data
public class TestDTO {
    @NotBlank(message = "a參數(shù)不能為空")
    private String a;
    @NotNull(message = "b參數(shù)不能為null")
    private String b;
    @Max(value = 10,message = "請(qǐng)輸入正確的范圍")
    private Integer c;
}

4、通過(guò)apifox工具調(diào)用測(cè)試結(jié)果如下

5、以下是常用的注解說(shuō)明

注解	類型	說(shuō)明
@Null	Object	校驗(yàn)必須為null
@NotNull	Object	校驗(yàn)必須不能是null，并且必須有一個(gè)非空格字符
@NotEmpty	字符串、集合、映射等類型	值不為空（即不為 null 且不為空字符串、空集合或空映射）。
@AssertTrue	boolean、Boolean	參數(shù)需要為true，傳null允許通過(guò)，注意，當(dāng)傳了0時(shí)會(huì)認(rèn)為是false不通過(guò)
@AssertFalse	boolean、Boolean	參數(shù)需要為true，傳null允許通過(guò)，注意，當(dāng)傳了0時(shí)會(huì)認(rèn)為是false允許通過(guò)
@Max	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	允許的最大值，null允許通過(guò)
@Min	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	允許的最小值，null允許通過(guò)
@Negative	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	數(shù)字類型的值必須小于零，null允許通過(guò)
@Negative	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	數(shù)字類型的值必須小于等于零，null允許通過(guò)
@Positive	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	數(shù)字類型的值必須大于零，null允許通過(guò)
@PositiveOrZero	BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	數(shù)字類型的值必須大于等于零，null允許通過(guò)
@Digits(integer = 10, fraction = 2)	字符串、BigDecimal、BigInteger，基本數(shù)字類型及其包裝類等	整數(shù)位數(shù)和小數(shù)位數(shù)限制，null允許通過(guò)
@Pattern	字符串	正則表達(dá)式匹配，null允許通過(guò)
@Email字符串	字符串	郵箱格式校驗(yàn)，null允許通過(guò)
@Size	字符串、集合、映射等類	校驗(yàn)大小的范圍，null允許通過(guò)，如 @Size(min = 1, max = 3, message = “最大范圍為1-3”)

到此這篇關(guān)于SpringBoot使用@Validated處理校驗(yàn)的方法步驟的文章就介紹到這了,更多相關(guān)SpringBoot @Validated處理校驗(yàn)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: