37.2  Hibernate的下载和安装

37.2.1  下载

具体步骤如下：

（1）如图37.2所示，访问Hibernate官方网站http://www.hibernate.org，单击左边菜单的Download超链接，在下载页面中下载Hibernate Core和Hibernate Tools。前者是Hibernate的核心软件包，后者是一个用于辅助Hibernate开发的Eclipse插件。

图37.2  Hibernate的下载页

（2）直正的下载页面会转到著名开源社区sourceforge.net，如图37.3所示。选择下载ZIP格式压缩包hibernate-3.2.2.ga.zip，解压后的目标结构如图37.4所示。

图37.3  下载文件选择                图37.4  Hibernate解压后的目标结构

主要目录及文件解释：

  ● hibernate3.jar文件是Hibernate的核心jar包。

  ● lib目录中有一些Hibernate运行需要依赖的第三方jar包，安装时也要用到。

  ● src目录中是Hibernate（hibernate3.jar）的源文件。

  ● etc目录中有一些可以参考的例子文件。

  ● doc目录中包含Hibernate文档。

37.2.2  安装

1．复制jar包

将解压目录中的hibernate3.jar和lib目录下的jar包，全部复制到项目的Web-INF/lib目录，如果提示有同名文件（commons-logging-1.0.4.jar），覆不覆盖则都一样。其他说明如下：

  ● 其实并不需要复制lib目录下的所有jar包，本文只是为了安装上的方便。如果在正式发布程序时，希望只包括真正用到的包，则可以参考解压目录lib中的_README.txt，里面有详细描述。或者参考Hibernate文档，里面也有部分描述。

  ● 注意不要将这些jar包复制到%TOMCAT_HOME%/common/lib目录下，那是Tomcat全局库所在目录，有可能引起包冲突。

  ● 检查一下lib目录中是否有重复包（不同版本），如有，则只保留一个最新版的包，否则很可能会引起类冲突。因此要把antlr-2.7.2.jar删除，保留antlr-2.7.6.jar。

2．创建log4j.properties

Hibernate用log4j包来做日志输出，这就要求项目中创建一个log4j的配置文件log4j.properties，否则有些运行日志就无法看到（不会影响程序运行），另外Eclipse控制台视图会输出如下两条警告信息。

log4j:WARN No appenders could be found for logger (org.apache.catalina.startup.TldConfig).

log4j:WARN Please initialize the log4j system properly.

如果读者熟悉log4j，可以自己创建log4j.properties，定义自己想要的日志配置。如果不熟悉log4j，可以直接将解压目录etc下的log4j.properties，复制到项目的“Java Resourcess:src”下。注意，由于J2EE透视图拒绝直接复制文件到“Java Resourcess:src”下，所以可以转到Java透视图再复制。