Validation

在 Spring Boot参数验证（上）--Bean Validation及其Hibernate实现 一篇中，我们介绍了验证标准Bean Validation和其Hibernate实现，在本篇，我们看看它们是如何应用在Spring Boot Web项目中。 1. Spring Validator 其实，Spring很早就有了自己的Bean验证机制，其核心为Validator接口，表示校验器： public interface Validator { // 检测Validator是否支持校验提供的Class boolean supports(Class<?> clazz); // 校验逻辑，校验的结果信息通过errors获取 void validate(@Nullable Object target, Errors errors); } Errors接口，用以表示校验失败的错误信息： public interface Errors { // 获取被校验的根对象 String getObjectName(); // 校验结果是否有错 boolean hasErrors(); // 获取校验错误数量 int getErrorCount(); // 获取所有错误信息，包括全局错误和字段错误 List<ObjectError> getAllErrors(); // 获取所有字段错误 List<FieldError> getFieldErrors(); …… } 当Bean Validation被标准化过后，从Spring3.X开始，已经完全支持JSR 303(1.0)规范，通过Spring的LocalValidatorFactoryBean实现，它对Spring的Validator接口和javax.validation.Validator接口进行了适配。 1.1. 全局Validator 全局Validator通过上述的LocalValidatorFactoryBean类来提供，只要使用@EnableWebMvc即可（Xml配置开启<mvc:annotation-driven>），也可以进行自定义： @Configuration @EnableWebMvc public class WebConfig extends WebMvcConfigurerAdapter { @Override public Validator getValidator(); { // return "global" validator } } ...

通常，web项目都需要对请求的参数进行校验，一般是前端JavaScript需要校验，然后后台还需要再进行校验，而校验逻辑大多数是重复的。如果在后台通过硬编码的方式，对Controller参数进行逐个校验，将会非常耗时和低效的，尤其是在使用Spring Boot和Spring Cloud的微服务体系中，大多数服务均会对外提供RESTFul的api，如果有统一的验证机制和框架，将大大提高生产力。幸运的是，Java已经提供了标准的验证API，称为Bean Validation。 1. 简介 1.1. Bean Validation Bean Validation，是JCP(Java Community Process)定义的标准化的JavaBean校验API，基于注解，并且具有良好的易用性和扩展性，1.0版本定义为 /attachment/20181009/28f52319fd84452ba22b490ff911fd04.pdf[JSR 303]，而现在发布了2.0版本，定义为 JSR 380，了解详细信息可以看 这里。 Bean Validation并不局限于应用程序的某一层或者哪种编程模型, 它可以被用在任何一层, 也可以是像Swing这样的富客户端程序中. 目标：简化Bean校验，将以往重复的校验逻辑进行抽象和标准化，形成统一API规范； 版本变化：JSR 303在2009发布了1.0Final版，而最新的是在2017年发布的Bean Validation 2.0，被定义为 JSR 380。 需要注意的是，Bean Validation只是一个规范和标准，并没有提供实现，而接下来介绍的hibernate validator就是它的一种实现。 1.2. Hibernate Validator 是JSR 380的一种标准实现，同时还对其进行了扩展，如增加了部分验证约束。目前，最新的稳定版本为 6.0.13.Final。 2. 入门示例 接下来，我们使用Spring Boot来编写一个简单的示例工程。如果对Spring Boot不熟悉的可以看这几篇文章： "Spring Boot之基础入门" "SpringBoot-工程结构、配置文件以及打包" "Spring Boot JPA使用详解" 1、添加maven依赖 前边说过，JSR 303定义了JavaBean的验证标准，而Hibernate Validator是它的一种实现，所以，这两个的jar包我们都需要添加到工程。 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> 其实，spring-boot-starter-web启动器已经依赖了hibernate-validator，而后者很明显会依赖validation-api。 ...