Spring Boot下如何校驗Spring MVC的請求參數(shù)及如何自定義校驗注解
在Java世界里,用于Java Bean的校驗的標準規(guī)范是JSR 380,又被稱作Bean Validation 2.0。而JSR 380的實現(xiàn)是Hibernate Validator。
Spring Boot提供了spring-boot-starter-validation 為Bean的校驗提供支持。我們可以通過一系列的校驗注解對Java Bean的屬性進行校驗。
本文將演示如何在對Spring MVC的請求參數(shù)進行校驗。當然它可以用在任何Java Bean的校驗上。
我們先新建一個演示項目,注意除了添加“Spring Web”依賴,還需要額外添加“Validation”依賴,從Spring Boot 2.3后,我們需要顯示添加此依賴。
常用JSR 380注解及如何校驗請求DTO
在DTO這個JavaBean上使用JSR 380注解,主要的注解有:
- @NotNull :校驗注解的屬性不能為null
- @AssertTrue : 校驗注解的屬性是true
- @Size : 校驗大小范圍是在min和max之間,可以是String、Collection、Map,和數(shù)組屬性
- @Min: 校驗注解的屬性最小不能小于設定的值
- @Max: 校驗注解的屬性最大不能大于設定的值
- @Pattern:校驗當前字符串屬性符合指定的正則表達式
- @Email :校驗注解屬性是一個有效的郵件地址
- @NotEmpty:校驗注解的屬性不能為null或者是empty,以是String、Collection、Map,和數(shù)組屬性
- @NotBlank: 校驗文本屬性不為null或者空格
- @Positive 和 @PositiveOrZero :校驗整數(shù)是正數(shù)/正數(shù)或0
- @Negative 和 @NegativeOrZero :校驗整數(shù)是負數(shù)/負數(shù)或0
- @Past and @PastOrPresent :校驗日期是過去/過去或現(xiàn)在
- @Future and @FutureOrPresent :校驗日期是未來/未來或現(xiàn)在
注意上面的“message”中設置提示錯誤的信息。
控制器如何生效及如何校驗請求參數(shù)
1、校驗DTO,只需要在@RequestBody前加上注解“@Valid”,若出現(xiàn)校驗錯誤,拋出MethodArgumentNotValidException
2、檢驗請求中的參數(shù)(包括路徑變量),我們需要在類上注解“@Validated”才會生效,若出現(xiàn)校驗錯誤,拋出ConstraintViolationException。此處的@Range注解來自于Hibernate Validator,非標準JSR 380注解。
全局異常處理,給前端友好的校驗提示
當出現(xiàn)校驗錯誤時,Spring Boot只會拋出異常,所以為了讓前端更友好的處理這些異常,我們將對這些拋出的異常做出處理。
驗證效果
運行應用,并違反校驗規(guī)則,如圖:
如何自定義檢驗注解
上面我們使用了JSR 380以及Hibernate的注解來校驗,這節(jié)我們演示如何自定義校驗注解。
我們通過定義個校驗注解“@Enumeration”和在“EnumerationValidator”類中定義校驗規(guī)則。
當前例子演示功能為:只能是枚舉里允許的值,否則校驗不通過。
- 注解定義
1、message屬性定義錯誤信息
2、values設置可選的枚舉值
3、通過“@Constraint”指定校驗的類
注意:若沒有groups()和payload(),會報:javax.validation.constraintdefinitionexception: hv000074
- 校驗邏輯類
這里的邏輯很簡單,只需要可選的枚舉值包含被校驗的值即可。
- 控制器中,當然也配合了類上注解的“@Validated”
啟動驗證結(jié)果:
感謝對我的書《從企業(yè)級開發(fā)到云原生微服務:Spring Boot實戰(zhàn)》的支持。
參考資料:
https://medium.com/codex/spring-boot-create-custom-annotation-to-validate-request-parameter-dcf483539d90
https://www.baeldung.com/spring-boot-bean-validation
https://reflectoring.io/bean-validation-with-spring-boot/
文章出自:??愛科學的衛(wèi)斯理??,如有轉(zhuǎn)載本文請聯(lián)系愛科學的衛(wèi)斯理今日頭條號。