JBuilder 2005 開發 Web 應用實戰：Tomcat + DBCP 連接池 + SQL Server

JBuilder 2005 整合 Tomcat、WebLogic 等伺服器，但 Tomcat 設定較繁瑣。本文以「建立 Web 專案 → 配置 DBCP 連接池 → 開發 JSP/Service → 部署 WAR」為主線，給出完整步驟、關鍵配置檔 (web.xml, server.xml, context.xml) 與常見問題解答，助你快速上手企業級 Web 開發。

環境版本

• JDK: 1.4.2_04 (JBuilder 內建)
• Tomcat: 5.0.27 (JBuilder 內建，目錄 thirdparty/jakarta-tomcat-5.0.27)
• 資料庫: MS SQL Server 2000
• JDBC 驅動: JSQL Connect (JDBC 3.0，com.jnetdirect.jsql.JSQLDriver)

開發步驟總覽

1. 新建專案：File → New Project，名稱 myWeb，目錄 C:\myWeb。
2. 設定伺服器：Project → Project Properties，選 Tomcat。
3. 新建 Web Module (WAR)：File → New → Web Module，名稱 DBTest。
4. 建立 JSP：test.jsp，調用 foo.DBTest 類別顯示資料。
5. 建立 Service 類別：foo.DBTest，透過 JNDI 查找 java:comp/env/jdbc/TestDB 獲取 DataSource，查詢 testdata 表。
6. 配置 web.xml：宣告 resource-ref，名稱 jdbc/TestDB，類型 javax.sql.DataSource，認證 Container。
7. 啟動測試 (F9)：JBuilder 生成 Tomcat 實例配置於 myWeb/Tomcat/conf，Tomcat_HOME/conf/Catalina/localhost 生成 DBTest.xml。
8. 修改 server.xml：將 myWeb/Tomcat/conf/server8080.xml 加入專案，配置 Context 與 ResourceParams 定義 DBCP 連接池參數 (maxActive=100, maxIdle=30, maxWait=10000, driverClassName, url, username, password)。
9. 放置 JDBC 驅動：JSQLConnect.jar 放入 Tomcat_HOME/common/lib。
10. 建立資料庫表與測試資料：執行 creatTable.sql 建立 testdata(id, foo, bar) 並插入測試行。
11. 運行驗證：瀏覽器訪問 https://localhost:8080/DBTest/test.jsp。

關鍵配置檔詳解

web.xml (片段)

<resource-ref>
  <description>DB Connection</description>
  <res-ref-name>jdbc/TestDB</res-ref-name>
  <res-type>javax.sql.DataSource</res-type>
  <res-auth>Container</res-auth>
</resource-ref>

server8080.xml Context 區段 (核心 DBCP 配置)

<Context path="/DBTest" docBase="C:\myWeb\DBTest" debug="5" reloadable="true" crossContext="true" workDir="C:\myWeb\Tomcat\work\DBTest">
  <Resource name="jdbc/TestDB" auth="Container" type="javax.sql.DataSource"/>
  <ResourceParams name="jdbc/TestDB">
    <parameter><name>factory</name><value>org.apache.commons.dbcp.BasicDataSourceFactory</value></parameter>
    <parameter><name>maxActive</name><value>100</value></parameter>
    <parameter><name>maxIdle</name><value>30</value></parameter>
    <parameter><name>maxWait</name><value>10000</value></parameter>
    <parameter><name>username</name><value>sa</value></parameter>
    <parameter><name>password</name><value>topcomputer</value></parameter>
    <parameter><name>driverClassName</name><value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value></parameter>
    <parameter><name>url</name><value>jdbc:microsoft:sqlserver://nt04:1433;DatabaseName=test</value></parameter>
  </ResourceParams>
</Context>

部署生產環境 (WAR 部署)

1. 專案屬性啟用 Build Web archive 生成 DBTest.war。
2. 複製 DBTest.war 至 Tomcat_HOME/webapps。
3. 在 Tomcat_HOME/conf/Catalina/localhost 建立 DBTest.xml，內容同 server8080.xml 中的 Context 區段。
4. 啟動 Tomcat，WAR 自動解壓至 webapps/DBTest，工作目錄生成於 work/Catalina/localhost/DBTest。

常見問題 FAQ

• 無法生成 WAR？ 檢查 Web Module Properties → Build → Build Web archive 是否勾選。
• 如何加入任意類型檔案進 WAR？ 複製檔案到模組目錄，Properties → Content → 勾選 include all classes and resources。
• 如何切換 JDK/Tomcat 版本？ Tools → Configure JDKs 新增路徑；Enterprise → Configure Servers 複製 Tomcat 並修改 Home Directory；專案屬性中選擇新增的 JDK/Server。
• 啟動腳本：提供 startup.bat/shutdown.bat 直接啟動獨立 Tomcat 實例 (指定 -config server8080.xml)，便於非 IDE 環境測試。

掌握 JBuilder 整合 Tomcat 的配置脈絡，DBCP 連接池參數調優，與 WAR 部署流程，即可在 IDE 與生產環境間無縫切換，高效交付 Web 應用。