Hibernate外围工具使用配置说明

一、下载地址
（1）apache-ant-1.6.2：http://ant.apache.org/
（2）Middlegen-Hibernate-r5：http://prdownloads.sourceforge.net/hibernate/
（3）hibernate-2.0：http://prdownloads.sourceforge.net/hibernate/
（4）hibernate-extensions-2.1：http://prdownloads.sourceforge.net/hibernate/
解压到同一目录下，例如：d:\hibernate\ apache-ant-1.6.2，d:\hibernate\ Middlegen-Hibernate-r5，D:\hibernate\hibernate-2.0，D:\hibernate\hibernate-extensions-2.1
二、配置
1、Ant的配置
配置环境变量：
我的电脑¬——>属性——>高级——>环境变量——>系统变量——>Path
编辑Path，添加如下配置：D:\hibernate\apache-ant-1.6.2\bin
2、Middlegen-Hibernate-r5的配置
Middlegen-Hibernate-r5是由数据库表自动生成配置文件。
（1）配置数据库文件：
将 db2驱动程序db2java.zip拷贝到D:/hibernate/Middlegen-Hibernate-r5/lib
进入d:\hibernate\ Middlegen-Hibernate-r5目录下的\config\database 子目录，选择你要得数据库文件db2.xml：
A、将属性database.driver.file的value改为：D:/hibernate/Middlegen-Hibernate-r5/lib/db2java.zip（db2的驱动程序路径）
B、将属性database.url的value改为：jdbc:db2:dbName（数据库别名）
C、将属性database.userid的value改为：userName（用户名）
D、将属性database.password的vuale改为：password（密码）
E、将属性database.schema的value改为：DB2INST1（表空间）
（2）修改build.xml文件
build.xml是Middlegen-Hibernate 的Ant构建配置。Middlegen-Hibernate将根据build.xml 文件中的具体参数生成数据库表映射文件
A、24行 修改数据库连接
将原来的
<!ENTITY database SYSTEM "file:./config/database/hsqldb.xml">
改为
<!ENTITY database SYSTEM "file:./config/database/db2.xml">
B、33行 修改应用名
将原来的
<property name="name" value="airline"/>
改成
<property name="name" value="HibernateSample"/>
C、51行 修改输出目录
将原来的
<property name="build.gen-src.dir" value="${build.dir}/gen-src"/>
改为
<property name="build.gen-src.dir" value="D:/hibernate/Middlegen-Hibernate-r5/poss"/>
D、185行 设置对应代码的Package name
将原来的
<hibernate
destination="${build.gen-src.dir}"
package="${name}.hibernate"
genXDocletTags="false"
genIntergratedCompositeKeys="false"
javaTypeMapper="middlegen.plugins.hibernate.HibernateJavaTypeMapper"/>
改为
<hibernate
destination="${build.gen-src.dir}"
package="org.hibernate.sample"
genXDocletTags="true"
genIntergratedCompositeKeys="false"
javaTypeMapper="middlegen.plugins.hibernate.HibernateJavaTypeMapper"/>
说明：hibernate 节点package 属性的默认设置实际上是由前面的Application Name （${name}）和“.hibernate”组合而成，暂且设置成org.hibernate.sample。
3、hibernate-extensions-2.1的配置
（1）build.xml的配置
进入D:\hibernate\hibernate-extensions-2.1\tools目录，打开build.xml
A．42行
改为：<property name="hibernate-core.home" value="D:/hibernate/hibernate-2.0"/>
B．43行
改为：<property name="hibernate-core.jar" value="${hibernate-core.home}/hibernate2.jar"/>
（2）setenv.bat的配置
进入D:\hibernate\hibernate-extensions-2.1\tools\bin目录，以编辑状态打开
setenv.bat
将此文件设置如下：
@echo off

rem -------------------------------------------------------------------
rem Setup environment for hibernate tools
rem -------------------------------------------------------------------

set JDBC_DRIVER=D:\hibernate\Middlegen-Hibernate-r5\lib\db2java.zip
set HIBERNATE_HOME=D:\hibernate\hibernate-2.0

set CORELIB=%HIBERNATE_HOME%\lib
set LIB=..\lib
set PROPS=%HIBERNATE_HOME%\src
set CP=%JDBC_DRIVER%;%PROPS%;%HIBERNATE_HOME%\hibernate2.jar;%CORELIB%\commons-logging.jar;%CORELIB%\commons-collections.jar;%CORELIB%\cglib.jar;%CORELIB%\dom4j.jar;%CORELIB%\xml-apis.jar;%CORELIB%\xerces.jar;%CORELIB%\commons-lang.jar;%CORELIB%\odmg.jar;%CORELIB%\xalan.jar;%LIB%\jdom.jar;%LIB%\..\hibernate-tools.jar
（3）config.xml
编写config.xml文件，内容如下：
<codegen>
<generate renderer="net.sf.hibernate.tool.hbm2java.BasicRenderer">
<param name="generate-concrete-empty-classes">false</param>
</generate>
</codegen>
此文件可以放在任何目录下。
4、启动Middlegen-Hibernate-r5
命令行切换到D:/hibernate/Middlegen-Hibernate-r5目录下，运行ant
5、生成*.hbm.xml
正确完成运行ant后，出现一个GUI界面，点击此界面左上角的“Generate”功能按钮，等待其完成工作后，进入输出目录D:/hibernate/Middlegen-Hibernate-r5/poss中查看结果，进入上述所设置的package name 路径，也就是目录：D:\hibernate\Middlegen-Hibernate-r5\poss\org\hibernate\sample，可以看到ZJPOSS中所有数据库表的相应hibernate配置文件*.hbm.xml。
6、由*.hbm.xml生成java文件
在命令行中进入D:\hibernate\hibernate-extensions-2.1\tools\bin目录，执行命令hbm2java D:\hibernate\Middlegen-Hibernate-r5\poss\org\hibernate\sample\*.xml --output=D:\hibernate\hibernate-2.0\po --config=D:\hibernate\hibernate-extensions-2.1\tools\bin\config.xml
（--output=D:\hibernate\hibernate-2.0\po为生成的java文件保存目录；
--config=D:\hibernate\hibernate-extensions-2.1\tools\bin\config.xml为config.xml文件的目录。）
完成之后，进入D:\hibernate\hibernate-2.0\po\org\hibernate\sample目录，可以看到D:\hibernate\Middlegen-Hibernate-r5\poss\org\hibernate\sample中 *.hbm.xml文件所对应生成 *.java文件。
注：只有使用Middlegen-Hibernate-r5生成的 *.hbm.xml 文件才可使用hibernate\hibernate-extensions-2.1生成相应的 *.java 文件。

2005/09/26