JSR303 是一套 JavaBean 參數校驗的標準
1、pom導入依賴
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
2、註解類型
(1)空檢查
@Null 驗證對象是否爲null
@NotNull 驗證對象是否不爲null, 無法查檢長度爲0的字符串
@NotBlank 檢查約束字符串是不是Null還有被Trim的長度是否大於0,只對字符串,且會去掉前後空格.
@NotEmpty 檢查約束元素是否爲NULL或者是EMPTY.
(2)Booelan檢查
@AssertTrue 驗證 Boolean 對象是否爲 true
@AssertFalse 驗證 Boolean 對象是否爲 false
(3)長度檢查
@Size(min=, max=) 驗證對象(Array,Collection,Map,String)長度是否在給定的範圍之內
@Length(min=, max=) 驗證字符串的長度在min和max範圍之內.
(4)日期檢查
@Past 驗證 Date 和 Calendar 對象是否在當前時間之前,驗證成立的話被註釋的元素一定是一個過去的日期
@Future 驗證 Date 和 Calendar 對象是否在當前時間之後 ,驗證成立的話被註釋的元素一定是一個將來的日期
@Pattern 驗證 String 對象是否符合正則表達式的規則,被註釋的元素符合制定的正則表達式,regexp:正則表達式 flags: 指定 Pattern.Flag 的數組,表示正則表達式的相關選項。
(5)數值檢查
建議使用在Stirng,Integer類型,不建議使用在int類型上,因爲表單值爲""時無法轉換爲int,但可以轉換爲Stirng爲"",Integer爲null
@Min 驗證 Number 和 String 對象是否大等於指定的值
@Max 驗證 Number 和 String 對象是否小等於指定的值
@DecimalMax 被標註的值必須不大於約束中指定的最大值. 這個約束的參數是一個通過BigDecimal定義的最大值的字符串表示.小數存在精度
@DecimalMin 被標註的值必須不小於約束中指定的最小值. 這個約束的參數是一個通過BigDecimal定義的最小值的字符串表示.小數存在精度
@Digits 驗證 Number 和 String 的構成是否合法
@Digits(integer=,fraction=) 驗證字符串是否是符合指定格式的數字,interger指定整數精度,fraction指定小數精度。
@Range(min=, max=) 被指定的元素必須在合適的範圍內
@Valid 遞歸的對關聯對象進行校驗, 如果關聯對象是個集合或者數組,那麼對其中的元素進行遞歸校驗,如果是一個map,則對其中的值部分進行校驗.(是否進行遞歸驗證)
@CreditCardNumber信用卡驗證
@Email 驗證是否是郵件地址,如果爲null,不進行驗證,算通過驗證。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)
3、自定義驗證類
(1)自定義註解,至少需要包含message() 、 groups() 、 payload() ,
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = {IsRightValidator.class })
public @interface IsRight {
boolean right() default true;
String message() default "這是驗證失敗的提示信息";
Class<?>[] groups() default { };
Class<? extends Payload>[] payload() default { };
}
(2)自定義註解校驗器類,繼承 ConstraintValidator 類<註解類,註解參數類型> ,重寫 兩個方法(initialize:初始化操作、 isValid:邏輯處理)
public class IsRightValidator implements ConstraintValidator<IsRight, String> {
private boolean right= false;
@Override
public void initialize(IsRight constraintAnnotation) {
right = constraintAnnotation.right();
}
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if(right) {
return true;
}else {
return false;
}
}
4、JSR303註解的使用
(1)需要校驗的bean,一般爲ViewObject的bean中
public class TestVo{
@NotNull
@Length(min=32)
private String password;
...
}
(2)在Controller接口方法的接收參數中使用 @Valid修飾ViewObject
@Controller
public class LoginController {
@RequestMapping("/Test")
@ResponseBody
public void doLogin(HttpServletResponse response, @Valid TestVo testVo) {
log.info(testVo.toString());
...
}