前言

在应用程序的业务逻辑中，经常会碰到需要校验参数的情况。
经常要判断一个 Model 的字段是否为 Null 之类，或者判断长度等。
那么在代码层面上，就会需要编写很多校验，影响代码的阅读以及维护，而且造成代码的冗余。

应用程序必须通过某种手段来确保输入进来的数据从语义上来讲是正确的。

在通常的情况下，应用程序是分层的，不同的层由不同的开发人员来完成。很多时候同样的数据验证逻辑会出现在不同的层，这样就会导致代码冗余和一些管理的问题，比如说语义的一致性等。为了避免这样的情况发生，最好是将验证逻辑与相应的域模型进行绑定。

为了更好的关注核心的业务逻辑，减少参数校验侵入方法内部，因此有了 JRS-303 提案。

JSR是Java Specification Requests的缩写，意思是Java 规范提案。是指向JCP(Java Community Process)提出新增一个标准化技术规范的正式请求。任何人都可以提交JSR，以向Java平台增添新的API和服务。JSR已成为Java界的一个重要标准。

Bean Validation 为 JavaBean 验证定义了相应的元数据模型和 API。缺省的元数据是 Java Annotations，通过使用 XML 可以对原有的元数据信息进行覆盖和扩展。在应用程序中，通过使用 Bean Validation 或是你自己定义的 constraint，例如 @NotNull, @Max, @ZipCode， 就可以确保数据模型（JavaBean）的正确性。constraint 可以附加到字段，getter 方法，类或者接口上面。对于一些特定的需求，用户可以很容易的开发定制化的 constraint。Bean Validation 是一个运行时的数据验证框架，在验证之后验证的错误信息会被马上返回。

Hibernate Validator 是 Bean Validation 的参考实现 . Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现，除此之外还有一些附加的 constraint。如果想了解更多有关 Hibernate Validator 的信息，请查看 http://www.hibernate.org/subprojects/validator.html

下载 JSR 303 – Bean Validation 规范 http://jcp.org/en/jsr/detail?id=303
目前最新的为 Bean Validation 2.0，是 JSR 380，实现为 Hibernate Validator - 6.0.1.Final

Bean Validation 2.0 中的 constraint

Hibernate Validator 附加的 constraint

Spring boot 中使用方式

参数校验

@Slf4j
@Validated // 使用 spring 的 Validated 注解标注此 Controller 是需要执行校验的，
@RestController
@RequestMapping("/demo-1")
public class Demo1Controller {

    /**
     * 在参数上做校验，基本类型
     * @param name 名称
     *
     * @return
     */
    @GetMapping("/query-1")
    public HttpStatus query1(@NotBlank(message = "不能为空") String name) {
        log.info("name is {}", name);
        return HttpStatus.OK;
    }

}

运行结果：

POJO 校验

@Slf4j
@RestController
@RequestMapping("/demo-2")
public class Demo2Controller {

    @PostMapping("/save-1")
    public HttpStatus save1(@Validated Person person) {
        return HttpStatus.OK;
    }

}

@Data
public class Person {

    @NotBlank(message = "名字不能为空")
    private String name;

    private Integer age;

    private String sex;
}

运行结果：

接口层级校验

@Slf4j
@RestController
@RequestMapping("/demo-3")
public class Demo3Controller {

    @Resource
    private DemoService service;

    @PostMapping("/save-1")
    public HttpStatus save1(@RequestBody Person person) {
        log.info("person is {}", person);
        service.save(person);

        return HttpStatus.OK;
    }

}

@Data
public class Person {

    @NotBlank(message = "名字不能为空")
    private String name;

    private Integer age;

    private String sex;
}

@Validated
public interface DemoService {

    void save(@Valid Person person);
}

运行结果：

分组校验

@Slf4j
@RestController
@RequestMapping("/demo-4")
public class Demo4Controller {

    @PostMapping("/save-1")
    public HttpStatus save1(@Validated(value = {SaveValidation.class, Default.class}) @RequestBody PersonGroup person) {
        log.info("person is {}", person);

        return HttpStatus.OK;
    }

    @PostMapping("/update-1")
    public HttpStatus update1(@Validated(value = {UpdateValidation.class, Default.class}) @RequestBody PersonGroup person) {
        log.info("person is {}", person);

        return HttpStatus.OK;
    }

}

@Data
public class PersonGroup {

    @NotBlank(groups = {SaveValidation.class}, message = "保存时名字不能为空")
    private String saveName;

    @NotBlank(groups = {UpdateValidation.class}, message = "更新时名字不能为空")
    private String updateName;

    private Integer age;

    private String sex;
}

运行结果：

@Validated 隐含默认校验，即默认分组，如果不分场景下校验，可以使用如下方式配置：
分组时：
@Validated(value = {ContainerSaveValidation.class, Default.class})
属性上：
@NotBlank(groups = {SaveValidation.class}, message = "保存时名字不能为空") private String saveName;

参考文章：
https://www.ibm.com/developerworks/cn/java/j-lo-jsr303/index.html
Hibernate Validator 官方文档