JBuilder 2005 + JBoss 4.0 + Oracle 9i 企業級 J2EE 開發環境搭建實戰

雖然技術棧已歷史久遠，但該環境搭建過程體現了 Java EE 開發環境的核心要素：JDK、應用伺服器、資料庫、IDE 整合、資料源配置與部署驗證。本文梳理標準化搭建流程，供維護舊系統或理解演進歷程參考。

環境版本規劃

步驟 1：JDK 安裝與環境變數

1. 執行 j2sdk-1_4_2_06-Windows-i586-p.exe，安裝至 D:\j2sdk1.4.2_06
2. 系統環境變數：

   JAVA_HOME=D:\j2sdk1.4.2_06
   JBOSS_HOME=D:\jboss4.0
   Path=%JAVA_HOME%\bin;%JBOSS_HOME%\bin;%Path%
   

步驟 2：JBoss 安裝與資料源配置

2.1 解壓安裝

解壓 jboss-4.0.1RC1.zip 至 D:\jboss4.0

2.2 Oracle JDBC 驅動部署

複製 classes12.zip (JDK 1.4 對應) 至 $JBOSS_HOME/server/default/lib/

2.3 資料源配置檔部署

• 事務型資料源：複製 $JBOSS_HOME/docs/examples/jca/oracle-xa-ds.xml 至 $JBOSS_HOME/server/default/deploy/
• 非事務型：複製 oracle-ds.xml

2.4 修改 oracle-ds.xml

<datasources>
  <local-tx-datasource>
    <jndi-name>OracleDS</jndi-name>
    <connection-url>jdbc:oracle:thin:@localhost:1521:oradb</connection-url>
    <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
    <user-name>hrms</user-name>
    <password>hrms</password>
    <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
    <metadata>
      <type-mapping>Oracle9i</type-mapping>
    </metadata>
  </local-tx-datasource>
</datasources>

關鍵點：connection-url 格式 thin:@host:port:SID，type-mapping 需匹配資料庫版本。

步驟 3：JBuilder 整合 JBoss

1. Tools → Configure Servers
2. 選擇 JBoss 3+，勾選 Enable server
3. Home Directory 指向 D:\jboss4.0
4. JDK 選擇 1.4.2_06

步驟 4：建立測試 Web 應用驗證連線

4.1 目錄結構

$JBOSS_HOME/server/default/deploy/db_test.war/
├── index.jsp
└── WEB-INF/
    ├── web.xml
    └── jboss-web.xml

4.2 index.jsp 測試程式碼

<%@ page import="java.sql.*, javax.sql.DataSource, javax.naming.InitialContext" %>
<%@ page contentType="text/html; charset=GBK" %>
<h3>測試 JBoss 連接 Oracle 9i 資料庫</h3>
<%
    InitialContext ctx = new InitialContext();
    DataSource ds = (DataSource) ctx.lookup("java:/OracleDS");
    Connection conn = ds.getConnection();
    Statement stmt = conn.createStatement();
    ResultSet rs = stmt.executeQuery("SELECT TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') FROM DUAL");
    while (rs.next()) {
        out.println(rs.getString(1) + "<br>");
    }
    conn.close();
%>

4.3 web.xml

<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
    "https://java.sun.com/dtd/web-app_2_3.dtd">
<web-app></web-app>

4.4 jboss-web.xml

<jboss-web></jboss-web>

步驟 5：啟動驗證

1. 啟動 JBoss：$JBOSS_HOME/bin/run.bat
2. 瀏覽器訪問 https://localhost:8080/db_test
3. 顯示資料庫當前時間即成功

常見問題排查

現代化遷移建議

• JDK → 11/17/21 LTS
• JBoss → WildFly / JBoss EAP
• Oracle 9i → 19c/21c/23c
• JBuilder → IntelliJ IDEA / Eclipse / VS Code
• 資料源配置 → 標準化 standalone.xml / domain.xml
• 建構工具 → Maven / Gradle

總結

經典三層架構（IDE + AS + DB）環境搭建的核心邏輯不變：JDK 基礎 → AS 運行時 → DB 驅動與資料源 → IDE 整合 → 部署驗證。掌握此流程有助於理解現代容器化、雲原生部署的本質——只是將各組件標準化、映像化、編排化而已。