測試時代 - 軟件測試精品文章

　　　　　　　　　　　　　 Hibernate配置文件在單元測試中的靈活運用

　　　　　　　　　　　　　　　　　　　　作者：張辰雪選自：IBM
　　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>

</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），如前面我們使用的配置文件

會覆蓋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>是必不可少的，必須通過配置<mapping>，configure()才能訪問到我們定義的java對象和關系數據庫表的映射文件（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。