Spring Boot 2.7 + MySQL 8.0 实战：别再手动遍历ResultSet了，JdbcTemplate.queryForList() 6种用法一篇搞定

Spring Boot 2.7 MySQL 8.0 实战JdbcTemplate.queryForList() 6种高效用法解析还在为繁琐的JDBC结果集处理而头疼Spring的JdbcTemplate.queryForList()方法可能是你一直在寻找的解决方案。这个看似简单的方法背后隐藏着6种不同的使用姿势每种都能在特定场景下大幅简化你的数据库操作代码。1. 基础环境搭建在开始探索queryForList()的各种用法之前让我们先搭建一个标准的Spring Boot 2.7.4项目环境使用MySQL 8.0.30作为数据库。首先确保你的pom.xml包含以下关键依赖dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version /dependency /dependenciesapplication.properties配置示例spring.datasource.urljdbc:mysql://localhost:3306/demo_db?useSSLfalseserverTimezoneUTC spring.datasource.usernameyour_username spring.datasource.passwordyour_password创建示例表结构CREATE TABLE person ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, age INT NOT NULL, email VARCHAR(100) );2. queryForList()基础用法2.1 返回Map列表的最简形式最基本的queryForList()方法直接执行SQL查询并返回ListMapString, Object其中每个Map代表一行数据public ListMapString, Object getAllPersons() { String sql SELECT * FROM person; return jdbcTemplate.queryForList(sql); }这种方法适合快速查询全表数据但需要注意列名作为Map的key区分大小写需要手动处理类型转换不适合复杂对象映射2.2 返回单列值的列表当你只需要查询单列数据时可以使用指定元素类型的版本public ListString getAllNames() { String sql SELECT name FROM person; return jdbcTemplate.queryForList(sql, String.class); }这种用法特别适合获取ID列表、名称列表等简单场景避免了不必要的对象映射开销。3. 带参数的查询方法3.1 使用可变参数传递查询条件最常用的带参查询方式是利用可变参数(Object... args)public ListMapString, Object getPersonsByNameAndAge(String name, int age) { String sql SELECT * FROM person WHERE name ? AND age ?; return jdbcTemplate.queryForList(sql, name, age); }提示这种参数绑定方式使用了PreparedStatement能有效防止SQL注入。3.2 指定参数类型的查询当需要明确指定参数类型时可以使用带argTypes数组的版本public ListMapString, Object getPersonsByName(String name) { String sql SELECT * FROM person WHERE name ?; Object[] args {name}; int[] argTypes {Types.VARCHAR}; return jdbcTemplate.queryForList(sql, args, argTypes); }这种方法在以下场景特别有用参数类型自动推断不准确时需要处理NULL值时使用存储过程调用时4. 高级类型映射技巧4.1 直接映射到自定义类型列表queryForList()最强大的功能之一是能直接将结果映射到指定类型的Listpublic ListInteger getPersonIdsByName(String name) { String sql SELECT id FROM person WHERE name ?; return jdbcTemplate.queryForList(sql, Integer.class, name); }对于自定义类型需要确保类型有对应的构造函数或setter方法列名与属性名匹配类型转换支持4.2 完整参数控制的自定义类型映射最完整的参数控制版本结合了参数数组、参数类型和结果类型public ListLocalDate getBirthDatesByName(String name) { String sql SELECT birth_date FROM person WHERE name ?; Object[] args {name}; int[] argTypes {Types.VARCHAR}; return jdbcTemplate.queryForList(sql, args, argTypes, LocalDate.class); }5. 性能优化与最佳实践5.1 各种方法的性能对比方法类型执行效率内存占用适用场景基本Map列表中高快速原型开发单列值列表高低获取简单数据带参Map列表中高条件查询带类型单列高低类型安全查询完整参数控制低中精确控制场景5.2 常见问题解决方案问题1列名与属性名不匹配解决方案1使用SQL别名String sql SELECT person_id AS id, full_name AS name FROM person;解决方案2自定义RowMapperListPerson persons jdbcTemplate.query(sql, new BeanPropertyRowMapper(Person.class));问题2处理NULL值// 使用Optional处理可能为NULL的结果 public ListOptionalString getAllEmails() { String sql SELECT email FROM person; return jdbcTemplate.queryForList(sql, String.class) .stream() .map(Optional::ofNullable) .collect(Collectors.toList()); }6. 实战案例用户管理系统让我们通过一个完整的用户管理案例展示queryForList()的综合应用。6.1 用户分页查询public ListMapString, Object getUsersByPage(int page, int size) { String sql SELECT id, name, age FROM person LIMIT ? OFFSET ?; int offset (page - 1) * size; return jdbcTemplate.queryForList(sql, size, offset); }6.2 多条件动态查询public ListUser searchUsers(String name, Integer minAge, Integer maxAge) { StringBuilder sql new StringBuilder(SELECT * FROM person WHERE 11); ListObject params new ArrayList(); if (name ! null) { sql.append( AND name LIKE ?); params.add(% name %); } if (minAge ! null) { sql.append( AND age ?); params.add(minAge); } if (maxAge ! null) { sql.append( AND age ?); params.add(maxAge); } return jdbcTemplate.query( sql.toString(), params.toArray(), new BeanPropertyRowMapper(User.class)); }6.3 批量ID查询public ListUser getUsersByIds(ListInteger ids) { String sql SELECT * FROM person WHERE id IN ( ids.stream().map(String::valueOf).collect(Collectors.joining(,)) ); return jdbcTemplate.query(sql, new BeanPropertyRowMapper(User.class)); }在实际项目中我发现对于简单的查询场景queryForList()能减少至少30%的样板代码。特别是在快速原型开发阶段直接使用Map列表可以避免创建大量DTO类的开销。