從Hibernate 2 到 Hibernate 3


這篇文件整理了一些我改寫Hibernate筆記時，從Hibernate 2到Hibernate 3中所遇過的不同點，如果發現有其它重要的改變，將隨時新增至這個文件中。

對 DTD 文件的引用


hibernate.cfg.xml中對DTD文件的引用必須改變，在Hibernate 2中是這樣：
...
<!DOCTYPE hibernate-configuration
    PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">
...

在Hibernate 3中必須這樣：
...
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
...


映射文件在Hibernate 2時是這樣：
...
<!DOCTYPE hibernate-mapping
    PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
...

在Hibernate 3中是這樣：
...
<!DOCTYPE hibernate-mapping
    PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
...

package 的改變


Hibernate 2中API的頂層package名稱是net.sf.hibernate，在Hibernate 3中是org.hibernate，例如Hibernate 2中的net.sf.hibernate.SessionFactory在Hibernate 3中改為org.hibernate.SessionFactory。

取消 Session 中 find()、iterate() 方法


Session中的find()方法被取消了，必須使用Session的createQuery()建立Query實例，並使用list()方法來取代。Session的iterate()被取消了，由Query介面上的iterator()來取代，詳請看 Query.list()、iterator()。

HQL 新增語句


新增 update 語句
Query query = session.createQuery("update User set age=30 where id=1");
query.executeUpdate();

新增 delete 語句
Query query = session.createQuery("delete User where age<20");
query.executeUpdate();

自定義 insert、update、delete


Hibernate 3的映射文件中新增了<sql-insert>、<sql-update>與<sql-delete>三個標籤，您 可以在這三個標籤中使用SQL自定義您的INSERT、UPDATE、DELETE，也就是儲存、更新、刪除資料時的行為，詳請看 自定義 insert、update、delete。

其它

  • Expression類別雖仍可使用，但新增Restrictions類別作為Expression類別的替代。
  • 新增 DetchedCriteria。
  • 新增 動態模型（Dynamic Model）。
  • HibernateException 變為Checked exception。
  • Interceptor 新增了幾個方法。
  • Lazy Initialization預設為 true，不想使用的話，必須在映射文件中設定lazy屬性為false。
  • 可透過org.hibernate.tool.instrument.InstrumentTask對.class檔進行buildtime bytecode instrumentation，實現屬性的Lazy Initialization。