Hibernate 是一個流行的開源對象關系映射工具，單元測試和持續集成的重要性也得到了廣泛的推廣和認同，在采用了Hibernate的項目中如何保證測試的自動化和持續性呢？本文討論了Hibernate加載其配置文件hibernate.properties和hibernate.cfg.xml的過程，以及怎麼樣將hibernate提供的配置文件的訪問方法靈活運用到單元測試中。
介紹
Hibernate 是一個流行的開源對象關系映射工具，單元測試和持續集成的重要性也得到了廣泛的推廣和認同，在采用了Hibernate的項目中如何保證測試的自動化和持續性呢？本文討論了Hibernate加載其配置文件hibernate.properties和hibernate.cfg.xml的過程，以及怎麼樣將hibernate提供的配置文件的訪問方法靈活運用到單元測試中。注意：本文以hibernate2.1作為討論的基礎，不保證本文的觀點適合於其他版本。
讀者
Java開發人員，要求熟悉JUnit和掌握Hibernate的基礎知識
內容
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。
}
}
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、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的默認的加載過程就比較清楚了。
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");
5、總結
Configuration提供的這些方法的好處如下：
1) 一個應用中往往有很多.hbm.xml映射文件，開發的過程中如果只是為了測試某個或幾個Java PO(Persistence Object)，我們沒有必要把所有的.hbm.xml都加載到內存，這樣可以通過addClass或者addFile直接，顯得非常靈活。
2) 學習Hibernate的過程中，往往需要通過練習來體會Hibernate提供的各種特征，而很多特征是需要修改配置文件的，如果要觀察相同的代碼在不同的特征下的表現，就需要手工改配置文件，這樣太麻煩了，而且容易出錯，我們可以提供多個配置文件，每個配置文件針對需要的特征而配置，這樣我們在調用程序的時候，把不同的配置文件作為參數傳遞進去，而程序代碼裡面使用setProperties和addFile指定傳入的配置文件參數就可以了。
3) 在單元測試中，特別是在集成測試裡面，整個過程是自動化的，我們不能手工干預測試過程，往往需要准備多個配置文件針對不同的測試案例，這個時候setProperties和addFile方法就顯得特別有用了，在不同的測試案例中用這些方法來指定相應的配置文件，這樣就可以做到自動化測試，保證了持續性。
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的項目中靈活的運用多配置文件，可以提高測試的效率，保證自動化和持續性。
