Hibernate目录结构和基础JAR包介绍

朱雀 2021-01-13 16:53 1617阅读 0赞

目前企业主流使用的 Hibernate 版本以 Hibernate 3.x 版本为主，这里以 Hibernate 3.6.10 版本为例。初学者可以从官方网址 http://sourceforge.net/projects/hibernate/files/hibernate3/ 中下载对应的版本。Hibernate 3.6.10 版本的下载过程，如图 1 所示。

![Hibernate的下载](/images/1610556774851.png "Hibernate的下载")
图 1  Hibernate的下载

![Hibernate的下载](/images/1610556753676.png "Hibernate的下载")
图 2  Hibernate的下载

在图 1 中，单击 3.6.10.Final 链接，进入下载页面。

在图 2 中有两个压缩包链接，其中 hibernate-distribution-3.6.10.Final-dist.zip 是 Windows 下的版本，Final 表示版本号为正式版。hibernate-distribution-3.6.10.Final-dist.tar.gz 是 Linux 下的版本，读者可以根据自己的环境需求下载指定版本的 Hibernate，本教程下载的是 Windows 版本的 ZIP 压缩包。

下载完成后，对 Hibernate 3.6.10 进行解压，解压后的目录结构，如图 3 所示。

![Hibernate压缩包的文件结构](/images/1610556723934.png "Hibernate压缩包的文件结构")
图 3  Hibernate压缩包的文件结构

从图 3 中可以看出，Hibernate 3.6.10 安装目录中包含一系列的子目录，这些子目录分别用于存放不同功能的文件，下面针对这些子目录进行简单介绍，如表 1 所示。

| 名    称             | 说    明                                                     |
| -------------------- | ------------------------------------------------------------ |
| documentation 文件夹 | 该路径下存放了 Hibernate 的相关文档，包括 Hibernate 的参考文档和 API 文档等。 |
| lib 文件夹           | 该路径下存放了 Hibernate 3 的核心类库，以及编译和运行所依赖的第三方类库。其中 lib 路径下的 required 子目录中包含了运行 Hibernate 3 所必须的 JAR 包。 |
| project 文件夹       | 该路径下存放了 Hibernate 各种相关项目的源代码。              |
| hibernate3.jar 文件  | 此 JAR 包是 Hibernate 3 的核心 JAR。                         |

在实际开发中，需要将 Hibernate 3 的核心 JAR 以及 lib/required 子目录中的 JAR 包添加到项目中，除此之外，通常还需要添加 Hibernate 3 对 JPA 支持的 JAR，以及实现日志功能的 JAR。使用 Hibernate 3 开发项目时，所需的 JAR 包及其说明如表 2 所示。

| JAR包名称                             | 描   述                                                      |
| ------------------------------------- | ------------------------------------------------------------ |
| hibernate3.jar                        | Hibernate 的核心包                                           |
| antlr-2.7.6.jar                       | 语言转换工具，Hibernate 利用它实现 HQL 到 SQL 的转换         |
| commons-collections-3.1.jar           | collections Apache 的工具集，用于增强 Java 对集合的处理能力 |
| dom4j-l.6.1.jar                       | dom4j XML解析器                                              |
| javassist-3.12.0.GA.jar               | 代码生成工具，Hibernate 利用它在运行时扩展 Java 类           |
| jta-1.1.jar                           | 标准的 JAVA 事务（跨数据库）处理接口                         |
| slf4j-api-l.6.1.jar                   | 只是一个接口，用于整合 log4j                                 |
| hibernate-jpa-2.0-api-1.0.1.Final.jar | JPA 接口开发包                                               |
| log4j-l.2.17.jar                      | Log4j 日志文件核心 JAR                                       |
| slf4j-log4jl2-l.7.12.jar              | Hibernate 使用的一个日志系统                                 |

从表 2 中可以看出，Hibernate 3 所依赖的 JAR 包共有 10 个。其中 hibernate-jpa-2.0-api-1.0.1.Final.jar 是 JPA 接口的开发包，它位于 Hibernate 的 lib 子目录的 jpa 文件夹中。由于 Hibernate 并没有提供对日志的实现，所以需要 slf4j 和 log4j 开发包整合 Hibernate 的日志系统到 log4j。

Hibernate 的环境搭建非常简单，将表 2 中的所有 JAR 包复制到项目的 WEB-INF/lib 目录下即可。需要注意的是，Hibernate 框架要想与数据库建立连接，使用时还需要导入相关数据库的驱动 JAR 包。