Hibernate 配置檔案在單元測試中的靈活應用：多配置隔離與自動化測試實戰

背景痛點：單一配置難以支援多樣化測試場景

採用 Hibernate 的專案若要落實自動化單元測試與持續整合 (CI)，常面臨：

• 不同測試案例需不同資料庫（H2 記憶體庫 vs MySQL/PostgreSQL 整合庫）。
• 驗證特定映射策略（如 inverse="true/false"、lazy="true/false"、fetch="join/select/subselect"）需切換映射檔。
• 測試並行執行時，共用 SessionFactory 導致狀態汙染。
• 手動修改 hibernate.cfg.xml 破壞自動化、易出錯。

本文深入解析 Hibernate 2.1/3.x Configuration 載入機制，示範如何利用程式化 API 實現多配置檔案隔離、按需載入映射、測試專用 SessionFactory，打造零手工干預的自動化測試體系。

Configuration 載入流程深度解析

1. new Configuration() 做了什麼？

• 掃描 Classpath 尋找 hibernate.properties，存在則載入至 GLOBAL_PROPERTIES，否則輸出 hibernate.properties not found。
• 將系統屬性 System.getProperties() 合併入內。
• 驗證屬性有效性，棄用參數發出警告。

2. configure() / configure(String resource) 做了什麼？

• 預設尋找 Classpath 下 hibernate.cfg.xml，或指定資源路徑（如 myexample.xml）。
• 解析 <session-factory>：
• name 屬性覆蓋 hibernate.session_factory_name。
• 所有 <property> 覆蓋 hibernate.properties 同名屬性（XML 優先級較高）。
• 依序處理 <mapping>、<jcs-class-cache>、<collection-cache> 等元素。
• <mapping resource="Cat.hbm.xml"/> 為必須，載入實體映射檔。

Configuration 進階程式化 API 快查表

實戰案例：針對雙向關聯 inverse 屬性的自動化對比測試

場景：驗證 one-to-many 端設定 inverse="true" vs "false" 對 SQL 發送次數、級聯行為的影響。

準備兩份映射檔（僅 inverse 不同）

兩個獨立測試類別，各自程式化建立 SessionFactory

public class FalseInverseTest extends TestCase {
    private Session session;
    private Transaction tx;

    protected void setUp() throws Exception {
        // 僅載入特定映射檔，不依賴 cfg.xml
        Configuration cfg = new Configuration()
            .setProperty("hibernate.dialect", "org.hibernate.dialect.H2Dialect")
            .setProperty("hibernate.connection.driver_class", "org.h2.Driver")
            .setProperty("hibernate.connection.url", "jdbc:h2:mem:test;DB_CLOSE_DELAY=-1")
            .setProperty("hibernate.connection.username", "sa")
            .setProperty("hibernate.connection.password", "")
            .setProperty("hibernate.hbm2ddl.auto", "create-drop")
            .setProperty("hibernate.show_sql", "true")
            .addFile("bidirect.inverse.false.hbm.xml"); // 關鍵：指定映射檔
        
        session = cfg.buildSessionFactory().openSession();
        tx = session.beginTransaction();
    }

    protected void tearDown() throws Exception {
        tx.commit();
        session.close();
    }

    public void testInverseFalseBehavior() {
        // 驗證 inverse=false 時，雙邊維護關聯會發送額外 UPDATE
        Parent p = new Parent();
        Child c = new Child();
        p.getChildren().add(c);
        c.setParent(p);
        session.save(p); // 分析 SQL 輸出
    }
}

public class TrueInverseTest extends TestCase {
    protected void setUp() throws Exception {
        Configuration cfg = new Configuration()
            // ... 相同資料庫屬性 ...
            .addFile("bidirect.inverse.true.hbm.xml"); // 載入 inverse=true 映射
        session = cfg.buildSessionFactory().openSession();
        tx = session.beginTransaction();
    }
    // 相同測試邏輯，對比 SQL 差異
}

優勢

• 零手工切換：CI 流水線並行執行兩測試類，互不干擾。
• 極速啟動：僅載入單一映射檔 + H2 記憶體庫，create-drop 自動建表清表。
• 專注驗證：測試碼專注業務邏輯與 SQL 行為對比，無環境雜訊。

進階模式：測試基底類別封裝配置建構

public abstract class HibernateTestCase extends TestCase {
    protected SessionFactory sf;
    protected Session session;
    protected Transaction tx;

    // 子類別覆寫提供映射檔清單
    protected abstract List getMappingFiles();
    // 子類別可覆寫資料庫屬性
    protected Properties getDatabaseProperties() {
        Properties p = new Properties();
        p.setProperty("hibernate.dialect", "org.hibernate.dialect.H2Dialect");
        p.setProperty("hibernate.connection.driver_class", "org.h2.Driver");
        p.setProperty("hibernate.connection.url", "jdbc:h2:mem:" + getClass().getSimpleName());
        p.setProperty("hibernate.hbm2ddl.auto", "create-drop");
        return p;
    }

    @Override
    protected void setUp() throws Exception {
        Configuration cfg = new Configuration();
        cfg.setProperties(getDatabaseProperties());
        for (String mapping : getMappingFiles()) {
            cfg.addFile(mapping); // 或 addClass / addURL
        }
        sf = cfg.buildSessionFactory();
        session = sf.openSession();
        tx = session.beginTransaction();
    }

    @Override
    protected void tearDown() throws Exception {
        try { tx.commit(); } finally { session.close(); sf.close(); }
    }
}

// 具體測試類別極度精簡
public class CatTest extends HibernateTestCase {
    @Override protected List getMappingFiles() {
        return Arrays.asList("Cat.hbm.xml");
    }
    public void testCreate() { /* ... */ }
}

持續整合管線整合建議

1. Maven/Gradle 資源分離：src/test/resources/hibernate 放置測試專用映射檔與 *-test.cfg.xml。
2. Profile 隔離：mvn test -Ph2 / -Pmysql 切換資料庫屬性檔。
3. 並行執行：Surefire/Failsafe <parallel>classes</parallel>，每類別獨立 SessionFactory 無鎖競爭。
4. 快照比對：使用 hibernate.show_sql=true + log4jdbc 捕獲 SQL，斷言預期 SQL 序列（如 assertSqlSequence()）。

總結

Hibernate Configuration 提供豐富的程式化 API，關鍵在於：

• 理解載入優先級：系統屬性 < hibernate.properties < hibernate.cfg.xml < 程式化 setProperty/addFile。
• 拒絕單一巨型 cfg.xml：測試專用配置程式化組裝，按需載入映射。
• 每測試類別/套件獨立 SessionFactory：隔離狀態、支援並行、配合 create-drop 實現自給自足。
• 封裝基底類別：消除樣板碼，讓測試聚焦業務驗證。

掌握這些技巧，即可在 Hibernate 專案中建立快速、隔離、可維護、全自動的單元測試體系，為持續整合奠定堅實基礎。