HibernateTools使用指南.doc

Hibernate Tools使用指南 ARCH4开发小组 2007年6月 目录 1 前言 3 1.1 文档编写目的 3 1.2 文档适用范围 3 1.3 修订历史 4 2 ARCH4开发组的改进 5 3 Hibernate Tools的使用方法 5 3.1 HibernateTools的配置 5 3.1.1 Wordfile格式 5 3.1.2 通过JToolpad从PDM生成perties 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 Table的映射 16 主键映射 17 配置字段 17 外键关系 18 3.3.5 检查源代码 18 3.3.6 使用code gen工具生成POJO 19 4 附录 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  前言 本文档是《HIBERNATE TOOLS使用指南》，文档讲述的内容是如何使用Hibernate Tools的方法，其中讲述的指导规范要求开发人员必须遵守 开发人员还需要阅读《ARCH4系统开发指南》。本文档是《ARCH4系统开发指南》的补充。 参与项目开发的任何开发人员如果对本文档讲述的内容有疑问，在开发前请询问项目经理，不允许任何开发人员以任何理由违反本文档讲述的规范要求。 JBoss公司网站提供的原版的Hibernate Tools存在一些缺陷，为了正常使用Hibernate Tools，ARCH4开发组针对Hibernate Tools进行了一些修正。 文档编写目的 避免重复研究工具如何使用的问题。明确使用的方法 文档适用范围 本文档适用于民安产险核心业务系统项目组成员。下表是对项目组成员的最低要求： 项目组成员 是否必读 要求程度 项目经理 ■是 □否 □了解文档结构 ■明白文档内容 □透彻理解 系统分析师（业务） ■是 □否 ■了解文档结构 □明白文档内容 □透彻理解 系统分析师（技术） ■是 □否 □了解文档结构 □明白文档内容 ■透彻理解 高级程序员 ■是 □否 □了解文档结构 ■明白文档内容 □透彻理解 开发工程师 ■是 □否 □了解文档结构 ■明白文档内容 □透彻理解 质量保证工程师 □是 ■否 □了解文档结构 □明白文档内容 □透彻理解 对于项目经理、系统分析师、高级程序员和开发工程师，还需要阅读《ARCH4系统架构设计说明书》和《ARCH4系统开发规范》。  修订历史 修订章节 类型 日期 作者 说明 全部 创建 2007-06-25 周咸立 Hibernate Tools使用指南。  ARCH4开发组的改进 JBoss公司网站提供的必威体育精装版版的Hibernate Tools版本为3.2.0.beta9a，此版本存在一些缺陷，特别是在使用Informix数据库时，问题更加严重。为了正常使用Hibernate Tools，ARCH4开发组针对Hibernate Tools进行了一些修正。主要的变化有： 注释 修正Hibernate Tools无法在生成的实体类中设置自定义类型的Bug 当自定义类型为BLOB或CLOB时自动对该字段添加延迟加载的标记 Hibernate Tools的使用方法 注意：ARCH4开发组对Hibernate Tools进行了修正。请使用此版本。SVN地址为： 96/pncsvn/src/picclp/others/开发文档/Eclipse Plugins/HibernateTools-3.2.0.beta9a-sinosoft 如果无法通过SVN获取，请向项目经理索取。 参照“4.1Eclipse插件安装方式”安装好Hibernate Tools插件后就可以在Eclipse中使用了。 Hibernate Tools的使用思路为： 在cfg.xml中定义基本的数据库配置反向工程文件reveng.xml中定义需要映射的库表，code gen工具来定义想要生成哪些文件，目标路径，包名生代码HibernateTools的perties。 Wordfile格式 插件支持多个配置文件，首先从perties获取，然后依次为perties、perties、…、perties。通常只需要配置perties一个文