說明:
在我們應用程序的業務邏輯中,經常會碰到參數校驗的情況,手動的在代碼層上面進行校驗就會帶來很不好的體驗,閱讀、維護的成本會大大增加,造成冗余。因此有了這個JSR 303。
Bean Validation為JavaBean提供了相應的API來給我們做參數的驗證。通過Bean Validation比如@NotNull @Pattern等方法來對我們字段的值做進一步的教研。
Bean Validation 是一個運行時框架,在驗證之后錯誤信息會直接返回。
依賴:
<!--添加依賴--> <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version> </dependency>
注意: SpringBoot2 項目web組件已經內置了這個依賴了。
版本提供依賴:
依賴注釋:
注解 | 用途 |
---|---|
AssertFalse | 用於boolean字段,該字段的值只能為false |
AssertTrue | 用於boolean字段,該字段只能為true |
DecimalMax(value) | 被注釋的元素必須是一個數字,只能大於或等於該值 |
DecimalMin(value) | 被注釋的元素必須是一個數字,只能小於或等於該值 |
Digits(integer,fraction) | 檢查是否是一種數字的(整數,小數)的位數 |
被注釋的元素必須是電子郵箱地址 | |
Future | 檢查該字段的日期是否是屬於將來的日期 |
FutureOrPresent | 判斷日期是否是將來或現在日期 |
Max(value) | 該字段的值只能小於或等於該值 |
Min(value) | 該字段的值只能大於或等於該值 |
Negative | 判斷負數 |
NegativeOrZero | 判斷負數或0 |
NotBlank | 只能用於字符串不為null,並且字符串trim()以后length要大於0 |
NotEmpty | 集合對象的元素不為0,即集合不為空,也可以用於字符串不為null |
NotNull | 不能為null |
Null | 必須為 null |
Past | 檢查該字段的日期是在過去 |
PastOrPresent | 判斷日期是否是過去或現在日期 |
Pattern(value) | 被注釋的元素必須符合指定的正則表達式 |
Positive | 判斷正數 |
PositiveOrZero | 判斷正數或0 |
Size(max, min) | 檢查該字段的size是否在min和max之間,可以是字符串、數組、集合、Map等 |
Length(max, min) | 判斷字符串長度 |
CreditCardNumber | 被注釋的字符串必須通過Luhn校驗算法,銀行卡,信用卡等號碼一般都用Luhn計算合法性 |