MyEclipse Hibernate 快速入门 中文版

MyEclipseHibernate快速入门中文版翻译:刘长炯(beasoft@126.com)Blog:可自由传播,未经作者许可不得用于商业用途(如付费培训等).注:此文档原文(英文)位于MyEclipse安装后的帮助文档中.最后修改:十月7,2009提纲1.前言2.准备工作3.介绍4.Hibernate一览5.创建HibernateDemo项目1.创建HibernateDemoJavaProject2.添加HibernateCapabilities3.自定义Hibernate配置文件4.创建HibernateJava表映射5.使用模版调整生成更好的代码6.使用自定义反向工程策略7.编辑映射文件6.使用HQL编辑器7.测试HibernateDemo应用8.使用示例HibernateDemo项目9.总结10.用户反馈11.资源1.前言本文档基于以下环境编写:SunJDK1.5,Eclipse3.2和MyEclipse5.0.所有的截屏基于Eclipse,MyEclipseEnterpriseWorkbench,和WindowsXP的默认用户界面设置.如果你对本文档的介绍有阅读上的困难,请阅读用户反馈部分来了解如何向MyEclipse文档团队提交反馈.返回页首2.准备工作下面是这个快速入门的准备工作列表:1.Java2SDK,StandardEdition1.4或者更高版本(参考资源来了解下载地址)2.Eclipse3.2SDK(参考资源来了解下载地址)3.MyEclipse5.0(参考资源来了解下载地址)4.选择以下可以被Hibernate和MyEclipseDatabaseExplorer所支持的数据库服务器列表中的一个:AxionHypersonicDBInstantDBInterclientFirebirdODBCBridgejTDSMckoiMicrosoftSQLServerMimerSQLMySQLOraclePointbasePostgresQLSAPDBSunopsisXMLSybaseThinkSQL返回页首3.介绍这个快速入门展示了使用MyEclipseEnterpriseWorkbench开发Hibernate的基本功能,概念和技术.我们将全程带领你来开发一个非常简单的JavaHibernate应用.对于这个教程没有包含到的问题和概念,我们推荐你去参考资源部分列出的Hibernate资源.这个文档展示了如何进行下列工作:为Java项目添加MyEclipseHibernate支持在项目中创建Hibernate配置文件如何使用自定义的SessionFactory从DatabaseExplorer的表定义中生成Java类和Hibernate数据库映射文件(.hbm)使用HQL编辑器创建使用Hibernate的小测试应用注意:在使用本教程时建议您事先阅读了DatabaseExplorer快速入门这个教程来了解如何创建连接和元数据功能.返回页首4.Hibernate一览Hibernate是一个非常流行的开源的易于配置和运行的基于Java的对象-关系映射(JORM)引擎.它提供了很丰富的功能包括:多种映射策略可迁移的持久化单个对象映射到多个表支持集合多态关联可自定义的SQL查询Hibernate使用Java编写,是高可配置的软件包,可以通过两种配置文件格式来进行配置.第一种配置文件名字为hibernate.cfg.xml.在启动时,Hibernate查询这个XML里面的属性来进行操作,例如数据库连接字符串和密码,数据库方言(databasedialect),以及映射文件位置等.Hibernate在类路径中查找这个文件.第二种配置文件是映射描述文件(文件扩展名为*.hbm),它来指示Hibernate如何来将特定的Java类和一个或者多个数据库表格中的数据进行映射.MyEclipse提供了工具来处理这两种配置文件,并且可以将它们和你对数据库和Hibernate映射的Java类的修改进行同步.Hibernate可以用在任何需要将Java对象和数据库表格中的数据进行移动的Java应用中.因此,它在开发两层和三层的J2EE应用中很有用.向你的应用中集成Hibernate包括:向你的项目中安装Hibernate核心类和依赖的JAR类库创建hibernate.cfg.xml文件来描述如何访问你的数据库为每个持久化Java类创建单独的映射描述文件更多关于Hibernate的基本和高级特性,或者如何使用Hibernate进行开发,请查看页面下方的资源部分.返回页首5.创建HibernateDemo项目这一部分描述了创建名为HibernateDemo的简单的Java项目的过程,这个项目使用Hibernate来保存文本消息到一个单独的数据库表格中.因为多数企业的网络应用都是和企业关系数据库中的数据进行交互,我们将集中精力到编写Java数据对象和映射文件到现有的数据库.我们需要映射到Java类的这个数据库表格列在下面.为了方便测试,我们已经向数据库中添加了很多测试数据.echo_messageDDLCREATETABLEecho_message(idintegerPRIMARYKEYnotnull,msgVARCHAR(255));insertintoecho_messagevalues(1,'helloworld');insertintoecho_messagevalues(2,'goodbyeworld');一般的在你进行Hibernate开发之前你需要一个能够访问的DatabaseExplorer连接配置.在这个教程中,我们使用Oracle数据库连接配置,这个配置在DatabaseExplorer快速入门教程中创建.注意:尽管这个快速入门使用了Oracle,但是这些步骤和上面的表格基本上是通用的,可以在任何数据库下工作.返回页首5.1创建HibernateDemoJavaProject我们先来创建一个普通的名为HibernateDemo的Java项目,这个项目读取写入数据到echo_message数据库表.1.从MyEclipse菜单栏选择FileNewProjectJavaProject.接着会打开NewJavaProject向导.2.输入HibernateDemo到Projectname3.在ProjectLayout下选中Createseparatesourceandoutputfolders单选钮.4.选择Finish来完成这个页面,如图1所示图1.新建HibernateDemo项目返回页首5.2添加HibernateCapabilities到HibernateDemo项目现在HibernateDemo项目已经创建,我们将添加MyEclipseHibernate功能到这个项目.这个基于向导的处理过程执行了下面的操作:添加Hibernate类库(JARs)到项目的类路径.在项目中创建并配置hibernate.cfg.xml在项目中创建自定义的SessionFactory类来简化Hibernate会话处理我们通过打开MyEclipseAddHibernateCapabilities向导来开始:1.在PackageExplorer中选择HibernateDemo项目2.接下来,从MyEclipse菜单栏选择MyEclipseAddHibernateCapabilities...来启动向导(参考图2).图2.启动HibernateSupport向导图3.添加Hibernate支持到Java项目3.保持Hibernate3.1specification选中不变.4.选择你需要的类库集合,在这个示例中Core类库足够了.5.保持AddcheckedLibrariestoprojectbuild-path选中.6.选择Next.表-1.HibernateSupport向导-第1页选项选项描述HibernateSpecification要添加到项目中的Hibernate版本支持功能.为了最大限度的使用MyEclipseHibernate工具,推荐Hibernate3.1.MyEclipse/UserLibraries可以添加到你的项目的构造路径的类库集合.AddcheckedLibrariestoprojectbuild-path选中的类库将会添加到你的项目的构造路径中,但是相应的JAR文件将不会复制到你的项目中.这些JAR文件将会在发布程序时复制,这是推荐的设置方式.CopycheckedLibraryJarstoprojectfolderandaddtobuild-path选中的类库JAR文件将会被复制到你的项目并添加到构造路径中去.LibraryFolder仅在上面的选项选中时可用.一个相对于项目的路径,可以新建或者使用现有目录,Hibernate类库将会被向导复制到这里.第2页允许你自定义配置文件的名字和路径.图4.Hibernate配置文件设置7.保持New选中.8.完成图4中显示的页面然后选择Next.图5.Hibernate数据库配置9.保持Specifydatasourceconnectiondetails?选中.10.选中Oracle配置,这个配置在DatabaseExplorer快速入门设置过,通过DBProfile下拉框选择.这将自动填充当前页面中的所有输入框.注意:在这里数据库配置并非必须的;你可以手工输入所有需要的信息,不需要选择一个配置.在这种情况下,你必须确保在向导完成后手工复制JDBC驱动JAR文件到你的项目中.11.选择Next.上面进行的数据源配置操作可以现在跳过,可以在随后的HibernateConfiguration编辑器中进修改.项目的最后一步是配置一个SessionFactory类,这个类将会访问Hibernate功能所生成的基础代码.本向导的截屏如图6所示.图6.创建SessionFactory详细信息表3-HibernateSupport向导-第3页选项选项描述CreateSessionFactoryClass?如果启用,向导将会创建一个Hibernate会话工厂的新类.Javasourcefolder决定新类将被创建到的源代码目录.Javapackage指定Session工厂将被创建到的包名.Classname指定Session工厂类的名字.JavaComplianceLevel生成的Session工厂类的Java编译器等级.12.选中CreateSessionFactoryclass.13.选中包输入框右侧的New按钮然后创建包com.genuitec.hibernate.14.给SessionFactory类输入一个名字,我们使用默认推荐的HibernateSessionFactory.15.完成如图6所示的页面,然后选择Finish.注意:SessionFactory也可以在稍后创建,通过SessionFactory向导来完成(FileNewOtherMyEclipseHibernateHibernateSessionFactory).如果你在第一页选中了复制类库到你的项目中,在向导完成之后的至多30秒内可能失去反应,因为它将复制类库并更新多种项目资源.请耐心等待并在进行其它操作之前等待过程的结束.这个向导结束后将进行下列操作:如果在第一页选择了复制类库到你的项目,将安装Hibernate类库(JARs)到项目中更新项目的构造路径来包含已安装的Hibernate类库给项目创建并配置hibernate.cfg.xml文件为你的项目创建一个自定义的SessionFactory类(例如HibernateSessionFactory)来简化Hibernate会话会话处理图7高亮显示了新创建的HibernateSess