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

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

引入依賴
我們使用maven構(gòu)建springboot應(yīng)用來進(jìn)行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

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

無需添加其他注解，一個(gè)典型的啟動(dòng)類

@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 = "手機(jī)號(hào)碼格式錯(cuò)誤")
    @NotBlank(message = "手機(jī)號(hào)碼不能為空")
    private String phone;

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

    //... getter setter

}

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

@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對(duì)其進(jìn)行校驗(yàn)，而校驗(yàn)的信息會(huì)存放到其后的BindingResult中。注意，必須相鄰，如果有多個(gè)參數(shù)需要校驗(yàn)，形式可以如下。foo(@Validated Foo foo, BindingResult fooBindingResult ，@Validated Bar bar, BindingResult barBindingResult);即一個(gè)校驗(yàn)類對(duì)應(yīng)一個(gè)校驗(yàn)結(jié)果。

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

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

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


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

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

改寫注解，添加分組：

Class Foo{

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

    public interface Adult{}

    public interface Minor{}
}

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

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方法限定需要進(jìn)行Adult校驗(yàn)，而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)方法的返回值和入?yún)?/p>

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

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

@NotNull ? ? ? ? ? 任何對(duì)象的value不能為null

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

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