@Validated/@Valid註解使用和BindingResult

@Valid和Validated的比較

• @Valid是使用hibernate validation的時候使用
• @Validated 是隻用spring Validator 校驗機制使用
• Validated是spring的註解，而@Valid是javax的註解；
• Validated：用在方法入參上無法單獨提供嵌套驗證功能。不能用在成員屬性（字段）上，也無法提示框架進行嵌套驗證。能配合嵌套驗證註解@Valid進行嵌套驗證。
• Valid：用在方法入參上無法單獨提供嵌套驗證功能。能夠用在成員屬性（字段）上，提示驗證框架進行嵌套驗證。能配合嵌套驗證註解@Valid進行嵌套驗證。
• @Validated和BindingResult bindingResult是配對出現，並且形參順序是固定的（一前一後）。

項目中的使用

• 首先在實體類中加入相應的註解（下面介紹）

public class user{ 
    @NotNull 
    @Length(min = 1,max = 6)  //名字的長度在1~6之間
    private String name; 
       
   @Size(min=1,max=6) // 密碼在1~6位之間
    private int pasWord 
} 

• 其次在controller層中做相應的配置，如下面的代碼：

 @PostMapping("parameterInfo/saveParameter")
    @ApiOperation("保存業務域")
    public ServiceApiResult<String> saveParameter(@Valid @RequestBody DtoParameter dtoParameter,
                                                  BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            String error = bindingResult.getFieldError().getDefaultMessage();
            return ServiceApiResult.error(error);
        }
        return parameterInfoService.saveParameters(dtoParameter);
    }

解釋：

   if (bindingResult.hasErrors()) {
        String error = bindingResult.getFieldError().getDefaultMessage();
        return ServiceApiResult.error(error);
    }        

• 這一塊代碼是必須加上的，因爲這個會接受到你在實體類加上的註解裏的錯誤信息
• @Valid 註解得加上，然後後面得跟上 BindingResult
• 另外這個 ServiceApiResult 是統一返回結果

JSR303定義的校驗類型（這是加在實體類上的註解）

空檢查

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

@NotEmpty、@NotBlank、@NotNull三種註解的區別

Booelan檢查

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

長度檢查

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

日期檢查

@Past           驗證 Date 和 Calendar 對象是否在當前時間之前 
 
@Future     驗證 Date 和 Calendar 對象是否在當前時間之後 
 
@Pattern    驗證 String 對象是否符合正則表達式的規則

數值檢查，建議使用在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=) Checks whether the annotated value lies between (inclusive) the specified minimum and maximum.

@Range(min=10000,max=50000,message="range.bean.wage")
private BigDecimal wage;
 
@Valid 遞歸的對關聯對象進行校驗, 如果關聯對象是個集合或者數組,那麼對其中的元素進行遞歸校驗,如果是一個map,則對其中的值部分進行校驗.(是否進行遞歸驗證)
 
@CreditCardNumber信用卡驗證
 
@Email  驗證是否是郵件地址，如果爲null,不進行驗證，算通過驗證。
 
@ScriptAssert(lang= ,script=, alias=)
 
@URL(protocol=,host=, port=,regexp=, flags=)