摘要：本文主要介紹在中自動校驗的機制。引入依賴我們使用構(gòu)建應(yīng)用來進行演示。在中校驗數(shù)據(jù)值得注意的地方參數(shù)前需要加上注解，表明需要對其進行校驗，而校驗的信息會存放到其后的中。層改寫方法限定需要進行校驗，而方法則不做限制。

JSR303/JSR-349，hibernate validation，spring validation之間的關(guān)系。JSR303是一項標準,JSR-349是其的升級版本，添加了一些新特性，他們規(guī)定一些校驗規(guī)范即校驗注解，如@Null，@NotNull，@Pattern，他們位于javax.validation.constraints包下，只提供規(guī)范不提供實現(xiàn)。而hibernate validation是對這個規(guī)范的實踐（不要將hibernate和數(shù)據(jù)庫orm框架聯(lián)系在一起），他提供了相應(yīng)的實現(xiàn)，并增加了一些其他校驗注解，如@Email，@Length，@Range等等，他們位于org.hibernate.validator.constraints包下。而萬能的spring為了給開發(fā)者提供便捷，對hibernate validation進行了二次封裝，顯示校驗validated bean時，你可以使用spring validation或者hibernate validation，而spring validation另一個特性，便是其在springmvc模塊中添加了自動校驗，并將校驗信息封裝進了特定的類中。這無疑便捷了我們的web開發(fā)。本文主要介紹在springmvc中自動校驗的機制。

引入依賴
我們使用maven構(gòu)建springboot應(yīng)用來進行demo演示。

    
        org.springframework.boot
        spring-boot-starter-web
    

我們只需要引入spring-boot-starter-web依賴即可，如果查看其子依賴，可以發(fā)現(xiàn)如下的依賴：

    org.hibernate
    hibernate-validator


    com.fasterxml.jackson.core
    jackson-databind

驗證了我之前的描述，web模塊使用了hibernate-validation，并且databind模塊也提供了相應(yīng)的數(shù)據(jù)綁定功能。

無需添加其他注解，一個典型的啟動類

@SpringBootApplication
public class ValidateApp {

    public static void main(String[] args) {
        SpringApplication.run(ValidateApp.class, args);
    }
}

public class Foo {

    @NotBlank
    private String name;

    @Min(18)
    private Integer age;

    @Pattern(regexp = "^1(3|4|5|7|8)d{9}$",message = "手機號碼格式錯誤")
    @NotBlank(message = "手機號碼不能為空")
    private String phone;

    @Email(message = "郵箱格式錯誤")
    private String email;

    //... getter setter

}

使用一些比較常用的校驗注解，還是比較淺顯易懂的，字段上的注解名稱即可推斷出校驗內(nèi)容，每一個注解都包含了message字段，用于校驗失敗時作為提示信息，特殊的校驗注解，如Pattern（正則校驗），還可以自己添加正則表達式。

@Controller
public class FooController {

    @RequestMapping("/foo")
    public String foo(@Validated Foo foo <1>, BindingResult bindingResult <2>) {
        if(bindingResult.hasErrors()){
            for (FieldError fieldError : bindingResult.getFieldErrors()) {
                //...
            }
            return "fail";
        }
        return "success";
    }

}

值得注意的地方：

<1> 參數(shù)Foo前需要加上@Validated注解，表明需要spring對其進行校驗，而校驗的信息會存放到其后的BindingResult中。注意，必須相鄰，如果有多個參數(shù)需要校驗，形式可以如下。foo(@Validated Foo foo, BindingResult fooBindingResult ，@Validated Bar bar, BindingResult barBindingResult);即一個校驗類對應(yīng)一個校驗結(jié)果。

<2> 校驗結(jié)果會被自動填充，在controller中可以根據(jù)業(yè)務(wù)邏輯來決定具體的操作，如跳轉(zhuǎn)到錯誤頁面。

一個最基本的校驗就完成了，總結(jié)下框架已經(jīng)提供了哪些校驗：

JSR提供的校驗注解：         
@Null   被注釋的元素必須為 null    
@NotNull    被注釋的元素必須不為 null    
@AssertTrue     被注釋的元素必須為 true    
@AssertFalse    被注釋的元素必須為 false    
@Min(value)     被注釋的元素必須是一個數(shù)字，其值必須大于等于指定的最小值    
@Max(value)     被注釋的元素必須是一個數(shù)字，其值必須小于等于指定的最大值    
@DecimalMin(value)  被注釋的元素必須是一個數(shù)字，其值必須大于等于指定的最小值    
@DecimalMax(value)  被注釋的元素必須是一個數(shù)字，其值必須小于等于指定的最大值    
@Size(max=, min=)   被注釋的元素的大小必須在指定的范圍內(nèi)    
@Digits (integer, fraction)     被注釋的元素必須是一個數(shù)字，其值必須在可接受的范圍內(nèi)    
@Past   被注釋的元素必須是一個過去的日期    
@Future     被注釋的元素必須是一個將來的日期    
@Pattern(regex=,flag=)  被注釋的元素必須符合指定的正則表達式    


Hibernate Validator提供的校驗注解：  
@NotBlank(message =)   驗證字符串非null，且長度必須大于0    
@Email  被注釋的元素必須是電子郵箱地址    
@Length(min=,max=)  被注釋的字符串的大小必須在指定的范圍內(nèi)    
@NotEmpty   被注釋的字符串的必須非空    
@Range(min=,max=,message=)  被注釋的元素必須在合適的范圍內(nèi)

如果同一個類，在不同的使用場景下有不同的校驗規(guī)則，那么可以使用分組校驗。未成年人是不能喝酒的，而在其他場景下我們不做特殊的限制，這個需求如何體現(xiàn)同一個實體，不同的校驗規(guī)則呢？

改寫注解，添加分組：

Class Foo{

    @Min(value = 18,groups = {Adult.class})
    private Integer age;

    public interface Adult{}

    public interface Minor{}
}

這樣表明，只有在Adult分組下，18歲的限制才會起作用。

Controller層改寫：

@RequestMapping("/drink")
public String drink(@Validated({Foo.Adult.class}) Foo foo, BindingResult bindingResult) {
    if(bindingResult.hasErrors()){
        for (FieldError fieldError : bindingResult.getFieldErrors()) {
            //...
        }
        return "fail";
    }
    return "success";
}

@RequestMapping("/live")
public String live(@Validated Foo foo, BindingResult bindingResult) {
    if(bindingResult.hasErrors()){
        for (FieldError fieldError : bindingResult.getFieldErrors()) {
            //...
        }
        return "fail";
    }
    return "success";
}

drink方法限定需要進行Adult校驗，而live方法則不做限制。

@RestController
@Validated <1>
public class BarController {

    @RequestMapping("/bar")
    public @NotBlank <2> String bar(@Min(18) Integer age <3>) {
        System.out.println("age : " + age);
        return "";
    }

    @ExceptionHandler(ConstraintViolationException.class)
    public Map handleConstraintViolationException(ConstraintViolationException cve){
        Set> cves = cve.getConstraintViolations();<4>
        for (ConstraintViolation constraintViolation : cves) {
            System.out.println(constraintViolation.getMessage());
        }
        Map map = new HashMap();
        map.put("errorCode",500);
        return map;
    }

}

<1> 為類添加@Validated注解

<2> <3> 校驗方法的返回值和入?yún)?/p>

<4> 添加一個異常處理器，可以獲得沒有通過校驗的屬性相關(guān)信息

tips: @NotNull ?@NotEmpty ?@NotBlank 3個注解的區(qū)別：

@NotNull ? ? ? ? ? 任何對象的value不能為null

@NotEmpty ? ? ? 集合對象的元素不為0，即集合不為空，也可以用于字符串不為null

@NotBlank ? ? ? ?只能用于字符串不為null，并且字符串trim()以后length要大于0