jsr-303 參數校驗-學習（轉）

1、是什么？

JSR303 是一套 JavaBean 參數校驗的標准，它定義了很多常用的校驗注解，比如：

-------------------------------------------------
@NotNull(message="名字不能為空")
private String userName;
@Max(value=90,message="年齡不能超過90歲")
private int age;
@Email(message="郵箱格式錯誤")
private String email;
--------------------------------------------------

就像上邊一樣，把注解加在我們 JavaBean的 屬性上面，就可以在需要校驗的時候進行校驗了。

 

2、誤區（跟 hibernate orm 有關系）

JSR-303 是 JAVA EE 6 中的一項子規范，叫做 Bean Validation，官方參考實現是Hibernate Validator。

 

所以就認為他跟 Hibernate 有關系了...

 

但是，他真的一點關系都沒有....

 

Hibernate Validator 只是 Bean Validation 的參考實現 ， Hibernate Validator 提供了 JSR-303 規范中所有內置 constraint 的實現，除此之外還有一些附加的 constraint

 

3、依賴導入（spring-boot）

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

 

4、常用注解

4.1、空檢查

@Null 驗證對象是否為null
@NotNull 驗證對象是否不為null, 無法查檢長度為0的字符串
@NotBlank 檢查約束字符串是不是Null還有被Trim的長度是否大於0,只對字符串,且會去掉前后空格.
@NotEmpty 檢查約束元素是否為NULL或者是EMPTY.

4.2、Booelan檢查

@AssertTrue 驗證 Boolean 對象是否為 true
@AssertFalse 驗證 Boolean 對象是否為 false

4.3、長度檢查

@Size(min=, max=) 驗證對象（Array,Collection,Map,String）長度是否在給定的范圍之內
@Length(min=, max=) Validates that the annotated string is between min and max included.

4.4、日期檢查

@Past 驗證 Date 和 Calendar 對象是否在當前時間之前，驗證成立的話被注釋的元素一定是一個過去的日期
@Future 驗證 Date 和 Calendar 對象是否在當前時間之后 ，驗證成立的話被注釋的元素一定是一個將來的日期
@Pattern 驗證 String 對象是否符合正則表達式的規則，被注釋的元素符合制定的正則表達式，regexp:正則表達式 flags: 指定 Pattern.Flag 的數組，表示正則表達式的相關選項。

4.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=) 被指定的元素必須在合適的范圍內
@Range(min=10000,max=50000,message=”range.bean.wage”)
@Valid 遞歸的對關聯對象進行校驗, 如果關聯對象是個集合或者數組,那么對其中的元素進行遞歸校驗,如果是一個map,則對其中的值部分進行校驗.(是否進行遞歸驗證)
@CreditCardNumber信用卡驗證
@Email 驗證是否是郵件地址，如果為null,不進行驗證，算通過驗證。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)

 

5、案例分析

//5.1、實體 Bean
public class ValidateTestClass{
 
    @NotNull(message = "reason信息不可以為空")
    private String reason;//訂單取消原因
 
    //get、set方法、有參構造方法、無參構造方法、toString方法省略
  ......
}

 

//5.2、control
public class ValidateTestClassValidateTest{
 
   @RequestBody
   @RequestMapping(value = "/test")
   public void addBook(@Valid ValidateTestClass validateTestClass，BindingResult result) {
 
       //備注：這里一個@Valid的參數后必須緊挨着一個BindingResult 參數，否則spring會在校驗不通過時直接拋出異常
       if (result.hasErrors()){
            List<ObjectError> errorList = result.getAllErrors();
            for(ObjectError error : errorList){
                System.out.println(error.getDefaultMessage());
            }
        }
 
    }
}

 

轉發地址：https://blog.csdn.net/qq_28867949/article/details/78922520

 

下一篇自定義校驗：https://www.cnblogs.com/niceyoo/p/9497235.html