轉載－
http://blog.csdn.net/ufoer23/archive/2005/02/24/299619.aspx2005 年 1 月
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。
參考資料
posted on 2006-08-31 09:47
阿成 閱讀(224)
評論(0) 編輯 收藏 所屬分類:
Hibernate