DBCP 連線池核心原理與 Struts 1 整合實戰配置詳解

DBCP 連線池核心原理與 Struts 1 整合實戰配置詳解

資料庫連線是昂貴且稀缺的資源，連線池透過預建立、複用、管理連線，顯著提升系統吞吐量與穩定性。本文剖析連線池工作原理，並以 Apache Commons DBCP 為例展示 Struts 1 時代的經典整合配置。

一、連線池三大核心概念

1. 基本概念：池化思想 — 初始化建立最小連線數，上限限制最大連線數，空閒超時回收，請求等待隊列。
2. 工作原理：應用請求連線 → 池中取出可用連線 → 使用完歸還池中 → 供下次複用。避免頻繁建立/關閉連線開銷。
3. 主流開源實現：DBCP (Apache)、C3P0、Proxool、Druid (阿里巴巴)、HikariCP (現代首選)。

二、DBCP 核心組件

• BasicDataSource：最常用的 DataSource 實現，內部依賴 commons-pool 物件池
• 核心參數：
  • driverClassName、url、username、password：資料庫連線四要素
  • initialSize：初始連線數
  • maxActive (maxTotal)：最大連線數
  • maxIdle/minIdle：空閒連線上下限
  • maxWait：獲取連線最長等待時間 (ms)
  • validationQuery：連線驗證 SQL (如 SELECT 1)
  • testOnBorrow/testWhileIdle：借用/空閒時驗證

三、Struts 1 整合 DBCP 完整配置

在 struts-config.xml 中宣告 <data-sources>：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC 
  "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
  "https://struts.apache.org/dtds/struts-config_1_2.dtd">
<struts-config>
  <!-- 配置資料源 -->
  <data-sources>
    <data-source type="org.apache.commons.dbcp.BasicDataSource">
      <set-property property="driverClassName" value="com.mysql.jdbc.Driver" />
      <set-property property="url" value="jdbc:mysql://localhost:3306/demo" />
      <set-property property="username" value="root" />
      <set-property property="password" value="" />
      <set-property property="maxActive" value="10" />
      <set-property property="maxWait" value="5000" />
      <set-property property="defaultAutoCommit" value="false" />
      <set-property property="defaultReadOnly" value="false" />
      <set-property property="validationQuery" value="SELECT COUNT(*) FROM user" />
    </data-source>
  </data-sources>
</struts-config>

四、Action 中獲取連線

public class UserAction extends Action {
    public ActionForward execute(ActionMapping mapping, ActionForm form,
                                 HttpServletRequest request, HttpServletResponse response) {
        DataSource ds = getDataSource(request); // Struts 1 基類提供
        Connection conn = null;
        try {
            conn = ds.getConnection();
            // 業務邏輯...
        } catch (SQLException e) {
            // 異常處理
        } finally {
            if (conn != null) try { conn.close(); } catch (SQLException ignore) {}
        }
        return mapping.findForward("success");
    }
}

五、DBCP vs C3P0 vs 現代選擇

遷移建議：新專案優先選用 HikariCP (Spring Boot 2.x 預設) 或 Druid (國產強監控)，舊專案維護可續用 DBCP/C3P0 但需注意已知 Bug (如 DBCP 1.x 在高併發下可能耗盡連線)。