Hibernate Validator

版本：6.0.17.Final - 13-06-2019

这是什么？

这是 JSR-380 - Bean Validation 2.0 的参考实现。 Bean Validation 为 JavaBean 以及方法验证定义了元数据模型和 API。默认的元数据来源是注解，并能够通过使用 XML 验证描述符来覆盖和扩展元数据。

文档

本次发布的文档包含在发行包的 docs 目录中，也可以在线访问。

版本说明

本次发布的完整变更列表可在 changelog.txt 中找到。

系统要求

JDK 1.8 或更高版本。

使用 Hibernate Validator

如果您使用下载站点提供的发行归档文件，请将 dist/hibernate-validator-<version>.jar 连同 dist/lib/required 中的所有 jar 文件一起复制到应用程序的类路径中。出于日志记录的目的，Hibernate Validator 使用 JBoss Logging API，这是一个抽象层，支持多种日志解决方案（例如 log4j 或 JDK 提供的日志框架）作为实现。只需将受支持的日志库添加到类路径中（例如 log4j-<version>.jar），JBoss Logging 就会将所有日志请求委托给该提供者。

将以下内容添加到您的 Maven 或 Ivy 依赖列表

  <dependency>
      <groupId>org.hibernate.validator</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>6.0.17.Final</version>
  </dependency>

您还需要 Unified Expression Language 的 API 和实现。这些依赖必须在 SE 环境中显式添加。在 EE 环境中，它们通常已经提供。

  <dependency>
     <groupId>org.glassfish</groupId>
     <artifactId>javax.el</artifactId>
     <version>3.0.1-b09</version>
  </dependency>

Bean Validation 定义了与 CDI 的集成点。如果您的应用程序运行在无法开箱即用地提供此集成的环境中，您可以通过添加以下依赖来使用 Hibernate Validator CDI 可移植扩展：
```
  <dependency>
     <groupId>org.hibernate.validator</groupId>
     <artifactId>hibernate-validator-cdi</artifactId>
     <version>6.0.17.Final</version>
  </dependency>
```
hibernate-validator-annotation-processor-<version>.jar 是一个可选 jar，可以与您的构建环境或 IDE 集成，以验证约束注解的使用是否正确。更多信息请参阅在线文档。

许可证

Hibernate Validator 本身以及 Bean Validation API 和 TCK 均在 Apache 软件许可证 2.0 下提供和分发。更多信息请参阅 license.txt。

从源码构建

您可以通过克隆 git 仓库 git://github.com/hibernate/hibernate-validator.git 从源码构建 Hibernate Validator。您还需要 JDK 8 和 Maven 3（>= 3.3.1）。满足这些前提条件后，您可以通过以下方式编译源码：

mvn clean install

还有更多可用的构建选项。更多信息请参阅为 Hibernate Validator 做贡献。

在 JDK 9 上构建

要使用 JDK 9 构建 Hibernate Validator，请导出以下环境变量：

export MAVEN_OPTS="--add-opens=java.base/java.security=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-modules=java.xml.bind"

然后可以像这样启动构建：

mvn clean install

以下是我们添加各种构建选项的原因：

add-opens java.security：wildfly-maven-plugin:execute-commands 需要（用于 WildFly 集成测试和以容器模式运行的 TCK runner）
add-opens java.lang：JRuby 处理 Asciidoc 需要
add-modules java.xml.bind：forbiddenapis Maven 插件需要

持续集成

项目的官方持续集成服务托管在 ci.hibernate.org。

我们提供了一个 .travis.yml 文件，您可以通过在您的 Travis CI 账户中启用构建，为您的 GitHub fork 启用 CI。

hibernate__hibernate-validator_CVE-2019-10219_6-0-17-Final

最受欢迎