1.1 Hibernate API 變化 1.1.1 包名 1.1.2 org.hibernate.classic包 1.1.3 Hibernate所依賴的第三方軟件包 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類 1.1.11 PersistentEnum類 1.1.12 對(duì)Blob 和Clob的支持 1.1.13 Hibernate中供擴(kuò)展的API的變化 1.2 元數(shù)據(jù)的變化 1.2.1 檢索策略 1.2.2 對(duì)象標(biāo)識(shí)符的映射 1.2.3 集合映射 1.2.4 DTD 1.3 查詢語(yǔ)句的變化 1.3.1 indices()和elements()函數(shù) 盡管Hibernate 3.0 與Hibernate2.1的源代碼是不兼容的，但是當(dāng)Hibernate開(kāi)發(fā)小組在設(shè)計(jì)Hibernate3.0時(shí)，為簡(jiǎn)化升級(jí)Hibernate版本作了周到的考慮。對(duì)于現(xiàn)有的基于Hibernate2.1的Java項(xiàng)目，可以很方便的把它升級(jí)到Hibernate3.0。 本文描述了Hibernate3.0版本的新變化，Hibernate3.0版本的變化包括三個(gè)方面：（1）API的變化，它將影響到Java程序代碼。（2）元數(shù)據(jù)，它將影響到對(duì)象-關(guān)系映射文件。（3）HQL查詢語(yǔ)句。 值得注意的是， Hibernate3.0并不會(huì)完全取代Hibernate2.1。在同一個(gè)應(yīng)用程序中，允許Hibernate3.0和Hibernate2.1并存。 1.1 Hibernate API 變化 1.1.1 包名 Hibernate3.0的包的根路徑為: “org.hibernate” ，而在Hibernate2.1中為“net.sf.hibernate”。這一命名變化使得Hibernate2.1和Hibernate3.0能夠同時(shí)在同一個(gè)應(yīng)用程序中運(yùn)行。 如果希望把已有的應(yīng)用升級(jí)到Hibernate3.0，那么升級(jí)的第一步是把Java源程序中的所有“net.sf.hibernate”替換為“org.hibernate”。 Hibernate2.1中的“net.sf.hibernate.expression”包被改名為“org.hibernate.criterion”。假如應(yīng)用程序使用了Criteria API，那么在升級(jí)的過(guò)程中，必須把Java源程序中的所有“net.sf.hibernate.expression”替換為“org.hibernate.criterion”。 如果應(yīng)用使用了除Hibernate以外的其他外部軟件，而這個(gè)外部軟件又引用了Hibernate的接口，那么在升級(jí)時(shí)必須十分小心。例如EHCache擁有自己的CacheProvider： net.sf.ehcache.hibernate.Provider，在這個(gè)類中引用了Hibernate2.1中的接口，在升級(jí)應(yīng)用時(shí)，可以采用以下辦法之一來(lái)升級(jí)EHCache: （1）手工修改net.sf.ehcache.hibernate.Provider類，使它引用Hibernate3.0中的接口。（2）等到EHCache軟件本身升級(jí)為使用Hibernate3.0后，使用新的EHCache軟件。（3）使用Hibernate3.0中內(nèi)置的CacheProvider：org.hibernate.cache.EhCacheProvider。 1.1.2 org.hibernate.classic包 Hibernate3.0把一些被廢棄的接口都轉(zhuǎn)移到org.hibernate.classic中。 1.1.3 Hibernate所依賴的第三方軟件包 在Hibernate3.0的軟件包的lib目錄下的README.txt文件中，描述了Hibernate3.0所依賴的第三方軟件包的變化。 1.1.4 異常模型 在Hibernate3.0中，HibernateException異常以及它的所有子類都繼承了java.lang.RuntimeException。因此在編譯時(shí)，編譯器不會(huì)再檢查HibernateException。 1.1.5 Session接口 在Hibernate3.0中，原來(lái)Hibernate2.1的Session接口中的有些基本方法也被廢棄，但為了簡(jiǎn)化升級(jí)，這些方法依然是可用的，可以通過(guò)org.hibernate.classic.Session子接口來(lái)訪問(wèn)它們，例如： org.hibernate.classic.Session session=sessionFactory.openSession(); session.delete("delete from Customer "); 在Hibernate3.0中，org.hibernate.classic.Session接口繼承了org.hibernate.Session接口，在org.hibernate.classic.Session接口中包含了一系列被廢棄的方法，如find()、interate()等。SessionFactory接口的openSession()方法返回org.hibernate.classic.Session類型的實(shí)例。如果希望在程序中完全使用Hibernate3.0，可以采用以下方式創(chuàng)建Session實(shí)例： org.hibernate.Session session=sessionFactory.openSession(); 如果是對(duì)已有的程序進(jìn)行簡(jiǎn)單的升級(jí)，并且希望仍然調(diào)用Hibernate2.1中Session的一些接口，可以采用以下方式創(chuàng)建Session實(shí)例： org.hibernate.classic.Session session=sessionFactory.openSession(); 在Hibernate3.0中，Session接口中被廢棄的方法包括： * 執(zhí)行查詢的方法：find()、iterate()、filter()和delete(String hqlSelectQuery) * saveOrUpdateCopy() Hibernate3.0一律采用createQuery()方法來(lái)執(zhí)行所有的查詢語(yǔ)句，采用DELETE 查詢語(yǔ)句來(lái)執(zhí)行批量刪除，采用merge()方法來(lái)替代 saveOrUpdateCopy()方法。 提示：在Hibernate2.1中，Session的delete()方法有幾種重載形式，其中參數(shù)為HQL查詢語(yǔ)句的delete()方法在Hibernate3.0中被廢棄，而參數(shù)為Ojbect類型的的delete()方法依然被支持。delete(Object o)方法用于刪除參數(shù)指定的對(duì)象，該方法支持級(jí)聯(lián)刪除。 Hibernate2.1沒(méi)有對(duì)批量更新和批量刪除提供很好的支持，參見(jiàn)<<精通Hibernate>>一書的第13章的13.1.1節(jié)（批量更新和批量刪除），而Hibernate3.0對(duì)批量更新和批量刪除提供了支持，能夠直接執(zhí)行批量更新或批量刪除語(yǔ)句，無(wú)需把被更新或刪除的對(duì)象先加載到內(nèi)存中。以下是通過(guò)Hibernate3.0執(zhí)行批量更新的程序代碼： 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(); 以下是通過(guò)Hibernate3.0執(zhí)行批量刪除的程序代碼： 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接口來(lái)完成相同的功能。 1.1.7 Lifecycle 和 Validatable 接口 Lifecycle和Validatable 接口被廢棄，并且被移到org.hibernate.classic包中。 1.1.8 Interceptor接口 在Interceptor 接口中加入了兩個(gè)新的方法。 用戶創(chuàng)建的Interceptor實(shí)現(xiàn)類在升級(jí)的過(guò)程中，需要為這兩個(gè)新方法提供方法體為空的實(shí)現(xiàn)。此外，instantiate()方法的參數(shù)作了修改，isUnsaved()方法被改名為isTransient()。 1.1.9 UserType和CompositeUserType接口 在UserType和CompositeUserType接口中都加入了一些新的方法，這兩個(gè)接口被移到org.hibernate.usertype包中，用戶定義的UserType和CompositeUserType實(shí)現(xiàn)類必須實(shí)現(xiàn)這些新方法。 Hibernate3.0提供了ParameterizedType接口，用于更好的重用用戶自定義的類型。 1.1.10 FetchMode類 FetchMode.LAZY 和 FetchMode.EAGER被廢棄。取而代之的分別為FetchMode.SELECT 和FetchMode.JOIN。 1.1.11 PersistentEnum類 PersistentEnum被廢棄并刪除。已經(jīng)存在的應(yīng)用應(yīng)該采用UserType來(lái)處理枚舉類型。 1.1.12 對(duì)Blob 和Clob的支持 Hibernate對(duì)Blob和Clob實(shí)例進(jìn)行了包裝，使得那些擁有Blob或Clob類型的屬性的類的實(shí)例可以被游離、序列化或反序列化，以及傳遞到merge()方法中。 1.1.13 Hibernate中供擴(kuò)展的API的變化 org.hibernate.criterion、
廣告一下 我的新站: BT下載