package com.example.db;
import java.sql.Connection;
import java.sql.SQLException;
import oracle.jdbc.pool.OracleConnectionCacheImpl;
public final class DBPool {
// 單例模式 (雙重檢查鎖)
private static volatile DBPool INSTANCE;
private final OracleConnectionCacheImpl cache;
private DBPool(String url, String user, String password,
int minLimit, int maxLimit, int initialLimit) throws SQLException {
cache = new OracleConnectionCacheImpl();
cache.setURL(url);
cache.setUser(user);
cache.setPassword(password);
cache.setMinLimit(minLimit);
cache.setMaxLimit(maxLimit);
cache.setInitialLimit(initialLimit);
// 緩存策略:動態擴縮容
cache.setCacheScheme(OracleConnectionCacheImpl.DYNAMIC_SCHEME);
// 可選:FIXED_RETURN_NULL_SCHEME (滿時返回 null) / FIXED_WAIT_SCHEME (滿時等待)
// 連接屬性優化
java.util.Properties props = new java.util.Properties();
props.setProperty("oracle.net.CONNECT_TIMEOUT", "10000"); // 10秒連接超時
props.setProperty("oracle.jdbc.ReadTimeout", "30000"); // 30秒讀取超時
props.setProperty("oracle.jdbc.autoCommitSpecCompliant", "false"); // 性能優化
cache.setConnectionProperties(props);
}
public static DBPool getInstance(String url, String user, String password,
int min, int max, int initial) throws SQLException {
if (INSTANCE == null) {
synchronized (DBPool.class) {
if (INSTANCE == null) {
INSTANCE = new DBPool(url, user, password, min, max, initial);
}
}
}
return INSTANCE;
}
public Connection getConnection() throws SQLException {
return cache.getConnection();
}
public void shutdown() {
if (cache != null) {
try { cache.close(); } catch (SQLException ignore) {}
}
}
// 監控指標
public int getActiveCount() { return cache.getActiveSize(); }
public int getCachedCount() { return cache.getCacheSize(); }
public int getMaxLimit() { return cache.getMaxLimit(); }
public int getMinLimit() { return cache.getMinLimit(); }
public void printStats() {
System.out.printf("DBPool Stats: Active=%d, Cached=%d, Min=%d, Max=%d%n",
getActiveCount(), getCachedCount(), getMinLimit(), getMaxLimit());
}
}
@Configuration
public class OraclePoolConfig {
@Bean(destroyMethod = "shutdown")
public DBPool dbPool(@Value("${jdbc.url}") String url,
@Value("${jdbc.user}") String user,
@Value("${jdbc.password}") String password,
@Value("${pool.min:5}") int min,
@Value("${pool.max:20}") int max,
@Value("${pool.initial:10}") int initial) throws SQLException {
return DBPool.getInstance(url, user, password, min, max, initial);
}
@Bean
public DataSource dataSource(DBPool dbPool) {
return new DataSource() {
@Override public Connection getConnection() throws SQLException { return dbPool.getConnection(); }
@Override public Connection getConnection(String u, String p) throws SQLException { throw new UnsupportedOperationException(); }
// 其他 DataSource 方法拋出 UnsupportedOperationException
};
}
}
@Repository
public class UserDao {
private final DataSource dataSource;
public UserDao(DataSource dataSource) { this.dataSource = dataSource; }
public User findById(Long id) {
String sql = "SELECT id, username, email FROM users WHERE id = ?";
try (Connection conn = dataSource.getConnection();
PreparedStatement ps = conn.prepareStatement(sql)) {
ps.setLong(1, id);
try (ResultSet rs = ps.executeQuery()) {
if (rs.next()) {
return new User(rs.getLong("id"), rs.getString("username"), rs.getString("email"));
}
}
} catch (SQLException e) {
throw new DataAccessException("Query failed", e);
}
return null;
}
}
Oracle JDBC 11.1+ 支援 **隱式連接緩存** (Implicit Connection Cache),比 `OracleConnectionCacheImpl` 更強大:
// 啟用隱式緩存 (JVM 級全局)
System.setProperty("oracle.jdbc.implicitStatementCacheSize", "100");
System.setProperty("oracle.jdbc.implicitConnectionCache", "true");
// DataSource 方式
OracleDataSource ods = new OracleDataSource();
ods.setURL(url);
ods.setUser(user);
ods.setPassword(password);
ods.setConnectionCachingEnabled(true);
ods.setConnectionCacheProperties(props); // 包含 MinLimit, MaxLimit 等
// 獲取連接自動使用緩存
Connection conn = ods.getConnection();
**優勢**:支援 `Fast Connection Failover (FCF)`、運行時負載均衡、語句緩存、連接屬性標記/重用。
| 指標 | 獲取方式 | 告警閾值建議 |
|---|---|---|
| 活躍連接數 | `cache.getActiveSize()` | > 80% MaxLimit 持續 5 分鐘 |
| 緩存連接數 | `cache.getCacheSize()` | 長期 << MinLimit 表示配置過大 |
| 連接獲取耗時 | 埋點統計 `getConnection()` 耗時 | > 500ms |
| 語句緩存命中率 | `V$SESSTAT: session cursor cache hits / (hits+misses)` | < 90% |
| 現象 | 原因 | 解決 |
|---|---|---|
| 獲取連接極慢 / 拋出 Timeout | 連接池耗盡、資料庫負載高、網路延遲 | 擴大 MaxLimit、優化慢 SQL、檢查網路、啟用連接獲取超時 |
| ORA-01000: maximum open cursors exceeded | Statement Cache 過大或未關閉 ResultSet | 減小 `maxOpenPreparedStatements`、確保 try-with-resources |
| 連接洩漏 (Active 持續增長) | 代碼路徑未關閉 Connection | 強制使用 try-with-resources、啟用 `removeAbandoned`、代碼審查 |
| RAC 節點故障連接不自動切換 | 未啟用 FCF/ONS | 配置 `ons.config`、啟用 `FastConnectionFailoverEnabled=true` |
`OracleConnectionCacheImpl` 提供開箱即用的原生連接池,配合單例封裝、動態擴縮容、監控指標暴露,可滿足多數中小型應用需求。大型關鍵業務建議升級至 **隱式連接緩存** 或 **HikariCP** (配合 `oracle.jdbc.implicitStatementCacheSize`),獲得更豐富的運維功能與社區支援。