Springboot集成JSR303參數校驗

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());
        
    	...
    }

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章