快捷導(dǎo)航

jdbcTemplate.query和queryForObject方法的使用及區(qū)別

更新時(shí)間：2025年12月30日 10:49:46 作者：碼農(nóng)辰南

這篇文章主要分析了Spring框架中JdbcTemplate的query()和queryForObject()方法的區(qū)別,并提出了一些建議來(lái)避免在查詢(xún)時(shí)出現(xiàn)權(quán)限不足的問(wèn)題

一、問(wèn)題原因

上周再項(xiàng)目上遇到一個(gè)信息集權(quán)限不足時(shí)，輸出word功能中報(bào)錯(cuò)，查看代碼發(fā)現(xiàn)該塊查詢(xún)邏輯直接使用了jdbcTemplate.queryForObject，根本沒(méi)考慮信息集權(quán)限不足的情況，會(huì)出現(xiàn)查詢(xún)不到數(shù)據(jù)導(dǎo)致報(bào)錯(cuò)的問(wèn)題，下面就針對(duì)query() 和 queryForObject()做一下分析。

二、query() 和 queryForObject() 區(qū)別

JdbcTemplate 的 query() 和 queryForObject() 是 Spring 中操作數(shù)據(jù)庫(kù)最常用的兩個(gè)查詢(xún)方法，核心區(qū)別在于返回結(jié)果形態(tài)、空結(jié)果處理、適用場(chǎng)景，以下是詳細(xì)對(duì)比：

特性	jdbcTemplate.query()	jdbcTemplate.queryForObject()
返回值類(lèi)型	List（多條結(jié)果，無(wú)結(jié)果則返回空 List）	T（單條結(jié)果，必須返回且僅返回 1 條）
空結(jié)果處理	無(wú)匹配數(shù)據(jù)時(shí)返回空 List（[]），不拋異常	無(wú)匹配數(shù)據(jù)時(shí)拋 EmptyResultDataAccessException
多結(jié)果處理	支持 0 條、1 條、多條結(jié)果	僅支持恰好 1 條結(jié)果，多條則拋 IncorrectResultSizeDataAccessException
核心參數(shù)	需指定 RowMapper/ResultSetExtractor 映射結(jié)果	需指定 RowMapper/ 返回類(lèi)型（如 Integer.class）
適用場(chǎng)景	批量查詢(xún)（列表查詢(xún)）、允許無(wú)結(jié)果的單條查詢(xún)	明確僅需 1 條結(jié)果的場(chǎng)景（如根據(jù)唯一 ID 查單條數(shù)據(jù)）

三、修改建議

1、使用JdbcTemplate.query()替換 JdbcTemplate.queryForObject()

BeanPropertyRowMapper<Person> rowMapper = new BeanPropertyRowMapper<>(Person.class);
String sql = "select * from person where personId = '12'";
//下面這段代碼有問(wèn)題，當(dāng)personId中12不存在，則會(huì)報(bào)異常EmptyResultDataAccessException
//Person person = jdbcTemplate.queryForObject(sql, rowMapper);
//使用query替換queryForObject
List<Person> query = jdbcTemplate.query(sql, rowMapper);
if(query != null){
   Person person = query.get(0);
}

2、使用mybatis替換 JdbcTemplate.queryForObject()

//BeanPropertyRowMapper<Person> rowMapper = new BeanPropertyRowMapper<>(Person.class);
String sql = "select * from person where personId = '12'";
//下面這段代碼有問(wèn)題，當(dāng)personId中12不存在，則會(huì)報(bào)異常EmptyResultDataAccessException
//Person person = jdbcTemplate.queryForObject(sql, rowMapper);
//使用mybatis替換queryForObject，mybatis查詢(xún)不到數(shù)據(jù)會(huì)返回null
Person person = rmbReportMapper.queryPersonBySql(sql);

四、總結(jié)

query() 是 “通用查詢(xún)”，靈活處理任意條數(shù)結(jié)果，無(wú)異常風(fēng)險(xiǎn)；
queryForObject() 是 “單結(jié)果查詢(xún)”，強(qiáng)約束結(jié)果數(shù)量，適合明確僅需 1 條的場(chǎng)景；
日常開(kāi)發(fā)中，除非確認(rèn)數(shù)據(jù)必存在，否則優(yōu)先用 query()處理單條查詢(xún)，避免空結(jié)果異常。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: