1. 程式人生 > >jsr-303 參數校驗-學習(轉)

jsr-303 參數校驗-學習(轉)

stirng 取消 案例分析 信息 included 什麽 bean alias 進行

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

jsr-303 參數校驗-學習(轉)