关于将Hibernate2升级为Hibernate3的基本步骤说明

最近在一个项目开发基本完成进入正式试运行的时候,有了一个想法:将项目的Hibernate2.1升级为Hibernate3。由于公司多年来的技术沉淀,以及整体框架和整个平台的搭建是在去年就已完成了的(主要也是我来设计的),当时出于一个安全(风险方面)的考虑,采用的是Struts1.2.8+Hibernate2.1+Spring1.2.8。由于我从04以来一直是用这一套,感觉还比较顺手,所以当时就直接给现在这家软件公司设计出了这一套框架……网上也有很多这些文档的说明,但个人觉得都是一些抄来抄去的。所以,现在将我个人的做法分以下八步来给大家说一下,方便更多朋友熟悉一下hibernate2和hibernate3的差别,给当前项目一点扩展的空间。

第一步:换jar包

即将hibernate2.1.jar包换成hibernate3.jar,这一步很简单这里就不具体说了。

第二步:修改Hibernate.cfg.xml文件(由于项目有遗留的原因)这里有部份模块采用的是Struts+Hibernate框架的

即将hibernate.cfg.xml文件中的

<!DOCTYPEhibernate-configurationPUBLIC

"-//Hibernate/HibernateConfigurationDTD2.0//EN""http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">

改为:

<!DOCTYPEhibernate-configurationPUBLIC

"-//Hibernate/HibernateConfigurationDTD3.0//EN""http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

当然如果你是采用的hibernate.properties的方式那也是类似地做一些修改

第三步:修改ApplicationContext.xml文件(其实这才是真正使用spring集成hibernate时所用的配置文件)

即将ApplicationContext.xml文件中的sessionFacotry/mySessionFactoryBean的配置做相应的修改。具本如下:

将先前的:

<beanid="mySessionFactory"class="org.springframework.orm.hibernate.LocalSessionFactoryBean">

………</bean>

修改为:

<beanid="mySessionFactory"class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">

………</bean>

第四步:修改事务配置信息(我个人认为我们应该将每个不同的管理分放到不同的文件中,比如:我这里我是将事务,日志管理以及sessionFactory分开放了,)我这是applicationcontext_transaction.xml文件

即将applicationcontext_transaction.xml文件中的transactionManager对象的内容做相应的修改:具体如下:

将:

<!--transactionManager-->

<beanid="transactionManager"

class="org.springframework.orm.hibernate.HibernateTransactionManager">

<propertyname="sessionFactory">

<refbean="mySessionFactory"/>

</property>

</bean>

修改为:

<!--transactionManager-->

<beanid="transactionManager"

class="org.springframework.orm.hibernate3.HibernateTransactionManager">

<propertyname="sessionFactory">

<refbean="mySessionFactory"/>

</property>

</bean>

第五步:修改xxx.hbm.xml文件

将<!DOCTYPEhibernate-mappingPUBLIC

"-//Hibernate/HibernateMappingDTD2.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">

修改为:

<!DOCTYPEhibernate-mappingPUBLIC

"-//Hibernate/HibernateMappingDTD3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

第六步:修改java文件中的引入import

将所有程序中的net.sf.hibernate替换为org.hibernate

但是有例外

net.sf.hibernate.expression.Expression换为org.hibernate.criterion.Expression

如果用eclipse,用ctrl+shift+o快捷键可以加快速度

第七步:修改一些Hibernate3废弃的方法

在Hibernate3.0中,原来Hibernate2.1的Session接口中的有些基本方法也被废弃,但为了简化升级,这些方法依然是可用的,可以通过org.hibernate.classic.Session子接口来访问它们,例如:

org.hibernate.classic.Sessionsession=sessionFactory.openSession();

session.delete("deletefromCustomer");

在Hibernate3.0中,org.hibernate.classic.Session接口继承了org.hibernate.Session接口,在org.hibernate.classic.Session接口中包含了一系列被废弃的方法,如find()、interate()等。SessionFactory接口的openSession()方法返回org.hibernate.classic.Session类型的实例。如果希望在程序中完全使用Hibernate3.0,可以采用以下方式创建Session实例:

org.hibernate.Sessionsession=sessionFactory.openSession();

如果是对已有的程序进行简单的升级,并且希望仍然调用Hibernate2.1中Session的一些接口,可以采用以下方式创建Session实例:

org.hibernate.classic.Sessionsession=sessionFactory.openSession();

在Hibernate3.0中,Session接口中被废弃的方法包括:

*执行查询的方法:find()、iterate()、filter()和delete(StringhqlSelectQuery)

*saveOrUpdateCopy()

Hibernate3.0一律采用createQuery()方法来执行所有的查询语句,采用DELETE查询语句来执行批量删除,采用merge()方法来替代saveOrUpdateCopy()方法。

提示:在Hibernate2.1中,Session的delete()方法有几种重载形式,其中参数为HQL查询语句的delete()方法在Hibernate3.0中被废弃,而参数为Ojbect类型的的delete()方法依然被支持。delete(Objecto)方法用于删除参数指定的对象,该方法支持级联删除。

Hibernate2.1没有对批量更新和批量删除提供很好的支持,参见<<精通Hibernate>>一书的第13章的

(批量更新和批量删除),而Hibernate3.0对批量更新和批量删除提供了支持,能够直接执行批量更新或批量删除语句,无需把被更新或删除的对象先加载到内存中。以下是通过Hibernate3.0执行批量更新的程序代码:

Sessionsession=sessionFactory.openSession();

Transactiontx=session.beginTransaction();

StringhqlUpdate="updateCustomersetname=:newNamewherename=ldName";

intupdatedEntities=s.createQuery(hqlUpdate)

.setString("newName",newName)

.setString("oldName",oldName)

.executeUpdate();

tx.commit();

session.close();

以下是通过Hibernate3.0执行批量删除的程序代码:

Sessionsession=sessionFactory.openSession();

Transactiontx=session.beginTransaction();

StringhqlDelete="deleteCustomerwherename=ldName";

intdeletedEntities=s.createQuery(hqlDelete)

.setString("oldName",oldName)

.executeUpdate();

tx.commit();

session.close();

kypfos回复于2005-08-2511:18:17