用途:在 Java 项目中编写或审查 Spring JDBC 数据访问代码,覆盖 JdbcClient、JdbcTemplate、NamedParameterJdbcTemplate 的使用规范。
主要能力:参数化 SQL(禁止拼接用户输入);JdbcClient 流式 API(Spring Framework 7+)用于查询与更新;命名参数;RowMapper、query(Class) 与 record 映射;批量操作与生成键(必要时用 JdbcTemplate / JdbcOperations);KeyHolder 安全处理生成键;服务层 @Transactional 边界与只读事务;单行安全访问(optional() / findFirst() 对比 queryForObject);大结果集流式处理(RowCallbackHandler、ResultSetExtractor);DataAccessException 处理(DuplicateKeyException、EmptyResultDataAccessException);@JdbcTest 切片测试配合 @Sql 夹具。
使用方式:先阅读 references/311-frameworks-spring-jdbc.md 并检查项目现状,再按参考规则与正反示例实施最小安全改动。强制流程:改动前运行 ./mvnw compile 或 mvn compile,编译失败立即停止;改动后运行 ./mvnw clean verify 或 mvn clean verify 验证。
适用场景:审查 Spring JDBC 代码、应用最佳实践、检测并修复 SQL 注入风险、改进事务边界与异常处理、审查 Spring Framework 7 中的 JdbcClient 用法。
限制:仅依据参考规则与示例给出建议;未提供具体版本兼容范围、性能数据或收费信息。