JdbcTemplate中queryForObject的空结果或不正确结果数量问题

最新推荐文章于 2022-03-22 17:23:49 发布

原创最新推荐文章于 2022-03-22 17:23:49 发布 · 1.7k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java #数据库

spring 专栏收录该内容

3 篇文章

订阅专栏

本文详细解析了在使用Spring JdbcTemplate的queryForObject方法时可能遇到的异常：EmptyResultDataAccessException和IncorrectResultSizeDataAccessException，并提供了避免这些异常的方法。

在使用Spring提供的JdbcTemplate中名为queryForObject API进行数据库查询时有时会抛出如下异常提示息，org.springframework.dao.EmptyResultDataAccessException: Incorrect result size: expected 1, actual 0 或者 org.springframework.dao.IncorrectResultSizeDataAccessException: Incorrect result size: expected 1, actual 2

在解决这些异常之前，我们首先来看看queryForObject API的源代码，假设我们调用的是queryForObjec(String sql, Class requiredType)。

JdbcTemplate.class


public <T> T queryForObject(String sql, Class<T> requiredType) 
		throws DataAccessException 
{return queryForObject(sql, getSingleColumnRowMapper(requiredType));}

public <T> T queryForObject(String sql, RowMapper<T> rowMapper) 
		throws DataAccessException {
    List<T> results = query(sql, rowMapper);
    return DataAccessUtils.requiredSingleResult(results);
}

public <T> List<T> query(String sql, RowMapper<T> rowMapper) 
		throws DataAccessException {
    return query(sql, new RowMapperResultSetExtractor<T>(rowMapper));
}

public <T> T query(final String sql, final ResultSetExtractor<T> rse) 
		throws DataAccessException {
	Assert.notNull(sql, "SQL must not be null");
	Assert.notNull(rse, "ResultSetExtractor must not be null");
	if (logger.isDebugEnabled()) {
		logger.debug("Executing SQL query [" + sql + "]");
	}
	class QueryStatementCallback implements StatementCallback<T>, SqlProvider {
		public T doInStatement(Statement stmt) throws SQLException {
			ResultSet rs = null;
			try {
				rs = stmt.executeQuery(sql);
				ResultSet rsToUse = rs;
				if (nativeJdbcExtractor != null) {
					rsToUse = nativeJdbcExtractor.getNativeResultSet(rs);
				}
				return rse.extractData(rsToUse);
			}
			finally {
				JdbcUtils.closeResultSet(rs);
			}
		}
		public String getSql() {
			return sql;
		}
	}
	return execute(new QueryStatementCallback());
}

DataAccessUtils.class


public static <T> T requiredSingleResult(Collection<T> results) 
		throws IncorrectResultSizeDataAccessException {
	int size = (results != null ? results.size() : 0);
	if (size == 0) {
		throw new EmptyResultDataAccessException(1);
	}
	if (results.size() > 1) {
		throw new IncorrectResultSizeDataAccessException(1, size);
	}
	return results.iterator().next();
}

通过阅读源代码，可以很清楚看到在DataAccessUtils.class中requiredSingleResult方法中，当结果集合的size为0或者大于1时，就会抛出以上两个异常。

为了避免出现以上的异常，最好还是使用queryForList API，即使返回的结果集合的size为0，即Zero Row，也不会抛出异常。如果size不为0，即可以使用get(0)取得第一个查询对象。