快速入手 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 行程式碼的電商微服務項目。
