《SpringBoot 3：入门与应用实战》第 12 章 JDBC 与事务使用 JdbcTemplate 阅读笔记 32-平芜编程栈

《SpringBoot 3：入门与应用实战》第 12 章 JDBC 与事务使用 JdbcTemplate 阅读笔记 32

12.2.2 JdbcTemplate 应用于 Dao 层

虽然已经可以使用 JdbcTemplate 完成对数据的 CRUD 操作，但是目前的代码中有一个非常大的问题：与数据库操作相关的 API 应当集中到 Dao层的 API 中，而不是直接注入 Controller 层。所以下面要做的是将 JdbcTemplate 的使用移入 Dao 层。

模拟一个贴近真实开发环境的代码结构，新建一个 dao 包，并在其中创建一个接口 UserDao，声明 3 个方法。注意，这次只演示了保存操作和查列表、查单条数据的操作，并未涉及全部内容。

publicinterfaceUserDao{voidsave(Useruser);UserfindById(Integerid);List<User>findAll();}

紧接着是 UserDao 的实现类 UserDaoImpl，注意这个实现类上需要使用 @Repository 标注，该注解同样是 @Component 的派生注解，可以被Spring Boot 扫描到并注入进 IOC 容器。

packagecom.yangjunbo.springboot.jdbc.exampleb;importcom.yangjunbo.springboot.jdbc.examplea.User;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.jdbc.core.BeanPropertyRowMapper;importorg.springframework.jdbc.core.JdbcTemplate;importorg.springframework.stereotype.Repository;importjava.util.List;@RepositorypublicclassUserDaoImplimplementsUserDao{@AutowiredprivateJdbcTemplatejdbcTemplate;@Overridepublicvoidsave(Useruser){jdbcTemplate.update("insert into tbl_user (name, tel) values (?, ?)",user.getName(),user.getTel());}@OverridepublicUserfindById(Integerid){List<User>userList=jdbcTemplate.query("select * from tbl_user where id = ?",newBeanPropertyRowMapper<>(User.class),id);returnuserList.size()>0?userList.get(0):null;}@OverridepublicList<User>findAll(){returnjdbcTemplate.query("select * from tbl_user",newBeanPropertyRowMapper<>(User.class));}}

最后在需要操作 tbl_user 表的位置注入 UserDao 即可，不需要再注入 JdbcTemplate 组件。

12.2.3 查询策略

1.queryForList

顾名思义，queryForList 方法的返回值一定是一个 List，借助 IDE 可以发现 JdbcTemplate 中有 7 个重载的 queryForList 方法，这些方法会根据是否传入 elementType 决定返回指定的类型还是 Map，注意 “指定的类型” 这个概念，只有当查询结果只有单列时才可以指定，否则会出现列数过多的异常。

在讲解 select 系列方法中已经介绍过指定类型的方法，代码展示了一个返回 Map<String, Object> 的查询示例，这种查询的方式通常在临时查询一批数据时使用。重新编译代码后访问 /test11 接口，浏览器中得到了数据，与预期相同。

packagecom.yangjunbo.springboot.jdbc.examplea;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.jdbc.core.BeanPropertyRowMapper;importorg.springframework.jdbc.core.JdbcTemplate;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RestController;importjava.util.List;importjava.util.Map;@RestControllerpublicclassJdbcTemplateController{@AutowiredprivateJdbcTemplatejdbcTemplate;@GetMapping("/test1")publicStringtest1(){System.out.println(jdbcTemplate);return"success";}@GetMapping("/test2")publicStringtest2(){Useruser=newUser();user.setName("heihei");user.setTel("200");introw=jdbcTemplate.update("insert into tbl_user (name, tel) values (?, ?)",user.getName(),user.getTel());return"success - "+row;}@GetMapping("/test3")publicStringtest3(){Useruser=newUser();user.setName("heihei");user.setTel("54321");introw=jdbcTemplate.update("update tbl_user set tel = ? where name = ?",user.getTel(),user.getName());return"success - "+row;}@GetMapping("/test4")publicStringtest4(){introw=jdbcTemplate.update("delete from tbl_user where name = ?","heihei");return"success - "+row;}@GetMapping("/test5")publicList<User>test5(){List<User>userList=jdbcTemplate.query("select * from tbl_user",newBeanPropertyRowMapper<>(User.class));returnuserList;}@GetMapping("/test6")publicList<User>test6(){List<User>userList=jdbcTemplate.query("select * from tbl_user where id > ?",newBeanPropertyRowMapper<>(User.class),2);returnuserList;}@GetMapping("/test7")publicUsertest7(intid){Useruser=jdbcTemplate.queryForObject("select * from tbl_user where id = ?",newBeanPropertyRowMapper<>(User.class),id);returnuser;}@GetMapping("/test8")publicUsertest8(intid){List<User>userList=jdbcTemplate.query("select * from tbl_user where id = ?",newBeanPropertyRowMapper<>(User.class),id);Useruser=userList.size()>0?userList.get(0):null;returnuser;}@GetMapping("/test9")publicUsertest9(intid){Useruser=jdbcTemplate.queryForObject("select * from tbl_user where id = ?",User.class,id);returnuser;}@GetMapping("/test10")publicIntegertest10(){Integercount=jdbcTemplate.queryForObject("select count(*) from tbl_user",Integer.class);returncount;}@GetMapping("/test11")publicList<Map<String,Object>>test11(){List<Map<String,Object>>userList=jdbcTemplate.queryForList("select * from tbl_user where id > 3");returnuserList;}}

返回 Map<String, Object> 结构的 queryForList 方法通常在项目开发中使用不多，但以笔者的工作经历来看，这个方法很适合用来临时查询一批数据，并对这些数据进行操作，由于 JdbcTemplate 只需要依赖数据源，因此使用 JdbcTemplate 处理临时的一次性工作非常顺手。

2.queryForMap

queryForMap 方法也是一个非常好理解的方法，这个系列的方法都会返回 Map<String,Object>。注意，这个方法只会返回一条数据，所以这个方法适用于查询单条数据的场景。代码提供了一个非常简单的 queryForMap 方法的使用。

有关 JdbcTemplate 的常用方式就介绍这些，在实际项目开发中 JdbcTemplate 使用频率不高，但就其本身而言，JdbcTemplate 不失为一个简单实用的 JDBC API，读者可以在恰当的场景中合理利用。