快速入手 Spring Boot 參數校驗

  • 2019 年 12 月 24 日
  • 筆記

來源:狂亂的貴公子 cnblogs.com/cjsblog/p/8946768.html

  • 1、背景介紹
  • 2、Spring Boot文檔中的Validation
  • 3、Hibernate Validator
  • 4、Spring Validator
  • 5、示例
  • 6、補充
  • 參考

1、背景介紹

開發過程中,後台的參數校驗是必不可少的,所以經常會看到類似下面這樣的程式碼

這樣寫並沒有什麼錯,還挺工整的,只是看起來不是很優雅而已。

接下來,用Validation來改寫這段

2、Spring Boot文檔中的Validation

在Spring Boot的官網中,關於Validation只是簡單的提了一句,如下

其實,Spring Validator 和**Hibernate Validator** 是兩套Validator,可以混著用,這裡我們用**Hibernate Validator**

3、Hibernate Validator

https://docs.jboss.org/hibernate/stable/validator/reference/en-US/html_single/#preface

4、Spring Validator

https://docs.spring.io/spring/docs/5.0.5.RELEASE/spring-framework-reference/core.html#validation

5、示例

5.1、引入spring-boot-starter-validation

5.2、定義一個對象

5.3、適用@Valid校驗,並將校驗結果放到BindingResult對象中

注意:

  • 默認情況下,如果校驗失敗會拋javax.validation.ConstraintViolationException異常,可以用統一異常處理去對這些異常做處理
  • An Errors/BindingResult argument is expected to be declared immediately after the model attribute

5.4、看效果

如果在校驗的對象後面再加上Model對象的話,如果返回的是ModelAndView就可以將這個Model設置到其中,這樣在頁面就可以取到錯誤消息了

僅僅只是單欄位校驗的話未免也太不靈活了吧,如果欄位之間有關聯關係,那該如何校驗呢?答案是自定義

5.5、自定義校驗規則

https://docs.jboss.org/hibernate/stable/validator/reference/en-US/html_single/#validator-customconstraints

這裡,以優惠券創建為例來演示如何自定義校驗規則

首先,優惠券表單如下(僅僅只是演示用):

這裡除了自定義了兩條校驗規則之外,還用到了分組。

為什麼要有分組這一說呢?因為,舉個例子,添加的時候不需要校驗id,而修改的時候id不能為空,有了分組以後,就可以添加的時候校驗用組A,修改的時候校驗用組B

下面重點看一下@CheckTimeInterval

第一步 、定義一個註解叫CheckTimeInterval

第二步 、定義Validator去校驗它

順便提一句,這裡BeanWrapper去取對象的屬性值,我們稍微看一下BeanWrapper是做什麼的

言歸正傳

第三步 、驗證

看,自定義的校驗生效了

6、補充

6.1、校驗模式

https://docs.jboss.org/hibernate/stable/validator/reference/en-US/html_single/#section-fail-fast

下面補充一點,關於校驗模式

默認會校驗完所有屬性,然後將錯誤資訊一起返回,但很多時候不需要這樣,一個校驗失敗了,其它就不必校驗了

為此,需要這樣設置

6.2、單個參數校驗

如果是調整頁面的時候參數校驗失敗的話,這時可以不做處理,讓其調到錯誤頁面。

如果是介面參數校驗失敗的話,可以在這裡進行統一處理,並返回。例如:

6.3、錯誤頁面

以剛才優惠券詳情為例

http://localhost:8080/coupon/detail.html      400

http://localhost:8080/coupon/detail.html?id=    400

http://localhost:8080/coupon/detail.html?id=abc   400

http://localhost:8080/coupon/detail222.html?id=123  404

無許可權  403

int a = 1 / 0;  500

6.4、@Valid與@Validated

https://blog.csdn.net/qq_27680317/article/details/79970590

參考

http://rensanning.iteye.com/blog/2357373

https://blog.csdn.net/kenight/article/details/77774465

https://www.cnblogs.com/mr-yang-localhost/p/7812038.html

https://www.phpsong.com/3567.html

https://www.cnblogs.com/mr-yang-localhost/p/7812038.html

最近更新《芋道 SpringBoot 2.X 入門》系列,已經 20 余篇,覆蓋了 MyBatis、Redis、MongoDB、Elasticsearch、分庫分表、讀寫分離、SpringMVC、SpringWebflux、WebSocket、Dubbo、RocketMQ、Kafka、性能測試等等內容。

提供近 2W 行程式碼的 SpringBoot 示例,以及超 4W 行程式碼的電商微服務項目。

Tags: