WebLogic EJB 遷移至 JBoss 完整實戰：從 Oracle 到 MySQL 的零代碼修改部署指南

商業應用伺服器 WebLogic 功能強大但授權昂貴。開源 JBoss (WildFly) 提供完整 Java EE 認證，是遷移首選。本文以「Catalog 實體 EJB + Oracle → MySQL」為例，詳細演示**僅修改部署描述檔、資料源配置、登入模組**即可完成遷移，EJB 業務邏輯代碼**零修改**。

遷移前置準備

1. 下載 MySQL JDBC 驅動 (`mysql-connector-java-x.x.x.jar`) 複製至 `/server/default/lib/`。
2. 安裝 MySQL Server，建立資料庫 `test` (或自定)。
3. 下載 JBoss 4.0 (或 WildFly 現代版本)。

JBoss 資料源與安全配置

1. MySQL 資料源 (mysql-ds.xml)

<?xml version="1.0" encoding="UTF-8"?>
<datasources>
  <local-tx-datasource>
    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://localhost/test</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>root</user-name>
    <password></password>
    <metadata>
      <type-mapping>mySQL</type-mapping> <!-- 對應 standardjbosscmp-jdbc.xml 型別映射 -->
    </metadata>
  </local-tx-datasource>
</datasources>

放置於 `/server/default/deploy/`，啟動自動部署。

2. 登入模組 (login-config.xml)

<application-policy name="MySqlDbRealm">
  <authentication>
    <login-module code="org.jboss.resource.security.ConfiguredIdentityLoginModule" flag="required">
      <module-option name="principal"></module-option>
      <module-option name="userName">root</module-option>
      <module-option name="password"></module-option>
      <module-option name="managedConnectionFactoryName">jboss.jca:service=LocalTxCM,name=MySqlDS</module-option>
    </login-module>
  </authentication>
</application-policy>

3. 取得連線 (驗證配置)

InitialContext ctx = new InitialContext();
DataSource ds = (DataSource) ctx.lookup("java:/MySqlDS");
Connection conn = ds.getConnection(); // 成功即配置正確

部署描述檔轉換矩陣

XSLT 自動化轉換策略

編寫 `jboss.xslt` 將 `weblogic-ejb-jar.xml` → `jboss.xml`，`jbosscmp.xslt` 將 `weblogic-cmp-rdbms-jar.xml` → `jbosscmp-jdbc.xml`。核心模板規則：

META-INF/
  ejb-jar.xml          (標準，已調整 multiplicity)
  jboss.xml            (轉換自 weblogic-ejb-jar.xml)
  jbosscmp-jdbc.xml    (轉換自 weblogic-cmp-rdbms-jar.xml)
CatalogBean.class
Catalog.class          (Remote Interface)
CatalogHome.class      (Home Interface)