Hibernate 是一個流行的開源對象關系映射工具，單元測試和持續集成的重要性也得到了廣泛的推廣和認同，在采用了Hibernate的項目中如何保證測試的自動化和持續性呢？本文討論了Hibernate加載其配置文件hibernate.properties和hibernate.cfg.xml的過程，以及怎么樣將hibernate提供的配置文件的訪問方法靈活運用到單元測試中。

1 介紹
Hibernate 是一個流行的開源對象關系映射工具，單元測試和持續集成的重要性也得到了廣泛的推廣和認同，在采用了Hibernate的項目中如何保證測試的自動化和持續性呢？本文討論了Hibernate加載其配置文件hibernate.properties和hibernate.cfg.xml的過程，以及怎么樣將hibernate提供的配置文件的訪問方法靈活運用到單元測試中。注意：本文以hibernate2.1作為討論的基礎，不保證本文的觀點適合于其他版本。

2 讀者
Java開發人員，要求熟悉JUnit和掌握Hibernate的基礎知識

3 內容

3.1.準備
對于hibernate的初學者來說，第一次使用hibernate的經驗通常是：

1，安裝配置好Hibernate，我們后面將%HIBERNATE_HOME%作為對Hibernate安裝目錄的引用，

2，開始創建好自己的第一個例子，例如hibernate手冊里面的類Cat，

3，配置好hbm映射文件（例如Cat.hbm.xml，本文不討論這個文件內配置項的含義）和數據庫（如hsqldb），

4，在項目的classpath路徑下添加一個hibernate.cfg.xml文件，如下(第一次使用hibernate最常見的配置內容)：


<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration
    PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">

<hibernate-configuration>
<session-factory>

<property name="connection.url">jdbc:hsqldb:hsql://localhost</property>
<property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
<property name="connection.username">sa</property>
<property name="connection.password"></property>
<property name="dialect">net.sf.hibernate.dialect.HSQLDialect</property>

        <property name="hibernate.show_sql">false</property>

        <mapping resource="Cat.hbm.xml"/>

</session-factory>
</hibernate-configuration>

5，然后還需要提供一個類來測試一下創建，更新，刪除和查詢Cat，對于熟悉JUnit的開發人員，可以創建一個單元測試類來進行測試，如下：


import junit.framework.TestCase;
import net.sf.hibernate.HibernateException;
import net.sf.hibernate.Session;
import net.sf.hibernate.Transaction;
import net.sf.hibernate.cfg.Configuration;


public class CatTest extends TestCase {

    private Session session;
    private Transaction tx;

    protected void setUp() throws Exception {
        Configuration cfg = new Configuration().configure();////注意這一行，這是本文重點討論研究的地方。
        session = cfg.buildSessionFactory().openSession();
        tx = session.beginTransaction();
    }

    protected void tearDown() throws Exception {
  tx.commit();
  session.close();
    }
    
    public void testCreate()  {
     //請在此方法內添加相關的代碼，本文不討論怎么樣使用Hibernate API。
    }
    public void testUpdate()  {
     //請在此方法內添加相關的代碼，本文不討論怎么樣使用Hibernate API。
    }
    public void testDelete()  {
     //請在此方法內添加相關的代碼，本文不討論怎么樣使用Hibernate API。
    }
    public void testQuery()  {
     //請在此方法內添加相關的代碼，本文不討論怎么樣使用Hibernate API。
    }

}

3.2 new Configuration()都做了什么？
對于第一次使用hibernate的新手來說，下面的這段代碼可以說是最常見的使用Configuration方式。


Configuration cfg = new Configuration().configure();

Configuration是hibernate的入口，在新建一個Configuration的實例的時候，hibernate會在classpath里面查找hibernate.properties文件，如果該文件存在，則將該文件的內容加載到一個Properties的實例GLOBAL_PROPERTIES里面，如果不存在，將打印信息


hibernate.properties not found

然后是將所有系統環境變量（System.getProperties()）也添加到GLOBAL_PROPERTIES里面（注1）。如果hibernate.properties文件存在，系統還會驗證一下這個文件配置的有效性，對于一些已經不支持的配置參數，系統將打印警告信息。

3.3. configure()在做什么？
new Configuration()討論至此，下面討論configure()方法。

configure()方法默認會在classpath下面尋找hibernate.cfg.xml文件，如果沒有找到該文件，系統會打印如下信息并拋出HibernateException異常。


hibernate.cfg.xml not found

如果找到該文件，configure()方法會首先訪問< session-factory >，并獲取該元素的name屬性，如果非空，將用這個配置的值來覆蓋hibernate.properties的hibernate.session_factory_name的配置的值，從這里我們可以看出，hibernate.cfg.xml里面的配置信息可以覆蓋hibernate.properties的配置信息。

接著configure()方法訪問<session-factory>的子元素，首先將使用所有的<property>元素配置的信息（注2），如前面我們使用的配置文件


    <property name="connection.url">jdbc:hsqldb:hsql://localhost</property>
  <property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
  <property name="connection.username">sa</property>
  <property name="connection.password"></property>
  <property name="dialect">net.sf.hibernate.dialect.HSQLDialect</property>

會覆蓋hibernate.properties里面對應的配置，hibernate2.1發布包里面自帶的hibernate.properties文件（位于%HIBERNATE_HOME%/etc下面）里面的值，如下：


hibernate.dialect net.sf.hibernate.dialect.HSQLDialect
hibernate.connection.driver_class org.hsqldb.jdbcDriver
hibernate.connection.username sa
hibernate.connection.password
hibernate.connection.url jdbc:hsqldb:hsql://localhost

然后configure()會順序訪問以下幾個元素的內容


<mapping>
<jcs-class-cache>
<jcs-collection-cache>
<collection-cache>

其中<mapping>是必不可少的，必須通過配置<mapping>，configure()才能訪問到我們定義的java對象和關系數據庫表的映射文件（hbm.xml），例如：


<mapping resource="Cat.hbm.xml"/>

通過以上的分析，我們對hibernate配置文件hibernate.properties和hibernate.cfg.xml的默認的加載過程就比較清楚了。

3.4 Configuration的其他用法
Configuration的configure ()方法還支持帶參數的訪問方式，你可以指定hbm.xml文件的位置，而不是使用默認的classpath下面的hibernate.cfg.xml這種方式，例如：


Configuration cfg = new Configuration().configure("myexample.xml");

同時Configuration還提供了一系列方法用來定制hibernate的加載配置文件的過程，讓你的應用更加靈活，常用的是以下幾種：


addProperties(Element)
addProperties(Properties)
setProperties(Properties)
setProperty(String, String)

通過以上幾個方法，除了使用默認的hibernate.properties文件，你還可以提供多個.properties配置文件，使用Hibernate的時候根據不同的情況使用不同的配置文件，例如：


Properties properties = Properties.load("my.properties");
Configuration config = new Configuration().setProperties(properties).configure();

除了指定.properties文件之外，還可以指定.hbm.xml文件，下面列出幾個常用的方法：


addClass(Class)
addFile(File)
addFile(String)
addURL(URL)

前面我們已經講了，configure()方法默認是通過訪問hibernate.cfg.xml的<mapping>元素來加載我們提供的.hbm.xml文件，上面列出的方法可以直接指定hbm.xml文件，例如addClass()方法可以直接通過指定class來加載對應的映射文件，hibernate會將提供的class的全名（包括package）自動轉化為文件路徑，如net.sf.hibernate.examples.quickstart.Cat.class對應了net/sf/hibernate/examples/quickstart/Cat.hbm.xml，還可以用addFile方法直接指定映射文件。

例一：


Configuration config = new Configuration().addClass(Cat.class);

例二：


Configuration config = new Configuration().addURL(Configuration.class.getResource ("Cat.hbm.xml"));

例三：


Configuration config = new Configuration().addFile("Cat.hbm.xml");

3.5 總結
Configuration提供的這些方法的好處如下：

1．一個應用中往往有很多.hbm.xml映射文件，開發的過程中如果只是為了測試某個或幾個Java PO(Persistence Object)，我們沒有必要把所有的.hbm.xml都加載到內存，這樣可以通過addClass或者addFile直接，顯得非常靈活。

2．學習Hibernate的過程中，往往需要通過練習來體會Hibernate提供的各種特征，而很多特征是需要修改配置文件的，如果要觀察相同的代碼在不同的特征下的表現，就需要手工改配置文件，這樣太麻煩了，而且容易出錯，我們可以提供多個配置文件，每個配置文件針對需要的特征而配置，這樣我們在調用程序的時候，把不同的配置文件作為參數傳遞進去，而程序代碼里面使用setProperties和addFile指定傳入的配置文件參數就可以了。

3．在單元測試中，特別是在集成測試里面，整個過程是自動化的，我們不能手工干預測試過程，往往需要準備多個配置文件針對不同的測試案例，這個時候setProperties和addFile方法就顯得特別有用了，在不同的測試案例中用這些方法來指定相應的配置文件，這樣就可以做到自動化測試，保證了持續性。

3.6 應用舉例
在剛開始學習hibernate的時候，對于hibernate的hbm映射文件里的各種配置參數沒有一個感性的認識，例如inverse="true",lazy="true"這樣的配置參數，不通過實踐是無法體會到其作用的，傳統的方法就是每需要測試一種參數的效果就更改相應的配置文件，然后運行測試來觀察結果，如果能夠靈活的運用Configuration提供的定制配置的方法，我們可以提供多個配置文件，每個配置文件里面有不同的配置參數，配合相應的測試案例就方便多了。

例如針對ono-to-many和many-to-one的雙向關聯的映射關系，我們想測試在one-to-many一方使用inverse="false"和inverse="true"的不同效果，假設已經正確的配置好了hibernate.properties，那么還需要提供兩個不同的hbm.xml文件，假設分別名為bidirect.inverse.false.hbm.xml和bidirect.inverse.true.hbm.xml。

然后需要寫兩個不同的測試案例，分別針對兩個不同的配置文件進行測試就可以了，這樣的好處是，不用針對不同的測試案例修改配置文件，特別是在集成測試的時候，一切都是自動化的，如果每測試一個案例就需要手工去更改配置文件，這肯定是一個失敗的測試。

代碼模板如下：


FalseInverseTest.java文件
import junit.framework.TestCase;
import net.sf.hibernate.HibernateException;
import net.sf.hibernate.Session;
import net.sf.hibernate.Transaction;
import net.sf.hibernate.cfg.Configuration;

/**
 * test false inverse
 */
public class FalseInverseTest extends TestCase {

    private Session session;
    private Transaction tx;

    protected void setUp() throws Exception {
        Configuration cfg = new Configuration().addFile("bidirect.inverse.false.hbm.xml");
        session = cfg.buildSessionFactory().openSession();
        tx = session.beginTransaction();
    }

    protected void tearDown() throws Exception {
tx.commit();
      session.close();
    }
    
    public void testLogic()  {
     //在此編寫測試代碼
    }

}

TrueInverseTest.java文件


import junit.framework.TestCase;
import net.sf.hibernate.HibernateException;
import net.sf.hibernate.Session;
import net.sf.hibernate.Transaction;
import net.sf.hibernate.cfg.Configuration;

/**
 * test true inverse
 */
public class TrueInverseTest extends TestCase {

    private Session session;
    private Transaction tx;

    protected void setUp() throws Exception {
        Configuration cfg = new Configuration().addFile("bidirect.inverse.true.hbm.xml");
        session = cfg.buildSessionFactory().openSession();
        tx = session.beginTransaction();
    }

    protected void tearDown() throws Exception {
      tx.commit();
      session.close();
    }
    
    public void testLogic()  {
     //在此編寫測試代碼
    }

}

結束語
通過對Hibernate默認的配置文件的加載順序和Hibernate提供的加載配置文件的方法的討論，我們對在使用到Hibernate的項目的單元測試中使用多個Hibernate配置文件有了比較清楚的認識。

持續集成中的測試的特征是自動化和持續性，不能手工干預其過程，在使用到Hibernate的項目如果要實現持續集成，就要為不同的測試案例提供不同的配置文件，而不是針對不同的測試案例進行手工調整，因此，在使用到Hibernate的項目中靈活的運用多配置文件，可以提高測試的效率，保證自動化和持續性。

注1：有關的代碼請參考Environment類的static{}。

注2：如果在hibernate.cfg.xml的<property/>配置的name沒有以hibernate開頭，那么configure()內部會自動在前面添加hibernate，例如connection.url，hibernate會自動將其轉化為hibernate.connection.url。

參考資料

官方hibernate reference 地址：http://hibernate.org

posted on 2006-08-31 09:47 阿成閱讀(228) 評論(0) 編輯收藏所屬分類: Hibernate

新用戶注冊刷新評論列表


只有注冊用戶登錄后才能發表評論。




網站導航: 博客園 IT新聞 Chat2DB C++博客博問管理
相關文章: Hibernate配置文件在單元測試中的靈活運用關于Hibernate緩存的使用－－（ZT－http://blog.csdn.net/woshichenxu/archive/2006/01/22/586361.aspx） Hibernate學習筆記 Hibernate入門 - 包作用詳解 hibernate二級緩存攻略 -------轉載java視線上Areyouok?的文章幾個老生常談的hibernate問題延遲初始化錯誤（ERROR LazyInitializer）是如何產生的?

常用鏈接

留言簿(6)

我參與的團隊

隨筆分類

隨筆檔案

文章檔案

休閑娛樂

外文網站

好的技術論壇

搜索引擎

經典Blog

搜索

最新評論

閱讀排行榜

評論排行榜