JBoss 3.0 + Tomcat 4.0.6 整合 MySQL 數據源配置實戰

JBoss 3.x 時代經典架構：JBoss 管理 Tomcat Servlet 容器，通過 JCA 數據源配置實現 MySQL 連接池，供 EJB/Web 應用共享。

一、Tomcat 端口調整

# 文件：$JBOSS_HOME/server/default/deploy/tomcat4-service.xml
  

二、Web 應用部署 (WAR 熱部署)

# 1. 按 J2EE 規范打包 WAR (含 WEB-INF/web.xml、classes、lib)
# 2. 複製到熱部署目錄
cp myapp.war $JBOSS_HOME/server/default/deploy/
# 3. JBoss 自動展開，日志顯示部署成功
# 4. 訪問 https://host:8080/myapp/ 驗證

三、MySQL 數據源配置 (JCA 連接池)

# 1. 複製模板並修改
cp $JBOSS_HOME/docs/examples/jca/mysql-service.xml $JBOSS_HOME/server/default/deploy/

# 2. 編輯 mysql-service.xml 核心配置

  
    MySQLDS          
    MySQL
    
      jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8
    
    dbuser
    dbpass
    com.mysql.jdbc.Driver
    
    5
    20
    5000
    15
  

四、JDBC 驅動部署

# 複製驅動 jar 到 JBoss 共享庫目錄
cp mysql-connector-java-3.1.14-bin.jar $JBOSS_HOME/server/default/lib/
# 重啟 JBoss 生效

五、JSP/Servlet 中使用數據源

<%@ page import="javax.naming.*,javax.sql.*,java.sql.*" %>
<%
  Context ctx = new InitialContext();
  DataSource ds = (DataSource) ctx.lookup("java:/MySQLDS");  // JNDI 查找
  Connection conn = ds.getConnection();
  try {
    PreparedStatement ps = conn.prepareStatement("SELECT id FROM test");
    ResultSet rs = ps.executeQuery();
    while (rs.next()) out.println(rs.getInt("id") + "
");
    rs.close(); ps.close();
  } finally { conn.close(); }  // 歸還連接池
%>

六、關鍵注意事項

• JNDI 名稱前綴：JBoss 3.x 使用 java:/，非標準 jdbc/
• 事務型連接工廠：tx-connection-factory 支持 JTA 分佈式事務，no-tx-connection-factory 非事務
• 驅動類版本匹配：MySQL Connector/J 3.1.x 對應 MySQL 4.1/5.0，現代版本用 8.0+ 驅動
• 連接池監控：JBoss JMX Console 查看 jboss.jca:name=MySQLDS,service=ManagedConnectionPool 指標

現代化遷移建議

JBoss 3.x (2003 年) 已徹底停止維護。生產環境請遷移至：

• WildFly / JBoss EAP 7.x (Jakarta EE 8/10、Elytron 安全、微服務就緒)
• Spring Boot 3.x + Tomcat 10 / Undertow (自動配置、Actuator 監控、雲原生)
• Quarkus / Micronaut (GraalVM 原生編譯、極速啟動、Kubernetes 原生)