关联任务

https://atomgit.com/opengauss/opensource-intership/issues/52

变更内容

• 新增 DBCP2 2.9.0 + MySQL Connector/J 8.0.28 连接 openGauss B 兼容库的示例。
• 新增数据库初始化脚本、连接池配置、DAO 和 CRUD 示例。
• 新增测试思维导图和自测报告。
• 测试覆盖连接池参数、满池等待、CRUD、事务、并发、断连恢复和 DDL/DML/DQL/DCL/TCL。

连接链路

dbcp.properties
  → BasicDataSourceFactory
  → BasicDataSource.getConnection()
  → GenericObjectPool.borrowObject()
  → PoolableConnectionFactory.makeObject()（无空闲连接时）
  → DriverConnectionFactory.createConnection()
  → com.mysql.cj.jdbc.Driver.connect()
  → com.mysql.cj.jdbc.ConnectionImpl
  → TCP / Dolphin MySQL 协议端口
  → openGauss B 兼容库
  → ResultSet 或 updateCount
  → PoolableConnection.close()
  → GenericObjectPool.returnObject()

DBCP 负责逻辑连接的借出、校验和归还；池中没有可复用连接且未达到 maxTotal 时，才调用 Connector/J 创建物理连接。Connector/J 负责 MySQL 协议通信，Dolphin 将请求交给 openGauss 执行。

测试清单

重点边界

• dbcp.properties → TestConfig → BasicDataSourceFactory → BasicDataSource 参数逐项断言。
• maxTotal=8 时，8 条连接分别完成事务 CRUD 并保持占用；第 9 条请求等待且不突破上限，不释放时超时，释放后恢复。
• 16 线程各持有独立连接执行 INSERT → SELECT → UPDATE → SELECT → DELETE → COMMIT，结束 active=0。
• 固定 maxTotal=128 的高负载验证完成 128 条同时持有连接和最多 5000 个排队业务请求；5000 表示请求数，不是物理连接数。
• commit 后数据跨连接可见，rollback 后不可见。
• DDL/DML/DQL/DCL/TCL 分别校验对象状态、影响行数、查询结果、授权状态和事务结果。\n- 46 项回归使用具备 CREATEROLE 权限的 opengauss 测试账号；生产部署应替换为专用业务账号。
• 服务端会话失效后，testOnBorrow 和 testWhileIdle 能淘汰失效连接并恢复查询。

验证结果

测试环境：openEuler 24.03 x86_64、openGauss 7.0.0 master 转测包、Dolphin 127.0.0.1:36443（隔离自测端口；README 默认部署端口为 3308）、BiSheng JDK 8u472、Maven 3.6.3、DBCP2 2.9.0、Pool2 2.10.0、Connector/J 8.0.28。

Tests run: 46, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

另使用 Spring Boot 3.5.7 + HikariCP 6.3.3 + Connector/J 8.0.28 验证默认数据源链路，确认 HikariDataSource → HikariProxyConnection → ConnectionImpl → Dolphin → openGauss，JdbcTemplate CRUD、TransactionTemplate 提交/回滚及连接归还均通过。该结果用于说明 Spring Boot 默认 HikariCP 链路，不计入 DBCP 的 46 个测试方法。

运行方式

mvn clean test \
  -Ddbcp.url='jdbc:mysql://127.0.0.1:36443/mysql_test_db?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC&characterEncoding=utf-8&zeroDateTimeBehavior=CONVERT_TO_NULL' \
  -Ddbcp.username=opengauss \
  -Ddbcp.password="$DBCP_PASSWORD"

完整初始化、配置和验证说明见本 PR 的 README.md、docs/初始化步骤.md 和 docs/自测报告.md。

关联 PR

• docs：https://gitcode.com/opengauss/docs/merge_requests/8775