如何把Hibernate2.1升��到Hibernate3.0

微薄�C�֌� — Tue, 21 Mar 2006 03:19:00 GMT

选自<<�_�N��Hibernate�Q�Java对象持久化技术详�?gt;> 作者：孙卫�?来源:www.javathinker.org

1.1 Hibernate API 变化
1.1.1 包名
1.1.2 org.hibernate.classic�?
1.1.3 Hibernate所依赖的第三方软�g�?
1.1.4 异常模型
1.1.5 Session接口
1.1.6 createSQLQuery()
1.1.7 Lifecycle �?Validatable 接口
1.1.8 Interceptor接口
1.1.9 UserType和CompositeUserType接口
1.1.10 FetchMode�c?
1.1.11 PersistentEnum�c?
1.1.12 对Blob 和Clob的支�?
1.1.13 Hibernate中供扩展的API的变�?
1.2 元数据的变化
1.2.1 ��索策�?
1.2.2 对象标识�W�的映射
1.2.3 集合映射
1.2.4 DTD
1.3 查询语句的变�?
1.3.1 indices()和elements()函数

��管Hibernate 3.0 与Hibernate2.1的源代码是不兼容的，但是当Hibernate开发小�l�在设计Hibernate3.0�Ӟ��为简化升�U�Hibernate版本作了周到的考虑。对于现有的��Z��Hibernate2.1的Java��目�Q�可以很方便的把它升�U�到Hibernate3.0�?/p>

本文描述了Hibernate3.0版本的新变化�Q�Hibernate3.0版本的变化包括三个方面：
�Q?�Q�API的变化，它将影响到Java�E�序代码�?br />�Q?�Q�元数据�Q�它��媄响到对象-关系映射文�g�?br />�Q?�Q�HQL查询语句�?/p>

值得注意的是�Q?Hibernate3.0�q�不会完全取代Hibernate2.1。在同一个应用程序中�Q�允许Hibernate3.0和Hibernate2.1�q�存�?/p>

1.1 Hibernate API 变化

1.1.1 包名

Hibernate3.0的包的根路径�? “org.hibernate�?�Q�而在Hibernate2.1中�ؓ“net.sf.hibernate”。这一命名变化使得Hibernate2.1和Hibernate3.0能够同时在同一个应用程序中�q�行�?/p>

如果希望把已有的应用升��到Hibernate3.0�Q�那么升�U�的�W�一步是把Java源程序中的所有“net.sf.hibernate”替换�ؓ“org.hibernate”�?/p>

Hibernate2.1中的“net.sf.hibernate.expression”包被改名�ؓ“org.hibernate.criterion”。假如应用程序��用了Criteria API�Q�那么在升��的过�E�中�Q�必��L��Java源程序中的所有“net.sf.hibernate.expression”替换�ؓ“org.hibernate.criterion”�?/p>

如果应用使用了除Hibernate以外的其他外部��Y�Ӟ��而这个外部��Y件又引用了Hibernate的接口，那么在升�U�时必须十分��心。例如EHCache拥有自己的CacheProvider�Q?net.sf.ehcache.hibernate.Provider�Q�在�q�个�c�M��引用了Hibernate2.1中的接口�Q�在升��应用�Ӟ��可以采用以下办法之一来升�U�EHCache:

�Q?�Q�手工修改net.sf.ehcache.hibernate.Provider�c�，使它引用Hibernate3.0中的接口�?br />�Q?�Q�等到EHCache软�g本��n升��Z��用Hibernate3.0后，使用新的EHCache软�g�?br />�Q?�Q��用Hibernate3.0中内�|�的CacheProvider�Q�org.hibernate.cache.EhCacheProvider�?/p>

1.1.2 org.hibernate.classic�?/p>

Hibernate3.0把一些被废弃的接口都转移到org.hibernate.classic中�?/p>

1.1.3 Hibernate所依赖的第三方软�g�?/p>

在Hibernate3.0的��Y件包的lib目录下的README.txt文�g中，描述了Hibernate3.0所依赖的第三方软�g包的变化�?/p>

1.1.4 异常模型

在Hibernate3.0中，HibernateException异常以及它的所有子�c�都�l�承了java.lang.RuntimeException。因此在�~�译�Ӟ��~�译器不会再��查HibernateException�?/p>

1.1.5 Session接口

在Hibernate3.0中，原来Hibernate2.1的Session接口中的有些基本�Ҏ��也被废弃�Q�但��Z��化升�U�，�q�些�Ҏ��依然是可用的�Q�可以通过org.hibernate.classic.Session子接口来讉K��它们�Q�例如：

org.hibernate.classic.Session session=sessionFactory.openSession();
session.delete("delete from Customer ");

在Hibernate3.0中，org.hibernate.classic.Session接口�l�承了org.hibernate.Session接口�Q�在org.hibernate.classic.Session接口中包含了一�p�d��被废弃的�Ҏ��Q�如find()、interate()�{�。SessionFactory接口的openSession()�Ҏ��q�回org.hibernate.classic.Session�c�d��的实例。如果希望在�E�序中完全��用Hibernate3.0�Q�可以采用以下方式创建Session实例�Q?/p>

org.hibernate.Session session=sessionFactory.openSession();

如果是对已有的程序进行简单的升��Q��ƈ且希望仍然调用Hibernate2.1中Session的一些接口，可以采用以下方式创徏Session实例�Q?/p>

org.hibernate.classic.Session session=sessionFactory.openSession();

在Hibernate3.0中，Session接口中被废弃的方法包括：
* 执行查询的方法：find()、iterate()、filter()和delete(String hqlSelectQuery)
* saveOrUpdateCopy()

Hibernate3.0一律采用createQuery()�Ҏ��来执行所有的查询语句�Q�采用DELETE 查询语句来执行批量删除，采用merge()�Ҏ��来替�?saveOrUpdateCopy()�Ҏ��?/p>

提示�Q�在Hibernate2.1中，Session的delete()�Ҏ��有几�U�重载�Ş式，其中参数为HQL查询语句的delete()�Ҏ��在Hibernate3.0中被废弃�Q�而参��CؓOjbect�c�d��的的delete()�Ҏ��依然被支持。delete(Object o)�Ҏ��用于删除参数指定的对象，该方法支持��联删除�?/p>

Hibernate2.1没有�Ҏ��量更新和扚w��删除提供很好的支持，参见<<�_�N��Hibernate>>一书的�W?3章的13.1.1节（扚w��更新和批量删除）�Q�而Hibernate3.0�Ҏ��量更新和扚w��删除提供了支持，能够直接执行扚w��更新或批量删除语句，无需把被更新或删除的对象先加载到内存中。以下是通过Hibernate3.0执行扚w��更新的程序代码：

Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

String hqlUpdate = "update Customer set name = :newName where name = :oldName";
int updatedEntities = s.createQuery( hqlUpdate )
.setString( "newName", newName )
.setString( "oldName", oldName )
.executeUpdate();
tx.commit();
session.close();

以下是通过Hibernate3.0执行扚w��删除的程序代码：

Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

String hqlDelete = "delete Customer where name = :oldName";
int deletedEntities = s.createQuery( hqlDelete )
.setString( "oldName", oldName )
.executeUpdate();
tx.commit();
session.close();

1.1.6 createSQLQuery()

在Hibernate3.0中，Session接口的createSQLQuery()�Ҏ��被废弃，被移到org.hibernate.classic.Session接口中。Hibernate3.0采用新的SQLQuery接口来完成相同的功能�?/p>

1.1.7 Lifecycle �?Validatable 接口

Lifecycle和Validatable 接口被废弃，�q�且被移到org.hibernate.classic包中�?/p>

1.1.8 Interceptor接口

在Interceptor 接口中加入了两个新的�Ҏ��?用户创徏的Interceptor实现�c�d��升��的过�E�中�Q�需要�ؓ�q�两个新�Ҏ��提供�Ҏ��体�ؓ�I�的实现。此外，instantiate()�Ҏ��的参��C��了修改，isUnsaved()�Ҏ��被改名�ؓisTransient()�?/p>

1.1.9 UserType和CompositeUserType接口

在UserType和CompositeUserType接口中都加入了一些新的方法，�q�两个接口被�U�d��org.hibernate.usertype包中�Q�用户定义的UserType和CompositeUserType实现�c�d��d��现这些新�Ҏ��?/p>

Hibernate3.0提供了ParameterizedType接口�Q�用于更好的重用用户自定义的�c�d��?/p>

1.1.10 FetchMode�c?/p>

FetchMode.LAZY �?FetchMode.EAGER被废弃。取而代之的分别为FetchMode.SELECT 和FetchMode.JOIN�?/p>

1.1.11 PersistentEnum�c?/p>

PersistentEnum被废弃�ƈ删除。已�l�存在的应用应该采用UserType来处理枚丄��型�?/p>

1.1.12 对Blob 和Clob的支�?/p>

Hibernate对Blob和Clob实例�q�行了包装，使得那些拥有Blob或Clob�c�d��的属性的�cȝ��实例可以被游��R��序列化或反序列化，以及传递到merge()�Ҏ��中�?/p>

1.1.13 Hibernate中供扩展的API的变�?/p>

org.hibernate.criterion�?org.hibernate.mapping�?org.hibernate.persister和org.hibernate.collection 包的�l�构和实现发生了重大的变化。多数基于Hibernate
2.1 的应用不依赖于这些包�Q�因此不会被影响。如果你的应用扩展了�q�些包中的类�Q�那么必��非常小心的对受影响的程序代码进行升�U��?/p>

1.2 元数据的变化

1.2.1 ��索策�?/p>

在Hibernate2.1中，lazy属性的默认��gؓ“false”，而在Hibernate3.0中，lazy属性的默认��gؓ“true”。在升��映射文�g�Ӟ��如果原来的映��文件中的有兛_��素，�?lt;set>�?lt;class>�{�没有显式设�|�lazy属性，那么必须把它们都昑ּ�的设�|��ؓlazy=“true”。如果觉得这�U�升�U�方式很�ȝ��Q�可以采取另一��单的升��方式�Q�在元素中设�|? default-lazy=“false”�?

1.2.2 对象标识�W�的映射

unsaved-value属性是可选的�Q�在多数情况下，Hibernate3.0��把unsaved-value="0" 作�ؓ默认倹{�?/p>

在Hibernate3.0中，当��用自然主键和游离对象�Ӟ��不再��实现Interceptor.isUnsaved()�Ҏ��?如果没有讄��q�个�Ҏ��Q�当Hibernate3.0无法区分对象的状态时�Q�会查询数据库，来判断这个对象到底是临时对象�Q�还是游��d��象。不�q�，昑ּ�的��用Interceptor.isUnsaved()�Ҏ��会获得更好的性能�Q�因��可以减少Hibernate直接讉K��数据库的�ơ数�?/p>

1.2.3 集合映射

元素在某些情况下�?lt;list-index>�?lt;map-key>元素替代。此外，Hibernate3.0�?lt;map-key-many-to-many> 元素来替代原来的.元素�Q�用元素来替代原来的元素�?/p>

1.2.4 DTD

对象-关系映射文�g中的DTD文档�Q�由原来的：
http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd
改�ؓ�Q?br />http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd

1.3 查询语句的变�?/p>

Hibernate3.0 采用新的��Z��ANTLR的HQL/SQL查询��译器，不过�Q�Hibernate2.1的查询翻译器也依然存在。在Hibernate的配�|�文件中�Q�hibernate.query.factory_class属性用来选择查询��译器。例如：
�Q?�Q�选择Hibernate3.0的查询翻译器�Q?br />hibernate.query.factory_class= org.hibernate.hql.ast.ASTQueryTranslatorFactory
�Q?�Q�选择Hibernate2.1的查询翻译器
hibernate.query.factory_class= org.hibernate.hql.classic.ClassicQueryTranslatorFactory

提示�Q�ANTLR是用�U�Java语言�~�写出来的一个编译工��P��它可生成Java语言或者是C++的词法和语法分析器，�q�可产生语法分析树�ƈ对该树进行遍历。ANTLR�׃��是纯Java的，因此可以安装在�Q意��^��C��Q�但是需要JDK的支持�?/p>

Hibernate开发小�l�尽力保证Hibernate3.0的查询翻译器能够支持Hibernate2.1的所有查询语句。不�q�，对于许多已经存在的应用，在升�U�过�E�中�Q�也不妨仍然使用Hibernate2.1的查询翻译器�?br />值得注意的是�Q?Hibernate3.0的查询翻译器存在一个Bug�Q�不支持某些theta-style�q�结查询方言�Q�如Oracle8i的OracleDialect方言、Sybase11Dialect。解册��一问题的办法有两种�Q�（1�Q�改��Z��用支持ANSI-style�q�结查询的方�a��Q�如 Oracle9Dialect,�Q?�Q�如果升�U�的时候遇到这一问题�Q�那么还是改��Z��用Hibernate2.1的查询翻译器�?/p>

1.3.1 indices()和elements()函数

在HQL的select子句中废弃了indices()和elements()函数�Q�因��两个函数的语法很让用戯��解，可以用显式的�q�接查询语句来替�?select elements(...) 。而在HQL的where子句中，仍然可以使用elements()函数�?/p>

微薄�C�֌� 2006-03-21 11:19 发表评论

微薄�C�֌� — Tue, 21 Mar 2006 03:04:00 GMT

之前都是用Hibernate2.1的，原来也没想着升��Q�那天突然发现项目里要做扚w��删除的功能，心想不如升��Hibernate3体验一下�Ş�Q?br />谁知把lib一改，全�ؕ了！首先是hibernate包的路径改了�Q�要把所有的“net.sf.hibernate”替换�ؓ“org.hibernate”�?br />然后��是处理下面几个废弃的方法：find()、iterate()、filter()、delete(String hqlSelectQuery)和saveOrUpdateCopy()。Hibernate3一律采用createQuery()�Ҏ��来执行所有的查询语句�Q�采用DELETE 查询语句来执行批量删除，采用merge()�Ҏ��来替�?saveOrUpdateCopy()�Ҏ��。——又是一�ơ全文搜索和替换�Q?br />�q�样�Q�IDE基本没有报错信息了！但一旦运行就会报Connection timed out�Q�后来发现hibernate的config文�g和map文�g都必��L��dtd改�ؓ3.0。否则xerces会到hibernate.org上找3.0dtd,如果你没有联�|�，则会报出java.net.ConnectException�?br />另外�Q�还要记得添加antlr-2.7.5H3.jar�Q�要不会报java.lang.NoClassDefFoundError: antlr/ANTLRException�?br />�׃��大半天时��_��pȝ��基本正常了！�_�略��查了一下，��览和修改功能都正常�Q�但有一个问题，竟然无法插入新记录啊�Q?br />出现的异��ؓ�Q?br />org.hibernate.exception.ConstraintViolationException: could not insert
后来在所有元素中讄��: default-lazy="false"��可以了�?br />值得一提的是，如果只想对已有的�E�序�q�行��单的升��Q��ƈ且希望仍然调用Hibernate2.1中Session的一些接口，可以采用以下方式创徏Session实例�Q?br />org.hibernate.classic.Session session=sessionFactory.openSession();
�q�样的改动会��很多～～～当然如果希望在程序中完全使用Hibernate3.0�Q�就只能采用以下方式创徏Session实例�Q�org.hibernate.Session session=sessionFactory.openSession();

微薄�C�֌� 2006-03-21 11:04 发表评论

国产精品久久中文,密臀av在线,日本精品影院

如何把Hibernate2.1升��到Hibernate3.0