Hibernate目录结构和基础JAR包介

川长思鸟来 2024-03-22 23:54 140阅读 0赞

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

![Hibernate的下载][Hibernate 1]

图 1 Hibernate的下载

![Hibernate的下载][Hibernate 2]

图 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压缩包的文件结构][Hibernate 3]

图 3 Hibernate压缩包的文件结构

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

<table>  表 1 Hibernate子目录介绍  
 <thead> 
  <tr> 
   <th>名&nbsp; &nbsp; 称</th> 
   <th>说&nbsp; &nbsp; 明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>documentation 文件夹</td> 
   <td>该路径下存放了 Hibernate 的相关文档，包括 Hibernate 的参考文档和 API 文档等。</td> 
  </tr> 
  <tr> 
   <td>lib 文件夹</td> 
   <td>该路径下存放了 Hibernate 3 的核心类库，以及编译和运行所依赖的第三方类库。其中 lib 路径下的 required 子目录中包含了运行 Hibernate 3 所必须的 JAR 包。</td> 
  </tr> 
  <tr> 
   <td>project 文件夹</td> 
   <td>该路径下存放了 Hibernate 各种相关项目的源代码。</td> 
  </tr> 
  <tr> 
   <td>hibernate3.jar 文件</td> 
   <td>此 JAR 包是 Hibernate 3 的核心 JAR。</td> 
  </tr> 
 </tbody> 
</table>

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

<table>  表 2 Hibernate 3所需的JAR包的说明  
 <thead> 
  <tr> 
   <th>JAR包名称</th> 
   <th>描&nbsp;&nbsp; 述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate3.jar</td> 
   <td>Hibernate 的核心包</td> 
  </tr> 
  <tr> 
   <td>antlr-2.7.6.jar</td> 
   <td>语言转换工具，Hibernate 利用它实现 HQL 到 SQL 的转换</td> 
  </tr> 
  <tr> 
   <td>commons-collections-3.1.jar</td> 
   <td>collections Apache 的工具集，用于增强&nbsp;<a href="http://www.voidme.com/java" title="Java" rel="nofollow">Java</a>&nbsp;对集合的处理能力</td> 
  </tr> 
  <tr> 
   <td>dom4j-l.6.1.jar</td> 
   <td>dom4j XML解析器</td> 
  </tr> 
  <tr> 
   <td>javassist-3.12.0.GA.jar</td> 
   <td>代码生成工具，Hibernate 利用它在运行时扩展 Java 类</td> 
  </tr> 
  <tr> 
   <td>jta-1.1.jar</td> 
   <td>标准的 JAVA 事务（跨数据库）处理接口</td> 
  </tr> 
  <tr> 
   <td>slf4j-api-l.6.1.jar</td> 
   <td>只是一个接口，用于整合 log4j</td> 
  </tr> 
  <tr> 
   <td>hibernate-jpa-2.0-api-1.0.1.Final.jar</td> 
   <td>JPA 接口开发包</td> 
  </tr> 
  <tr> 
   <td>log4j-l.2.17.jar</td> 
   <td>Log4j 日志文件核心 JAR</td> 
  </tr> 
  <tr> 
   <td>slf4j-log4jl2-l.7.12.jar</td> 
   <td>Hibernate 使用的一个日志系统</td> 
  </tr> 
 </tbody> 
</table>

从表 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 包。

[Hibernate]: http://www.voidme.com/hibernate
[http_sourceforge.net_projects_hibernate_files_hibernate3]: http://www.voidme.com/link?url=http://sourceforge.net/projects/hibernate/files/hibernate3/
[Hibernate 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/b555a670400f48739458bd64a44972ce.png
[Hibernate 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4e25895a4b4e4c1eb4b8f99a0500ea9b.png
[Linux]: http://www.voidme.com/link?url=http://c.biancheng.net/linux_tutorial/
[Hibernate 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/303b129da1e6478f9cc9280a48150dbf.png