Hibernate Tools使用指南
ARCH4开发小组 2007年6月
第 1 页 共 28 页
目 录
1
前言 .............................................................................................................................................................................. 3 1.1 文档编写目的 .............................................................................................................................................. 3 1.2 文档适用范围 .............................................................................................................................................. 3 1.3 修订历史 ...................................................................................................................................................... 4 ARCH4开发组的改进 ................................................................................................................................................ 5 Hibernate Tools的使用方法 ........................................................................................................................................ 5 3.1 HibernateTools的配置 ................................................................................................................................. 5
3.1.1 Wordfile格式 ....................................................................................................................................... 5 3.1.2 通过JToolpad从PDM生成wordfile.properties ................................................................................ 6 3.2 HibernateTools的首次使用 ......................................................................................................................... 6
3.2.1 配置.cfg.xml和console configuration................................................................................................. 6 3.2.2 配置.reveng.xml ................................................................................................................................. 11 3.3 HibernateTools的日常使用 ....................................................................................................................... 13
3.3.1 查看配置 ............................................................................................................................................ 13 3.3.2 配置类型映射 .................................................................................................................................... 14 3.3.3 配置表的过滤 .................................................................................................................................... 15 3.3.4 配置表和列 ........................................................................................................................................ 16
3.3.4.1 Table的映射 ................................................................................................................................ 16 3.3.4.2 主键映射 .................................................................................................................................... 17 3.3.4.3 配置字段 .................................................................................................................................... 17 3.3.4.4 外键关系 .................................................................................................................................... 18 3.3.5 检查源代码 ........................................................................................................................................ 18 3.3.6 使用code gen工具生成POJO .......................................................................................................... 19 附录 ............................................................................................................................................................................ 21 4.1 Eclipse插件安装方式 ................................................................................................................................ 21
4.1.1 简便安装 ............................................................................................................................................ 21 4.1.2 用Links方式安装 ............................................................................................................................. 22 4.1.3 插件安装后的效果 ............................................................................................................................ 22 4.2 对于POJO多对多关系的处理(待确认) .................................................................................................. 22 4.3 使用HQL Editor ........................................................................................................................................ 23
2 3
4
第 2 页 共 28 页
1 前言
本文档是《HIBERNATE TOOLS使用指南》，文档讲述的内容是如何使用Hibernate Tools的方法，其中讲述的指导规范要求开发人员必须遵守
开发人员还需要阅读《ARCH4系统开发指南》。本文档是《ARCH4系统开发指南》的补充。
参与项目开发的任何开发人员如果对本文档讲述的内容有疑问，在开发前请询问项目经理，不允许任何开发人员以任何理由违反本文档讲述的规范要求。
JBoss公司网站www.hibernate.org提供的原版的Hibernate Tools存在一些缺陷，为了正常使用Hibernate Tools，ARCH4开发组针对Hibernate Tools进行了一些修正。
1.1 文档编写目的
避免重复研究工具如何使用的问题。明确使用的方法
1.2 文档适用范围
本文档适用于民安产险核心业务系统项目组成员。下表是对项目组成员的最低要求：
项目组成员 项目经理 系统分析师（业务） 系统分析师（技术） 高级程序员 开发工程师 质量保证工程师 是否必读 ■是 □否 ■是 □否 ■是 □否 ■是 □否 ■是 □否 □是 ■否 要求程度 □了解文档结构 ■明白文档内容 □透彻理解 ■了解文档结构 □明白文档内容 □透彻理解 □了解文档结构 □明白文档内容 ■透彻理解 □了解文档结构 ■明白文档内容 □透彻理解 □了解文档结构 ■明白文档内容 □透彻理解 □了解文档结构 □明白文档内容 □透彻理解 对于项目经理、系统分析师、高级程序员和开发工程师，还需要阅读《ARCH4系统架构设计说明书》和《ARCH4系统开发规范》。
第 3 页 共 28 页
1.3 修订历史
修订章节 全部 类型 创建 日期 2007-06-25 作者 周咸立 说明 Hibernate Tools使用指南。 第 4 页 共 28 页
2 ARCH4开发组的改进
JBoss公司网站www.hibernate.org提供的最新版的Hibernate Tools版本为3.2.0.beta9a，此版本存在一些缺陷，特别是在使用Informix数据库时，问题更加严重。为了正常使用Hibernate Tools，ARCH4开发组针对Hibernate Tools进行了一些修正。主要的变化有：
1. 注释
2. 修正Hibernate Tools无法在生成的实体类中设置自定义类型的Bug 3. 当自定义类型为BLOB或CLOB时自动对该字段添加延迟加载的标记
3 Hibernate Tools的使用方法
注意：ARCH4开发组对Hibernate Tools进行了修正。请使用此版本。SVN地址为：
http://192.168.0.196/pncsvn/src/picclp/others/开发文档/Eclipse Plugins/HibernateTools-3.2.0.beta9a-sinosoft 如果无法通过SVN获取，请向项目经理索取。
参照“4.1Eclipse插件安装方式”安装好Hibernate Tools插件后就可以在Eclipse中使用了。 Hibernate Tools的使用思路为： 1． 2． 3． 4．
在cfg.xml中定义基本的数据库配置
在反向工程文件reveng.xml中定义需要映射的库表，及其属性和关系等 code gen工具来定义想要生成哪些文件，目标路径，包名 生成代码.
3.1 HibernateTools的配置
ARCH4开发组对Hibernate Tools增加了一些新的功能。支持通过配置文件支持属性名的自动大小写转换及属性注释。所以需要提供配置文件。
配置文件位于
HibernateTools-3.2.0.beta9a-sinosoft\\eclipse\\plugins\\org.hibernate.eclipse_3.2.0.beta9a\\lib\\tools目录下，名为wordfile.properties。
3.1.1 Wordfile格式
插件支持多个配置文件，首先从wordfile.properties获取，然后依次为wordfile1.properties、wordfile2.properties、…、wordfile10.properties。通常只需要配置wordfile.properties一个文件即可。
wordfile.properties的格式为：带大小写的属性名=属性描述，没个属性一行
第 5 页 共 28 页
