JDBC 效能監測實戰：以 Wrapper 模式精準剖析資料庫交互瓶頸

JDBC 是 Java 應用存取資料庫的標準介面，但其效能瓶頸往往隱藏在分散的程式碼中。本文提出基於「裝飾模式」的 Wrapper 架構，無侵入式地攔截 Connection、Statement、ResultSet 核心介面，精準測量 SQL 執行時間、資料提取耗時，幫助開發者快速定位效能熱點。

一、核心介面與交互流程

JDBC 核心三介面：Connection (取得連線)、Statement (執行 SQL)、ResultSet (讀取結果)。典型流程：

Connection conn = getConnection();
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM table");
while (rs.next()) { /* 處理資料 */ }

驅動程式廠商提供具體實作 (如 OracleConnection)，標準 API 僅定義介面。

二、Wrapper 架構設計

核心思想：以實作同介面的 Wrapper 類別包裝原始物件，轉發所有方法調用，於關鍵點植入計時邏輯。應用程式僅需在取得連線處替換為 Wrapper，其餘邏輯不變。

1. ConnectionWrapper

• 包裝 Connection，轉發大多數方法
• 關鍵覆寫：createStatement()、prepareStatement()、prepareCall() 回傳對應的 Statement Wrapper
• 提供 getMetaData() 回傳 DatabaseMetaDataWrapper 確保一致性
• 連線池釋放時需解包：if (conn instanceof ConnectionWrapper) conn = ((ConnectionWrapper)conn).realConnection();

2. StatementWrapper 族群

• StatementWrapper 實作 Statement，持有 ConnectionWrapper 參考
• PreparedStatementWrapper 繼承 StatementWrapper 實作 PreparedStatement
• CallableStatementWrapper 繼承 PreparedStatementWrapper 實作 CallableStatement
• 關鍵覆寫：
  • getConnection() 回傳 ConnectionWrapper
  • executeQuery()、executeUpdate()、execute()、executeBatch() 植入計時
  • 處理 Array 物件輸入輸出封裝/解封裝

3. ResultSetWrapper

• 包裝 ResultSet，轉發方法
• getStatement() 回傳 StatementWrapper
• getArray() 回傳 SQLArrayWrapper
• 核心計時點：next() 方法，因大量資料提取時耗時可能超過 SQL 執行本身

4. 輔助 Wrapper

• DatabaseMetaDataWrapper：確保回傳的 Connection 為 Wrapper
• SQLArrayWrapper：包裝 java.sql.Array，確保其 getResultSet() 回傳 Wrapper

三、JDBCLogger 計時實作

使用 ThreadLocal 或 Hashtable 以執行緒為鍵記錄開始時間：

private static Hashtable queryTime = new Hashtable();

public static void startLogSqlQuery(Thread t, String sql) {
    queryTime.put(t, new Long(System.currentTimeMillis()));
}

public static void endLogSqlQuery(Thread t, String sql) {
    long time = System.currentTimeMillis() - ((Long)queryTime.get(t)).longValue();
    System.out.println("Time: " + time + " millis for SQL query " + sql);
    queryTime.remove(t);
}
// 同理實作 startLogSqlNext / endLogSqlNext 監測 ResultSet.next()

輸出範例：Time: 53 millis for SQL query SELECT * FROM JACKTABL

四、架構優勢與應用場景

• 零侵入業務邏輯：僅在連線取得處替換，現有代碼無需修改
• 全版本相容：JDBC 1/2/3 僅介面不同，Wrapper 模式統一適用
• 可配置啟用：生產環境可關閉 Logger，保留 Wrapper 架構以便隨時開啟監測
• 開發期效用：識別高耗時 SQL、重複查詢、N+1 問題，量化理論與實際效能落差

五、後續優化方向

定位瓶頸後，可針對性優化：SQL 調優、索引策略、連線池參數、批次處理、快取機制等。Wrapper 架構為持續效能治理奠定基礎。