public interface JdbcOperations
定义 JdbcTemplate 的 API
| Modifier and Type | Method and Description |
|---|---|
BatchUpdateResult |
batchUpdate(String sql,
Collection<Object[]> params,
int batchSize)
批量更新
跑批过程中发生异常即中断操作，并返回结果。
|
BatchUpdateResult |
batchUpdate(String sql,
Collection<Object[]> params,
int batchSize,
boolean quietly)
批量更新
当无法获取所更新的行数时，对应位置的更新行数将被设置为
JdbcOperationSupport.UNKNOWN_COUNT。 |
<T> T |
query(String sql,
Object[] params,
ResultHandler<T> resultHandler)
执行查询，并按照自定义处理逻辑对结果进行处理，将结果转换为指定类型并返回
|
default <T> T |
query(String sql,
ResultHandler<T> resultHandler)
执行查询，并按照自定义处理逻辑对结果进行处理，将结果转换为指定类型并返回
|
default boolean |
queryBoolean(String sql)
查询第一行第一列并转换为 boolean
|
boolean |
queryBoolean(String sql,
Object[] params)
查询第一行第一列并转换为 boolean
|
default Optional<Map<String,Object>> |
queryFirst(String sql)
执行查询，将第一行数据转为 Map<String, Object>
|
default <T> Optional<T> |
queryFirst(String sql,
Class<T> clazz)
查询第一行第一列，并转换为指定类型
|
Optional<Map<String,Object>> |
queryFirst(String sql,
Object[] params)
执行查询，将第一行数据转为 Map<String, Object>
|
<T> Optional<T> |
queryFirst(String sql,
Object[] params,
Class<T> clazz)
查询第一行第一列，并转换为指定类型
|
<T> Optional<T> |
queryFirst(String sql,
Object[] params,
RowMapper<T> rowMapper)
执行查询，将查询结果的第一行数据按照指定逻辑进行处理，返回
Optional |
default <T> Optional<T> |
queryFirst(String sql,
RowMapper<T> rowMapper)
执行查询，将查询结果的第一行数据按照指定逻辑进行处理，返回
Optional |
default List<Map<String,Object>> |
queryList(String sql)
执行查询，每一行数据映射为
Map<String, Object>，返回结果列表 |
default <T> List<T> |
queryList(String sql,
Class<T> clazz)
执行查询，返回结果映射为指定的类型。
|
List<Map<String,Object>> |
queryList(String sql,
Object[] params)
执行查询，每一行数据映射为
Map<String, Object>，返回结果列表 |
<T> List<T> |
queryList(String sql,
Object[] params,
Class<T> clazz)
执行查询，返回结果映射为指定的类型。
|
<T> List<T> |
queryList(String sql,
Object[] params,
RowMapper<T> rowMapper)
执行查询，将查询结果的每一行数据按照指定逻辑进行处理，返回结果列表
|
default <T> List<T> |
queryList(String sql,
RowMapper<T> rowMapper)
执行查询，将查询结果的每一行数据按照指定逻辑进行处理，返回结果列表
|
default int |
update(String sql)
执行更新操作
|
int |
update(String sql,
Object[] params)
执行更新操作
|
<T> List<T> |
updateAndReturnKeys(String sql,
Object[] params,
RowMapper<T> rowMapper)
执行 SQL 并返回生成的 keys
|
default <T> List<T> |
updateAndReturnKeys(String sql,
RowMapper<T> rowMapper)
执行 SQL 并返回生成的 keys
|
<T> T query(String sql, Object[] params, ResultHandler<T> resultHandler) throws SQLException
T - 返回结果类型sql - SQLparams - 参数resultHandler - 结果处理器，用于处理 ResultSetSQLException - SQL异常default <T> T query(String sql, ResultHandler<T> resultHandler) throws SQLException
T - 返回结果类型sql - SQLresultHandler - 结果处理器，用于处理 ResultSetSQLException - SQL异常<T> List<T> queryList(String sql, Object[] params, RowMapper<T> rowMapper) throws SQLException
T - 返回结果列表中每一行数据的类型sql - SQLparams - 参数rowMapper - ResultSet 中每一行的数据的处理逻辑SQLException - SQL 异常<T> List<T> queryList(String sql, Object[] params, Class<T> clazz) throws SQLException
T - 目标类型sql - SQLparams - 参数clazz - 目标类型SQLException - SQL异常List<Map<String,Object>> queryList(String sql, Object[] params) throws SQLException
Map<String, Object>，返回结果列表sql - SQLparams - 参数列表SQLException - SQL 异常default <T> List<T> queryList(String sql, RowMapper<T> rowMapper) throws SQLException
T - 目标类型sql - SQLrowMapper - ResultSet 中每一行的数据的处理逻辑SQLException - SQL 异常default <T> List<T> queryList(String sql, Class<T> clazz) throws SQLException
T - 目标类型sql - SQLclazz - 将结果映射为指定的类型SQLException - SQL 异常default List<Map<String,Object>> queryList(String sql) throws SQLException
Map<String, Object>，返回结果列表sql - SQLSQLException - SQL 异常<T> Optional<T> queryFirst(String sql, Object[] params, RowMapper<T> rowMapper) throws SQLException
OptionalT - 目标类型sql - SQLparams - 参数rowMapper - ResultSet 中每一行的数据的处理逻辑SQLException - SQL 异常<T> Optional<T> queryFirst(String sql, Object[] params, Class<T> clazz) throws SQLException
T - 目标类型sql - SQLparams - 参数clazz - 目标类型SQLException - SQL 异常Optional<Map<String,Object>> queryFirst(String sql, Object[] params) throws SQLException
sql - SQLparams - 参数SQLException - SQL 异常default <T> Optional<T> queryFirst(String sql, RowMapper<T> rowMapper) throws SQLException
OptionalT - 目标类型sql - SQLrowMapper - ResultSet 中每一行的数据的处理逻辑SQLException - SQL 异常default <T> Optional<T> queryFirst(String sql, Class<T> clazz) throws SQLException
T - 目标类型sql - SQLclazz - 目标类型Optional#empty()SQLException - SQL 异常default Optional<Map<String,Object>> queryFirst(String sql) throws SQLException
sql - SQLSQLException - SQL 异常default boolean queryBoolean(String sql) throws SQLException
sql - SQLfalse。SQLException - SQL 异常boolean queryBoolean(String sql, Object[] params) throws SQLException
sql - SQLparams - 参数falseSQLException - SQL 异常int update(String sql, Object[] params) throws SQLException
sql - 要执行的 SQLparams - 参数SQLException - SQL 异常default int update(String sql) throws SQLException
sql - 要执行的 SQLSQLException - 数据库执行异常<T> List<T> updateAndReturnKeys(String sql, Object[] params, RowMapper<T> rowMapper) throws SQLException
T - 映射结果类型sql - 要执行的 SQLparams - 参数rowMapper - 行数据映射逻辑SQLException - 数据库执行异常default <T> List<T> updateAndReturnKeys(String sql, RowMapper<T> rowMapper) throws SQLException
T - 映射结果类型sql - 要执行的 SQLrowMapper - 行数据映射逻辑SQLException - 数据库执行异常BatchUpdateResult batchUpdate(String sql, @Nullable Collection<Object[]> params, int batchSize) throws SQLException
跑批过程中发生异常即中断操作，并返回结果。
当无法获取所更新的行数时，对应位置的更新行数将被设置为 JdbcOperationSupport.UNKNOWN_COUNT。
sql - SQL 语句params - 参数列表batchSize - 每次批量更新的数据量SQLException - SQL 异常BatchUpdateResult batchUpdate(String sql, @Nullable Collection<Object[]> params, int batchSize, boolean quietly) throws SQLException
当无法获取所更新的行数时，对应位置的更新行数将被设置为 JdbcOperationSupport.UNKNOWN_COUNT。
sql - sql语句params - 参数列表batchSize - 每次批量更新的数据量quietly - 静默分批更新。
如果 quietly 为 true，分批更新过程中发生异常不中断操作；
如果 quietly 为 false，分批更新过程中发生异常即中断操作，并返回结果。SQLException - 数据库执行异常Copyright © 2026. All rights reserved.