Apache Geronimo EJB 事務選項權衡 (一)：容器管理事務 (CMT) 核心機制與設定實戰

系列第一部分奠基 EJB 事務基礎：ACID 特性、Flat 事務模型、CMT 核心優勢、六大事務屬性、部署描述符設定、XDoclet 產生、SessionSynchronization 同步介面、回滾機制。

一、事務基礎：ACID 與 Flat 模型

ACID 四大特性：

• Atomicity (原子性)：全做或全不做 (銀行轉帳扣款與入帳必須同時成功)
• Consistency (一致性)：事務前後系統處於合法狀態
• Isolation (隔離性)：並發事務互不干擾，透過鎖機制實現
• Durability (持久性)：提交後資料永久保存，故障可恢復

EJB 採用 Flat 事務模型：

• 單一工作單元，只有 Commit 或 Rollback 兩種結果
• 不支援 Nested 事務 (巢狀事務可獨立回滾不影響父事務)

二、CMT 核心優勢

• 事務邏輯與業務邏輯分離，開發者專注業務
• 宣告式事務邊界：部署描述符定義，無程式碼侵入
• 客戶端無法濫用 Bean (事務始終有始有終)
• Entity Bean **強制使用 CMT**

三、六大事務屬性 (Transaction Attributes)

定義 Bean 方法如何參與事務：

MDB 僅支援兩種屬性：

• Required (預設)：訊息處理必須在事務中
• NotSupported：訊息處理不在事務中

四、部署描述符設定 (ejb-jar.xml)

1. 指定事務類型

    MySession
    ...
    Container 

2. 方法級別指定屬性

    
        
            ClaimRecord
            * 
        
        Required
    
    
    
        
            ClaimRecord
            updateClaimNumber
        
        Mandatory 
    
    
    
        
            Coverage
            *
        
        RequiresNew
    

方法屬性優先於類別屬性。method-intf 可區分 Local/Remote 介面，method-params 區分多載方法。

五、XDoclet 產生部署描述符 (實務標準做法)

Session Bean 類別註解：

/**
 * @ejb.bean 
 *   name="SampleSession"
 *   type="Stateless"
 *   transaction-type="Container"
 *   ...
 * @ejb.interface generate="local,remote"
 * @ejb.home generate="local,remote"
 * @ejb.util generate="physical"
 */
public abstract class SampleSessionBean implements SessionBean {
    
    /**
     * @ejb.interface-method view-type="both"
     * @ejb.transaction type="Required"
     */
    public void doSomething(String param) { ... }
    
    /**
     * @ejb.interface-method view-type="both"
     * @ejb.transaction type="RequiresNew"
     */
    public void doSomethingElse(String param) { ... }
    
    /**
     * @ejb.create-method
     * @ejb.transaction type="Required"
     */
    public void ejbCreate() throws CreateException { ... }
}

Entity Bean 類別註解：

/**
 * @ejb.bean type="CMP" cmp-version="2.x" name="Claim" transaction-type="Container"
 * @ejb.transaction type="Required"  
 * @ejb.persistence table-name="Claim"
 */
public abstract class ClaimBean implements EntityBean { ... }

編譯時 XDoclet 產生完整 ejb-jar.xml，含 transaction-type、container-transaction 等元素。

六、SessionSynchronization：Stateful Bean 事務同步通知

Stateful Session Bean 實作 javax.ejb.SessionSynchronization 可接收事務邊界事件：

七、CMT 禁止呼叫的方法

• java.sql.Connection 的 commit()、rollback()、setAutoCommit()
• EJBContext.getUserTransaction()
• UserTransaction 任何方法

違規將導致容器拋出異常。

八、CMT 回滾機制

1. 自動回滾：業務方法拋出 RuntimeException (含 EJBException)，容器自動回滾
2. 程式化回滾：呼叫 EJBContext.setRollbackOnly() 標記回滾，拋出 Application Exception (檢查型異常)。Application Exception **不** 自動觸發回滾

九、結語

CMT 以宣告式事務屬性將複雜事務管理外部化，配合 XDoclet 自動產生部署描述符，是 EJB 開發主流選擇。掌握六大屬性語義、方法級別覆蓋規則、SessionSynchronization 同步點、雙重回滾機制，即可駕馭 Geronimo/OpenEJB 上的容器管理事務。下一部分將探討 Bean 管理事務 (BMT)。

1. 上一篇文章： Apache Geronimo EJB 事務選項權衡 (二)：Bean 管理事務 (BMT) 完整實作指南
2. 下一篇文章： Java 實作撲克牌發牌演算法完整指南

Java 相關知識

Java 加密技術深度解析：PBE 基於密碼的加密實現指南

在 Java 加密技術系列的前兩篇中，我們已經探討了 DES

UML 建模實戰第四彈：參與者角色、鏡像映象與會話外觀模式

現代系統無不處於網絡中，既為內部用戶服務，也依賴外部系統（瀏

Java 靜默執行 BAT 批處理：ProcessBuilder 重定向輸出避免 CMD 窗口彈出

問題場景 Java 調用 Runtime.exec(cmd

J2EE 中 DAO 層單元測試的最佳實踐：HSQLDB + Spring 事務模板

核心挑戰：DAO 測試的「數據庫依賴三角」 DAO 層單元測