WebSphere 多版本 J2EE 應用並行部署全攻略：類加載隔離、JNDI 隔離與封裝策略

業務背景：漸進式升級的剛性需求

企業級 J2EE 應用隨時間演進，往往需要增量式升級而非大爆發式重寫。典型場景：修復某個 EJB 組件缺陷、為 Servlet 添加新字段、升級特定模塊依賴的數據庫結構。核心挑戰：在同一 WebSphere 實例中，同時運行同一應用的多個版本，且版本間組件可選擇性共享或隔離。

四大核心衝突域與解決方案

1. 類加載衝突 — 父子類加載器隔離

WebSphere 類加載器層次:
Bootstrap ClassLoader
    │
    ▼
Extension ClassLoader
    │
    ▼
Application ClassLoader (每個 EAR 一個)
    │
    ├── EJB ClassLoader (載入 EJB JAR)
    │
    └── WAR ClassLoader (載入 Web 模塊，Application 的子加載器)
         ├── Web Module v1
         └── Web Module v2

• 不同 EAR → 不同 Application ClassLoader → 徹底隔離 EJB 類
• 同 EAR 內不同 WAR → 不同 WAR ClassLoader → 隔離 Web 類
• 共享庫 → 放在較高層類加載器 (如 Application 或 Server 級) → 多版本共享

2. Servlet 路徑衝突 — Context Root 隔離

<!-- application.xml 中為每個版本指定唯一 context-root -->
<module>
    <web>
        <web-uri>MyBankCMPWebv1.war</web-uri>
        <context-root>MyBankCMPWebv1</context-root>  <!-- 版本 1 -->
    </web>
</module>
<module>
    <web>
        <web-uri>MyBankCMPWebv2.war</web-uri>
        <context-root>MyBankCMPWebv2</context-root>  <!-- 版本 2 -->
    </web>
</module>

• 訪問路徑：/MyBankCMPWebv1/servlet vs /MyBankCMPWebv2/servlet
• 靜態資源 (HTML/JSP/JS/CSS) 同樣隔離

3. JNDI 名稱空間衝突 — java:comp/env 環境項綁定

核心原則：代碼絕不硬編碼 JNDI 名稱，僅引用 java:comp/env/... 邏輯名，部署時綁定到具體物理名。

代碼層：邏輯引用

Context ctx = new InitialContext();
AccountHome home = (AccountHome) PortableRemoteObject.narrow(
    ctx.lookup("java:comp/env/ejb/Account"),  // 邏輯名
    AccountHome.class
);

部署層：綁定配置

<!-- ejb-jar.xml 環境項聲明 -->
<session>
    <ejb-name>Transfer</ejb-name>
    <env-entry>
        <env-entry-name>AccountServiceLocatorClassName</env-entry-name>
        <env-entry-type>java.lang.String</env-entry-type>
        <env-entry-value>com.ibm.mybank.service.v1.AccountServiceLocator</env-entry-value>
    </env-entry>
</session>

<!-- ibm-ejb-jar-bnd.xmi 綁定到具體 JNDI -->
<ejbBinding xmi:id="..." jndiName="ejb/MyBank/v1/Account"/>

版本化 JNDI 命名規範

4. 外部資源衝突 — DataSource 版本化綁定

• 不同版本實體 Bean 可能對應不同數據庫 Schema
• 代碼引用 java:comp/env/jdbc/MyBankDB
• 部署時綁定到具體 DataSource：jdbc/MyBankDB_v1 / jdbc/MyBankDB_v2
• 避免多版本同時修改同一張表 → 數據不一致風險

應用程序設計原則：接口版本化與包隔離

包結構版本化策略

com.ibm.mybank.ejb              ← 版本無關的基礎接口 (Account, Transfer)
com.ibm.mybank.ejb.v1           ← 版本 1 專用實現 (AccountBeanV1, AccountKeyV1)
com.ibm.mybank.ejb.v2           ← 版本 2 專用實現 (AccountBeanV2, AccountKeyV2)
com.ibm.mybank.service.v1       ← 版本 1 ServiceLocator 實現
com.ibm.mybank.web.v1           ← 版本 1 Web 組件 (CreateAccountServletV1)

接口演進最佳實踐

1. 基礎接口不變：Account 接口保持穩定，Transfer 依賴它
2. 版本接口擴展：AccountV2 extends Account 添加 getAccountHolderName()
3. 值對象版本化：AccountInfoV2 新增字段，舊版本不受影響
4. Service Locator 隔離版本差異：AccountServiceLocator 接口 + v1/v2 實現

封裝策略：從粗粒度到細粒度

方案 A：完整 EAR 隔離 (粗粒度，簡單但浪費)

MyBank_v1.ear
├── MyBankCMPEJB.jar
└── MyBankCMPWeb.war

MyBank_v2.ear
├── MyBankCMPEJB.jar
└── MyBankCMPWeb.war

• 優點：部署簡單，類加載天然隔離
• 缺點：未變組件重複打包，無法共享公共組件 (如 Transfer EJB)

方案 B：模塊級拆分 EAR (細粒度，推薦)

EJB 層:
MyBankCMPEJB_v1.ear
├── MyBankCMPEJBv1.jar          (Account v1 實現)
└── MyBankCMPEJBCommonUtility.jar (Transfer EJB + 共享接口/工具類)

MyBankCMPEJB_v2.ear
├── MyBankCMPEJBv2.jar          (Account v2 實現)
└── MyBankCMPEJBCommonUtility.jar (共享，同一份)

Web 層:
MyBankCMPWeb.ear
├── MyBankCMPWebv1.war          (CreateAccount v1)
├── MyBankCMPWebv2.war          (CreateAccount v2)
└── MyBankCMPWebCommon.war      (TransferFunds 等共享 Servlet)

Manifest Class-Path 實現模塊間依賴

# MyBankCMPEJBv1.jar / META-INF/MANIFEST.MF
Manifest-Version: 1.0
Class-Path: MyBankCMPEJBCommonUtility.jar

# MyBankCMPWebv1.war / META-INF/MANIFEST.MF
Manifest-Version: 1.0
Class-Path: MyBankCMPEJBCommonUtility.jar MyBankCMPEJBv1Utility.jar MyBankCMPWebCommonUtil.jar

共享庫替代方案

• 將公共 JAR 配置為 WebSphere Shared Library
• 關聯到應用/模塊，類加載器父層可見，無需 Manifest

分布式組件版本追蹤與兼容性檢查

Manifest 版本屬性

Manifest-Version: 1.0
Name: com/ibm/mybank/ejb/v2/
Specification-Title: "EJB"
Specification-Version: "2.0"
Implementation-Title: "MyBank EJBs"
Implementation-Version: "1.4"

運行時版本檢查代碼

public String getImplVersion() {
    Package p = this.getClass().getPackage();
    return "Server Spec: " + p.getSpecificationTitle() + " " + p.getSpecificationVersion()
         + ", Impl: " + p.getImplementationTitle() + " " + p.getImplementationVersion();
}

// EJB 遠程接口暴露版本信息
public String getVersion() { return getImplVersion(); }

// 客戶端調用檢查兼容性
String serverVersion = accountHome.getVersion();
if (!isCompatible(clientVersion, serverVersion)) {
    throw new VersionMismatchException("Client " + clientVersion + " incompatible with server " + serverVersion);
}

序列化對象版本兼容性

• 遵循 Java Object Serialization Spec：可增欄位、不可刪欄位、保持 serialVersionUID 穩定
• 自定義 readObject/writeObject 處理版本差異
• EJB Stub/Tie 無官方兼容規範 → 強制客戶端/服務端同版本部署

總結：多版本並行部署清單

掌握這套體系，讓你的 J2EE 應用實現平滑演進、灰度發布、版本回滾，真正做到「增量升級，業務零中斷」。