深入了解数据校验：Java Bean Validation 2.0（JSR380）

每篇一句

> 吾皇一日不退役，尔等都是臣子

相关阅读

【小家Java】深入了解数据校验（Bean Validation）：基础类打点（ValidationProvider、ConstraintDescriptor、ConstraintValidator）

<center>对Spring感兴趣可扫码加入wx群：`Java高工、架构师3群`（文末有二维码）</center>

前言

前几篇文章在讲Spring的数据绑定的时候，多次提到过数据校验。可能有人认为数据校验模块并不是那么的重要，因为硬编码都可以做。若是这么想的话，那就大错特错了~ 前面讲解

DataBinder

org.springframework.validation

DataBinder

我以数据绑定

DataBinder

JSR标准

为什么要有数据校验？

数据校验 是非常常见的工作，在日常的开发中贯穿于代码的各个层次，从上层的View层到底层的数据层。 > 在此处有必要再强调一句：前面说了数据绑定并不属于Spring MVC的专利，同样的数据校验也不是只会发生在web层，它可以在任意一层，从后面的示例中你会有更深的理解

在任何时候，当你要处理一个应用程序的业务逻辑，数据校验是你

必须

我们知道通常情况下程序肯定是分层的，不同的层一般由不同的人来开发。若你是一个有经验的程序员， 我相信你肯定见过在不同的层了都出现了相同的校验代码，这就是某种意义上的垃圾代码。

public String queryValueByKey(String parmTemplateCode, String conditionName, String conditionKey, String resultName) {
checkNotNull(parmTemplateCode, "parmTemplateCode not null");
checkNotNull(conditionName, "conditionName not null");
checkNotNull(conditionKey, "conditionKey not null");
checkNotNull(resultName, "resultName not null");
...
}

从这个简单的方法入参校验至少能发现如下问题：

1. 需要写大量的代码来进行参数验证。(这种代码多了就算垃圾代码)
2. 需要通过注释来知道每个入参的约束是什么（否则别人咋看得懂）
3. 每个程序员做参数验证的方式不一样，参数验证不通过抛出的异常也不一样（后期几乎没法维护）

如上会导致代码冗余和一些管理的问题（代码量越大，管理起来维护起来就越困难），比如说语义的一致性等。为了避免这样的情况发生，最好是将验证逻辑与相应的域模型（领域模型的概念）进行绑定，这就是本文提供的一个新思路（其实是JavaEE提供的思路）

为了解决这个问题，

Bean Validation

JavaBean

Java Annotations

Bean Validation

JavaBean

Java Bean Validation

JSR是

Java Specification Requests

JSR380

Bean Validation 2.0

Bean Validation

Bean Validation API

Hibernate Validator

Bean Validation

JSR 303

JSR 349

JSR 380

Bean Validation 1.1

Bean Validation 2.0

简单Demo示例

要想使用它，首先就得导包嘛~根据经验，和JCache类似Java只提供了规范，并没有提供实现，所以我们可以先找到它的API包然后导入：

<dependency>
<group
2b86b
id>javax.validation</groupid>
<artifactid>validation-api</artifactid>
<!-- <version>1.1.0.Final</version> -->
<version>2.0.1.Final</version>
</dependency>

关于版本之间的差异其实不是本文说明的重点，毕竟2.0做到了很好的向下兼容，使用起来是无缝的。 但是本处还是给个1.1版本和2.0.1的截图，感官上简单对比一下区别：

兼容性表格

关于Bean Validation 2.0的关注点（新特性）

因为2.0推出的时间确实不算长，so此处我把一些重要的关注点列举如下：

1. 对Java的最低版本要求是Java 8
2. 支持容器的校验，通过TYPE_USE类型的注解实现对容器内容的约束：

   List<@Email String>

3. 支持日期/时间的校验，

   @Past

   和

   @Future

4. 拓展元数据（新增注解）：

   @Email，@NotEmpty，@NotBlank，@Positive， @PositiveOrZero，@Negative，@NegativeOrZero，@PastOrPresent和@FutureOrPresent

   1. 像

   @Email、@NotEmpty、@NotBlank

   之前是Hibernate额外提供的，2.0标准后hibernate自动退位让贤并且标注为过期了

5. Bean Validation 2.0

   的唯一实现为

   Hibernate Validator

   。（其实还有

   Apache BVal

   ，但是你懂的，forget it）
6. 对于

   Hibernate Validator

   ，它自己也扩展了一些注解支持。 1. 6.0以上版本新增(对应标准2.0版本)：

   @UniqueElements、@ISBN、@CodePointLength、、、、、、、、

   2. 6.0以下版本可以使用的：

   @URL、@ScriptAssert、@SafeHtml、@Range、@ParameterScriptAssert、@Mod11Check、@Mod10Check、@LuhnCheck、@Length、@EAN、@Currency、@CreditCardNumber、@ConstraintComposition、@DurationMax、@DurationMin、**@REGON、@PESEL、@NIP、@TituloEleitoral、@CPF、@CNPJ**

   3.

   Hibernate Validator

   默认会校验完所有的属性，然后返回所有的验证

   失败信息

   。开启fail fast mode后，只要有一个验证失败，则返回验证失败信息。

so，对于

Java Bean Validation

Hibernate Validator

<dependency>
<groupid>org.hibernate.validator</groupid>
<artifactid>hibernate-validator</artifactid>
<version>6.0.17.Final</version>
</dependency>

==小细节：== 可以看到，导入了

hibernate-validator

Java Bean Validation

定义一个待校验的普通JavaBean：

@Getter
@Setter
@ToString
public class Person {

// 错误消息message是可以自定义的
@NotNull(message = "名字不能为null")
public String name;
@Positive
public Integer age;

@NotNull
@NotEmpty
private List<@Email String> emails;
@Future
private Date start;

}

书写测试用例：

public static void main(String[] args) {
Person person = new Person();
//person.setName("fsx");
person.setAge(-1);
// email校验：虽然是List都可以校验哦
person.setEmails(Arrays.asList("fsx@gmail.com", "baidu@baidu.com", "aaa.com"));
//person.setStart(new Date()); //start 需要是一个将来的时间: Sun Jul 21 10:45:03 CST 2019
//person.setStart(new Date(System.currentTimeMillis() + 10000)); //校验通过

// 对person进行校验然后拿到结果（显然使用时默认的校验器）   会保留下校验失败的消息
Set<constraintviolation<person>&gt; result = Validation.buildDefaultValidatorFactory().getValidator().validate(person);
// 对结果进行遍历输出
result.stream().map(v -&gt; v.getPropertyPath() + " " + v.getMessage() + ": " + v.getInvalidValue())
.forEach(System.out::println);
}

运行，报错啦：

Caused by: java.lang.ClassNotFoundException: javax.el.ELManager
at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
...

可以看到运行必须依赖于

javax.el

那行，导入依赖

javax.el

<!-- 注意这里导入的是Apr, 2013发布的el3.x的版本，但是glassfish并没有对此版本进行支持了  当然tomcat肯定是支持的 -->
<dependency>
<groupid>javax.el</groupid>
<artifactid>javax.el-api</artifactid>
<version>3.0.1-b06</version>
</dependency>
<!-- servlet容器大都对el有实现（支持jsp的都对此有实现），比如tomcat/glassfish等 -->
<dependency>
<groupid>org.glassfish.web</groupid>
<artifactid>javax.el</artifactid>
<version>2.2.6</version>
</dependency>

> 需要注意的是，网上大都建议导入

org.glassfish.web

关于EL的实现此处啰嗦一句：JavaEE并没有提供el的实现，需要容器自行提供，比如上面你想要导入最为流行的

tomcat

<!-- 嵌入式的tomcat -->
<dependency>
<groupid>org.apache.tomcat.embed</groupid>
<artifactid>tomcat-embed-el</artifactid>
<version>9.0.22</version>
</dependency>
<!-- 传统的tomcat（需要注意的是：传统的tomcat这种jar是不需要你手动导入的，tomcat自带的） -->
<dependency>
<groupid>org.apache.tomcat</groupid>
<artifactid>tomcat-jasper-el</artifactid>
<version>9.0.22</version>
<scope>provided</scope>
</dependency>

此处还需要说明一点的是：嵌入式tomcat（比如SpringBoot环境）若要使用时需要显示导入的。但是传统tomcat中你若要使用是不用自己导入的（tomcat自带此jar）。 > 但是，但是，但是自从tomcat8.5后不再自带jsper-el的包了，需要手动导入。（tomcat7还是有的~）

==最佳实践：== 一般来说，

javax.el-api

validation-api

<dependency>
<groupid>org.hibernate.validator</groupid>
<artifactid>hibernate-validator</artifactid>
<version>6.0.17.Final</version>
</dependency><dependency>
<groupid>org.apache.tomcat.embed</groupid>
<artifactid>tomcat-embed-el</artifactid>
<version>9.0.22</version>
</dependency>

答：那是因为绝大多数情况下你使用@Valid是使用在Spring MVC上，它是不依赖于EL方式的，下篇文章会详细说明关于数据校验在Spring上的使用。而本文主要还是讲解API的方式~

经过一番导包后，再次运行打印如下（方式一、方式二结果一致）：

name名字不能为null: null //  此处错误消息是自己的自定义内容
age必须是正数: -1
emails[2].<list element>不是一个合法的电子邮件地址: aaa.com

这样通过API调用的方式就完成了对这个

JavaBean

核心API分析

Validation

官方给它的定义为：

This class is the entry point for Bean Validation.

1. 最简单方式：使用默认的

   ValidatorFactory factory = Validation.buildDefaultValidatorFactory();

   虽然是默认的单也会有如下2种情况： 1. 若使用了xml配置了一个provider，那就会使用这个provider来提供Factory 2. 若没有xml或者xml力没有配置provider，那就是用默认的

   ValidationProviderResolver

   实现类来处理
2. 方式二：选择自定义的

   ValidationProviderResolver

   来跟XML配置逻辑选出一个

   ValidationProvider

   来。大致代码如下：

Configuration configuration = Validation.byDefaultProvider()
.providerResolver(new MyResolverStrategy()) // 自定义一个ValidationProviderResolver的实现类
.configure();
ValidatorFactory factory = configuration.buildValidatorFactory();

1. 第三种方式就更加自由了：你可以直接提供一个类型安全的

   ValidationProvider

   实现。比如

   HibernateValidator

   就是一个

   ValidationProvider

   的实现：

HibernateValidatorConfiguration configuration = Validation.byProvider(HibernateValidator.class)
// .providerResolver( ... ) // 因为制定了Provider，这个参数就可选了
.configure()
.failFast(false);
ValidatorFactory validatorFactory = configuration.buildValidatorFactory();

这三种初始化方式，在源码处就是对应提供的三个

public static

public class Validation {

// 方式一
public static ValidatorFactory buildDefaultValidatorFactory() {
return byDefaultProvider().configure().buildValidatorFactory();
}
// 方式二
public static GenericBootstrap byDefaultProvider() {
return new GenericBootstrapImpl();
}
// 方式三
public static <t extends configuration<t>, U extends ValidationProvider<t>&gt; ProviderSpecificBootstrap<t> byProvider(Class<u> providerType) {
return new ProviderSpecificBootstrapImpl&lt;&gt;( providerType );
}
...
}

对于若你想使用xml文件独立配置校验规则，可以使用

Configuration.addMapping(new FileInputStream(validationFile));

ValidatorFactory

因为现在都会使用

Hibernate-Validation

HibernateValidatorConfiguration

此接口表示配置，继承自标注接口

javax.validation.Configuration

HibernateValidator

javax.validation.Configuration

ValidatorFactory

META-INF/validation.xml

validation.xml

ValidationProviderResolver

DefaultValidationProviderResolver

public interface Configuration<t extends configuration<t>&gt; {
// 该方法调用后就不会再去找META-INF/validation.xml了
T ignoreXmlConfiguration();
// 消息内插器  它是个狠角色，关于它的使用场景，后续会有详解（包括Spring都实现了它来做事）
// 它的作用是：插入给定的约束冲突消息
T messageInterpolator(MessageInterpolator interpolator);
// 确定bean验证提供程序是否可以访问属性的协定。对每个正在验证或级联的属性调用此约定。（Spring木有实现它）
// 对每个正在验证或级联的属性都会调用此约定
// Traversable： 可移动的
T traversableResolver(TraversableResolver resolver);
// 创建ConstraintValidator的工厂
// ConstraintValidator：定义逻辑以验证给定对象类型T的给定约束A。(A是个注解类型)
T constraintValidatorFactory(ConstraintValidatorFactory constraintValidatorFactory);
// ParameterNameProvider：提供Constructor/Method的方法名们
T parameterNameProvider(ParameterNameProvider parameterNameProvider);
// java.time.Clock 用作判定@Future和@Past（默认取值当前时间）
// 若你希望他是个逻辑实现，提供一个它即可
// @since 2.0
T clockProvider(ClockProvider clockProvider);
// 值提取器。这是add哦~ 负责从Optional、List等这种容器里提取值~
// @since 2.0
T addValueExtractor(ValueExtractor<!--?--> extractor);
// 加载xml文件
T addMapping(InputStream stream);
// 添加特定的属性给Provider用的。此属性等效于XML配置属性。
// 此方法通常是框架自己分析xml文件得到属性值然后放进去，调用者一般不使用（当然也可以用）
T addProperty(String name, String value);

// 下面都是get方法喽
MessageInterpolator getDefaultMessageInterpolator();
TraversableResolver getDefaultTraversableResolver();
ConstraintValidatorFactory getDefaultConstraintValidatorFactory();
ParameterNameProvider getDefaultParameterNameProvider();
ClockProvider getDefaultClockProvider();
BootstrapConfiguration getBootstrapConfiguration(); // 整个配置也可返回出去

// 上面都是工作，这个方法才是最终需要调用的：得到一个ValidatorFactory
ValidatorFactory buildValidatorFactory();
}

该接口提供了一些标准的配置项。在实际应用中都是使用

Hibernate Validation

public interface HibernateValidatorConfiguration extends Configuration<hibernatevalidatorconfiguration> {

// 这批属性，证明直接可以通过System属性值来控制，大大地方便~
// 这个机制快速失败机制：true检查完一个有错误就返回，false全部检查完把错误消息一起返回   默认false
String FAIL_FAST = "hibernate.validator.fail_fast";
String ALLOW_PARAMETER_CONSTRAINT_OVERRIDE = "hibernate.validator.allow_parameter_constraint_override";
String ALLOW_MULTIPLE_CASCADED_VALIDATION_ON_RESULT = "hibernate.validator.allow_multiple_cascaded_validation_on_result";
String ALLOW_PARALLEL_METHODS_DEFINE_PARAMETER_CONSTRAINTS = "hibernate.validator.allow_parallel_method_parameter_constraint";
// @since 5.2
@Deprecated
String CONSTRAINT_MAPPING_CONTRIBUTOR = "hibernate.validator.constraint_mapping_contributor";
// @since 5.3
String CONSTRAINT_MAPPING_CONTRIBUTORS = "hibernate.validator.constraint_mapping_contributors";
// @since 6.0.3
String ENABLE_TRAVERSABLE_RESOLVER_RESULT_CACHE = "hibernate.validator.enable_traversable_resolver_result_cache";
// @since 6.0.3  ScriptEvaluatorFactory：执行脚本
@Incubating
String SCRIPT_EVALUATOR_FACTORY_CLASSNAME = "hibernate.validator.script_evaluator_factory";
// @since 6.0.5 comparing date/time in temporal constraints. In milliseconds.
@Incubating
String TEMPORAL_VALIDATION_TOLERANCE = "hibernate.validator.temporal_validation_tolerance";

// ResourceBundleMessageInterpolator用于 load resource bundles
ResourceBundleLocator getDefaultResourceBundleLocator();
// 创建一个ConstraintMapping：通过编程API配置的约束映射
// 设置映射后，必须通过addMapping（constraintmapping）将其添加到此配置中。
ConstraintMapping createConstraintMapping();
// 拿到所有的值提取器  @since 6.0
@Incubating
Set<valueextractor<?>&gt; getDefaultValueExtractors();

// 往下就开始配置了~~~~~~~~~~
HibernateValidatorConfiguration addMapping(ConstraintMapping mapping);
HibernateValidatorConfiguration failFast(boolean failFast);
// used for loading user-provided resources:
HibernateValidatorConfiguration externalClassLoader(ClassLoader externalClassLoader);
// true：表示允许覆盖约束的方法。false表示不予许（抛出异常）  默认值是false
HibernateValidatorConfiguration allowOverridingMethodAlterParameterConstraint(boolean allow);
// 定义是否允许对返回值标记多个约束以进行级联验证。  默认是false
HibernateValidatorConfiguration allowMultipleCascadedValidationOnReturnValues(boolean allow);
// 定义约束的**并行方法**是否应引发ConstraintDefinitionException
HibernateValidatorConfiguration allowParallelMethodsDefineParameterConstraints(boolean allow);
// 是否允许缓存TraversableResolver  默认值是true
HibernateValidatorConfiguration enableTraversableResolverResultCache(boolean enabled);
// 设置一个脚本执行器
@Incubating
HibernateValidatorConfiguration scriptEvaluatorFactory(ScriptEvaluatorFactory scriptEvaluatorFactory);
// 允许在时间约束中比较日期/时间时设置可接受的误差范围
// 比如@Past @PastOrPresent @Future @FutureOrPresent
@Incubating
HibernateValidatorConfiguration temporalValidationTolerance(Duration temporalValidationTolerance);
// 允许设置将传递给约束验证器的有效负载。如果多次调用该方法，则只传播最后传递的有效负载。
@Incubating
HibernateValidatorConfiguration constraintValidatorPayload(Object constraintValidatorPayload);
}

关于此接口的唯一实现类：

ConfigurationImpl

Validation

准备好了

Configuration

configuration.buildValidatorFactory()

ValidatorFactory

ValidatorFactory

总结

该文讲解是关于

Bean Validation

Spring

知识交流

>

若文章格式混乱，可点击

==The last：如果觉得本文对你有帮助，不妨点个赞呗。当然分享到你的朋友圈让更多小伙伴看到也是被

作者本人许可的~

若对技术内容感兴趣可以加入wx群交流：

Java高工、架构师3群

fsx641385712

"java入群"

转载于:https://my.oschina.net/fangshixiang/blog/3078025

• 点赞
• 收藏
• 分享
• 文章举报