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