Eclipse 3.2 + Tomcat 5.5 + Oracle 9i 整合開發環境建置完整指南

環境版本與前置需求

步驟 1：安裝基礎環境

1. 安裝 JDK，設定 JAVA_HOME、PATH、CLASSPATH 系統變數
2. 解壓 Eclipse 3.2，視需求安裝語言包、MyEclipse/WTP 插件
3. 安裝 Oracle 9i，建立測試環境：
   • 資料庫 SID: NBZJU
   • DBA 用戶: LUHAO/11111 (SYSDBA)
   • 表空間: LUHAO
   • 測試表: USER_INF (USER_ID, USER_NAME, USER_TEL)，插入測試資料

步驟 2：Tomcat 安裝與 Eclipse 整合

1. 下載 apache-tomcat-5.5.17.zip 解壓至 D:\Tomcat5.5
2. 下載 apache-tomcat-5.5.17-admin.zip 解壓合併至上述目錄（獲得圖形化管理介面）
3. 下載 tomcatPluginV31.zip，將 plugins 目錄下檔案複製至 eclipse\plugins
4. 設定系統變數 TOMCAT_HOME=D:\Tomcat5.5
5. 編輯 tomcat-users.xml 新增管理員：

   <user username="luhao" password="12345" roles="admin,manager"/>

6. 編輯 server.xml 修改連接埠避開 Oracle 衝突：

   <Connector port="8008" ... />  <!-- 原 8080 被 Oracle 佔用 -->

7. Eclipse 設定：Window > Preferences > Tomcat
   • Tomcat Version: 5.x
   • Tomcat Home: D:\Tomcat5.5
   • JVM Settings / Source Path: 選擇已設定的 JRE
   • Tomcat Manager App: URL https://localhost:8008/manager，帳號 luhao/12345

步驟 3：JDBC 驅動與資料源配置（關鍵步驟）

1. 複製 Oracle JDBC 驅動：%ORACLE_HOME%\ora90\jdbc\lib\classes12.jar → %TOMCAT_HOME%\common\lib\
2. 啟動 Tomcat（Eclipse 中點擊貓咪圖示）
3. 瀏覽器開啟 https://localhost:8008/admin，以 luhao/12345 登入
4. 新增資料源（Data Source）：
   • JNDI Name: jdbc/Oracle
   • Data Source URL: jdbc:oracle:thin:@localhost:1521:NBZJU
   • JDBC Driver Class: oracle.jdbc.driver.OracleDriver
   • Username: luhao / Password: 11111
5. 儲存後，server.xml 會自動生成 <Resource> 定義
6. 編輯 context.xml 加入資源連結：

   <ResourceLink global="jdbc/Oracle" name="jdbc/Oracle" type="javax.sql.DataSource"/>

步驟 4：建立測試 Web 專案

1. Eclipse 新建 Tomcat Project：quickstart
2. 專案建立後，server.xml 自動新增 <Context path="/quickstart" docBase="..."/>
3. 新增 index.jsp 測試頁（需 WTP/MyEclipse 支援）：

<%@ page contentType="text/html; charset=gb2312" import="javax.naming.*,javax.sql.*,java.sql.*" %>
<html><head><title>Oracle JDBC Test</title></head><body>
<%
    Connection conn = null;
    Statement stmt = null;
    ResultSet rs = null;
    try {
        Context initCtx = new InitialContext();
        DataSource ds = (DataSource)initCtx.lookup("java:comp/env/jdbc/Oracle");
        if (ds != null) {
            out.println("已獲得 DataSource: " + ds + "<br>");
            conn = ds.getConnection();
            if (conn != null) {
                out.println("建立連線成功!<br>");
                stmt = conn.createStatement();
                rs = stmt.executeQuery("SELECT * FROM LUHAO.USER_INF");
                out.println("<table border=1><tr><th>ID</th><th>Name</th><th>Tel</th></tr>");
                while (rs.next()) {
                    out.println("<tr><td>" + rs.getString(1) + "</td><td>" + rs.getString(2) + "</td><td>" + rs.getString(3) + "</td></tr>");
                }
                out.println("</table>");
            }
        }
    } catch (Exception e) {
        out.println("錯誤: " + e.toString());
        e.printStackTrace();
    } finally {
        try { if (rs != null) rs.close(); } catch (Exception ignored) {}
        try { if (stmt != null) stmt.close(); } catch (Exception ignored) {}
        try { if (conn != null) conn.close(); } catch (Exception ignored) {}
    }
%>
</body></html>

步驟 5：啟動測試驗證

1. 啟動 Oracle：SQLPLUS /NOLOG → CONN LUHAO/11111 AS SYSDBA → STARTUP
2. Eclipse 啟動 Tomcat（貓咪圖示）
3. 瀏覽器訪問 https://localhost:8008/quickstart/
4. 成功指標：顯示「已獲得 DataSource」、「建立連線成功」及完整 USER_INF 表格資料

替代方案：專案級資料源配置

若不想修改 Tomcat 全域設定，可在專案 META-INF/context.xml 定義：

<Context>
  <Resource name="jdbc/Oracle" auth="Container" type="javax.sql.DataSource"
           maxActive="4" maxIdle="2" maxWait="5000"
           username="luhao" password="11111"
           driverClassName="oracle.jdbc.driver.OracleDriver"
           url="jdbc:oracle:thin:@localhost:1521:NBZJU"/>
</Context>

此法隔離性更好，適合多專案共用 Tomcat 但資料源不同的場景。

常見坑點排查

• Port 8080 衝突：Oracle HTTP Server 預設佔用，必須改 Tomcat 埠口
• classes12.jar 版本不符：必須與 Oracle 客戶端版本一致，否則 ClassNotFoundException 或 Invalid column type
• java:comp/env/ 前綴漏寫：JNDI 查找名稱必須完整
• Oracle 未啟動：測試前確認 LSNRCTL STATUS 及 STARTUP
• Eclipse 插件缺失：無 WTP/MyEclipse 時 JSP 編輯無語法高亮、無部署支援