Hibernate Validator 使用与技术文档

1. 安装指南

系统要求

• JDK 17 或更高版本

安装步骤

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

• 在您的 Maven/Ivy/Gradle 依赖关系列表中添加以下构件：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>9.0.0.Beta2</version>
</dependency>

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

<dependency>
   <groupId>org.glassfish.expressly</groupId>
   <artifactId>expressly</artifactId>
   <version>6.0.0-M1</version>
</dependency>

• 如果您的应用程序运行在没有提供CDI集成的环境中，您可以使用Hibernate Validator CDI便携式扩展，通过添加以下依赖项来实现：

<dependency>
   <groupId>org.hibernate.validator</groupId>
   <artifactId>hibernate-validator-cdi</artifactId>
   <version>9.0.0.Beta2</version>
</dependency>

• hibernate-validator-annotation-processor-.jar 是一个可选的 jar，可以与您的构建环境或 IDE 集成，以验证约束注释是否正确使用。请参考在线文档了解更多信息。

2. 项目的使用说明

请参考官方文档以获取使用Hibernate Validator的详细信息。

3. 项目API使用文档

Hibernate Validator 的API文档包含在发行包的 docs 目录中，或者可以通过在线方式访问。

4. 项目安装方式

从源代码构建

您可以通过克隆 git 仓库 git://github.com/hibernate/hibernate-validator.git 从源代码构建 Hibernate Validator。您还需要JDK 17+和Maven 3 (>= 3.9.8)。具备这些先决条件后，您可以通过以下方式编译源代码：

mvn clean install

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

持续集成

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

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

---

本文档旨在帮助用户安装、使用和理解Hibernate Validator项目。有关更多详细信息，请参考官方文档和资源。