Spring JdbcTemplate（使用详解）

我们知道，JDBC 是 Java 提供的一种用于执行 SQL 语句的 API，可以对多种关系型数据库（例如 MySQL、Oracle 等）进行访问。

但在实际的企业级应用开发中，却很少有人直接使用原生的 JDBC API 进行开发，这是因为使用 JDBC API 对数据库进行操作十分繁琐，需要我们对每一步都做到“步步把控，处处关心”，例如我们需要手动控制数据库连接的开启，异常处理、事务处理、最后还要手动关闭连接释放资源等等。

Spring 提供了一个 Spring JDBC 模块，它对 JDBC API 进行了封装，其的主要目的降低 JDBC API 的使用难度，以一种更直接、更简洁的方式使用 JDBC API。

使用 Spring JDBC，开发人员只需要定义必要的参数、指定需要执行的 SQL 语句，即可轻松的进行 JDBC 编程，对数据库进行访问。

至于驱动的加载、数据库连接的开启与关闭、SQL 语句的创建与执行、异常处理以及事务处理等繁杂乏味的工作，则都是由 Spring JDBC 完成的。这样就可以使开发人员从繁琐的 JDBC API 中解脱出来，有更多的精力专注于业务的开发。

Spring JDBC 提供了多个实用的数据库访问工具，以简化 JDBC 的开发，其中使用最多就是 JdbcTemplate。
JdbcTemplate
JdbcTemplate 是 Spring JDBC 核心包（core）中的核心类，它可以通过配置文件、注解、Java 配置类等形式获取数据库的相关信息，实现了对 JDBC 开发过程中的驱动加载、连接的开启和关闭、SQL 语句的创建与执行、异常处理、事务处理、数据类型转换等操作的封装。我们只要对其传入SQL 语句和必要的参数即可轻松进行 JDBC 编程。

JdbcTemplate 的全限定命名为 org.springframework.jdbc.core.JdbcTemplate，它提供了大量的查询和更新数据库的方法，如下表所示。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kqMGjMJ2-1652873845151)(https://upload-images.jianshu.io/upload_images/28037261-9923f39bef3c4f71.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]
示例 1
下面我们就结合实例，对使用 JdbcTemplate 进行 JDBC 编程进行讲解，步骤如下。

1. 在 MySQL 数据库中创建一个 spring_jdbc_db 数据库实例，并执行以下 SQL 语句创建一个用户信息（user）表。
   DROP TABLE IF EXISTS user;
   CREATE TABLE user (
   user_id int NOT NULL AUTO_INCREMENT COMMENT ‘用户 ID’,
   user_name varchar(255) DEFAULT NULL COMMENT ‘用户名’,
   status varchar(255) DEFAULT NULL COMMENT ‘用户状态’,
   PRIMARY KEY (user_id)
   ) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8;

2. 创建一个名为 my-spring-jdbc-demo 的项目，并在将以下依赖导入到工程中。
   spring-beans-5.3.13.RELEASE.jar
   spring-context-5.3.13.RELEASE.jar
   spring-core-5.3.13.RELEASE.jar
   spring-expression-5.3.13.RELEASE.jar
   commons-logging-1.2.jar
   spring-jdbc-5.3.13.RELEASE.jar
   spring-tx-5.3.13.RELEASE.jar
   spring-aop-5.3.13.jar
   mysql-connector-java-8.0.23.jar

除了 Spring 的核心依赖以及 commons-logging 日志包外，我们还需要在项目中导入以下依赖。

3. 在 src 目录下创建一个 jdbc.properties，并在该配置文件中对数据库连接信息进行配置。
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/spring_jdbc_db
jdbc.username=root
jdbc.password=root

4. 在 src 目录下创建一个 XML 配置文件 Beans.xml，配置内容如下。

在以上配置中，我们共定义了两个 Bean，
dataSource 为数据库连接池对象的 Bean。
jdbcTemplate 则为 JdbcTemplate 的 Bean，它由一个名为 datasSource 的属性。

Spring 默认使用 DriverManagerDataSource 对数据库连接池进行管理，我们可以在 Spring 的 XML 配置文件中定义 DriverManagerDataSource 的 Bean，并注入到 JdbcTempate 的 Bean 中。

在 dataSource 中，定义了 4 个连接数据库的属性，如下表所示。

上表中的属性值需要根据数据库类型或者机器配置的不同进行相应设置。如果数据库类型不同，则需要更改驱动名称；如果数据库不在本地，则需要将 localhost 替换成相应的主机 IP。

5. 在 net.biancheng.c.entity 包下，创建名为 User 的实体类，代码如下。
   package net.biancheng.c.entity;
   public class User {
   private Integer userId;
   private String userName;
   private String status;
   public Integer getUserId() {
   return userId;
   }
   public void setUserId(Integer userId) {
   this.userId = userId;
   }
   public String getUserName() {
   return userName;
   }
   public void setUserName(String userName) {
   this.userName = userName;
   }
   public String getStatus() {
   return status;
   }
   public void setStatus(String status) {
   this.status = status;
   }
   @Override
   public String toString() {
   return “User{” +
   “userId=” + userId +
   “, userName='” + userName + ‘’’ +
   “, status='” + status + ‘’’ +
   ‘}’;
   }
   }

6. 在 net.biancheng.c.dao 包下，创建一个名为 UserDao 的 Dao 接口，代码如下。
   package net.biancheng.c.dao;
   import net.biancheng.c.entity.User;
   import java.util.List;
   public interface UserDao {
   /**

   • 新增一条用户
   • @param user
   • @return
     /
     int addUer(User user);
     /*
   • 更新指定的用户信息
   • @param user
   • @return
     /
     int update(User user);
     /*
   • 删除指定的用户信息
   • @param user
   • @return
     /
     int delete(User user);
     /*
   • 统计用户个数
   • @param user
   • @return
     /
     int count(User user);
     /*
   • 查询用户列表
   • @param user
   • @return
     /
     List getList(User user);
     /*
   • 查询单个用户信息
   • @param user
   • @return
     /
     User getUser(User user);
     /*
   • 批量增加用户
   • @param batchArgs
     */
     void batchAddUser(List batchArgs);
     }

7. 在 net.biancheng.c.dao.impl 包下，创建 UserDao 的实现类 UserDaoImpl，代码如下。
   package net.biancheng.c.dao.impl;
   import net.biancheng.c.dao.UserDao;
   import net.biancheng.c.entity.User;
   import org.springframework.jdbc.core.BeanPropertyRowMapper;
   import org.springframework.jdbc.core.JdbcTemplate;
   import org.springframework.jdbc.core.namedparam.MapSqlParameterSource;
   import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
   import org.springframework.jdbc.core.namedparam.SqlParameterSource;
   import org.springframework.stereotype.Repository;
   import javax.annotation.Resource;
   import java.util.List;
   @Repository
   public class UserDaoImpl implements UserDao {
   @Resource
   private JdbcTemplate jdbcTemplate;
   @Resource
   private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
   @Override
   public int addUer(User user) {
   String sql = “INSERT into user (user.user_name,user.status) VALUES(?,?);”;
   int update = jdbcTemplate.update(sql, user.getUserName(), user.getStatus());
   return update;
   }
   @Override
   public int update(User user) {
   String sql = “UPDATE user SET status=? WHERE user_name=?;”;
   return jdbcTemplate.update(sql, user.getStatus(), user.getUserName());
   }
   @Override
   public int delete(User user) {
   String sql = “DELETE FROM user where user_name=?;”;
   return jdbcTemplate.update(sql, user.getUserName());
   }
   @Override
   public int count(User user) {
   String sql = “SELECT COUNT(*) FROM user where status=?;”;
   return jdbcTemplate.queryForObject(sql, Integer.class, user.getStatus());
   }
   @Override
   public List getList(User user) {
   String sql = “SELECT * FROM user where status=?;”;
   return jdbcTemplate.query(sql, new BeanPropertyRowMapper(User.class), user.getStatus());
   }
   @Override
   public User getUser(User user) {
   String sql = “SELECT * FROM user where user_id=?;”;
   return jdbcTemplate.queryForObject(sql, new BeanPropertyRowMapper(User.class), user.getUserId());
   }
   @Override
   public void batchAddUser(List batchArgs) {
   String sql = “INSERT into user (user.user_name,user.status) VALUES(?,?);”;
   jdbcTemplate.batchUpdate(sql, batchArgs);
   }
   }

8. 在 net.biancheng.c.service 包下，创建一个名为 UserService 的 Service 接口，代码如下。
   package net.biancheng.c.service;
   import net.biancheng.c.entity.User;
   import java.util.List;
   public interface UserService {
   /**

   • 新增用户数据
   • @param user
   • @return
     /
     public int addUser(User user);
     /*
   • 更新用户数据
   • @param user
   • @return
     /
     public int updateUser(User user);
     /*
   • 删除用户数据
   • @param user
   • @return
     /
     public int deleteUser(User user);
     /*
   • 统计用户数量
   • @param user
   • @return
     /
     public int countUser(User user);
     /*
   • 查询用户数据
   • @param user
   • @return
     /
     public List getUserList(User user);
     /*
   • 查询单个用户信息
   • @param user
   • @return
     /
     public User getUser(User user);
     /*
   • 批量添加用户
   • @param batchArgs
     */
     public void batchAddUser(List batchArgs);
     }

9. 在 net.biancheng.c.service.impl 包下，创建 UserService 的实现类 UserServiceImpl，代码如下。
   package net.biancheng.c.service.impl;
   import net.biancheng.c.dao.UserDao;
   import net.biancheng.c.entity.User;
   import net.biancheng.c.service.UserService;
   import org.springframework.stereotype.Service;
   import javax.annotation.Resource;
   import java.util.List;
   @Service(“userService”)
   public class UserServiceImpl implements UserService {
   @Resource
   private UserDao userDao;
   @Override
   public int addUser(User user) {
   return userDao.addUer(user);
   }
   @Override
   public int updateUser(User user) {
   return userDao.update(user);
   }
   @Override
   public int deleteUser(User user) {
   return userDao.delete(user);
   }
   @Override
   public int countUser(User user) {
   return userDao.count(user);
   }
   @Override
   public List getUserList(User user) {
   return userDao.getList(user);
   }
   @Override
   public User getUser(User user) {
   return userDao.getUser(user);
   }
   @Override
   public void batchAddUser(List batchArgs) {
   userDao.batchAddUser(batchArgs);
   }
   @Override
   public int countOfUserByName(User user) {
   return userDao.countOfUserByName(user);
   }
   @Override
   public User getUserByUserId(User user) {
   return userDao.getUserByUserId(user);
   }
   }

10. 在 net.biancheng.c 包下，创建一个名为 MainApp 的类，代码如下。
    package net.biancheng.c;
    import net.biancheng.c.entity.User;
    import net.biancheng.c.service.UserService;
    import org.springframework.context.ApplicationContext;
    import org.springframework.context.support.ClassPathXmlApplicationContext;
    import java.util.ArrayList;
    import java.util.List;
    public class MainApp {
    public static void main(String[] args) {
    ApplicationContext context2 = new ClassPathXmlApplicationContext(“Beans.xml”);
    UserService userService = context2.getBean(“userService”, UserService.class);
    User user = new User();
    user.setUserName(“小张”);
    user.setStatus(“离线线”);
    //新增一个用户
    int i = userService.addUser(user);
    System.out.println(“新增用户成功！”);
    User user1 = new User();
    user1.setUserName(“小张”);
    user1.setStatus(“在线”);
    int u = userService.updateUser(user1);
    System.out.println(“修改用户成功”);
    List batchArgs = new ArrayList<>();
    Object[] o1 = {“小明”, “在线”};
    Object[] o2 = {“小龙”, “离线”};
    Object[] o3 = {“小林”, “在线”};
    Object[] o4 = {“小李”, “在线”};
    batchArgs.add(o1);
    batchArgs.add(o2);
    batchArgs.add(o3);
    batchArgs.add(o4);
    userService.batchAddUser(batchArgs);
    System.out.println(“批量增加完毕”);
    User user2 = new User();
    user2.setStatus(“在线”);
    int i1 = userService.countUser(user2);
    System.out.println(“在线用户的个数为：” + i1);
    List userList = userService.getUserList(user2);
    System.out.println(“在线用户列表查询成功！”);
    for (User user4 : userList) {
    System.out.println(“用户 ID:” + user4.getUserId() + “，用户名：” + user4.getUserName() + “，状态：” + user4.getStatus());
    }
    }
    }

11. 执行 MainApp 中的 main 方法，控制台输出如下。
    新增用户成功！
    修改用户成功
    批量增加完毕
    在线用户的个数为：4
    在线用户列表查询成功！
    用户 ID:1，用户名：小张，状态：在线
    用户 ID:2，用户名：小明，状态：在线
    用户 ID:4，用户名：小林，状态：在线
    用户 ID:5，用户名：小李，状态：在线