spring——Spring JdbcTemplate（转载）

迷南。 2023-09-29 11:41 12阅读 0赞

我们知道，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，它提供了大量的查询和更新数据库的方法，如下表所示。

<table> 
 <tbody> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>public int update(String sql)</td> 
   <td colspan="1">用于执行新增、更新、删除等语句； 
    <ul> 
     <li>sql：需要执行的 SQL 语句；</li> 
     <li>args 表示需要传入到 SQL 语句中的参数。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td>public int update(String sql,Object... args)</td> 
  </tr> 
  <tr> 
   <td>public void execute(String sql)</td> 
   <td colspan="1">可以执行任意 SQL，一般用于执行 DDL 语句； 
    <ul> 
     <li>sql：需要执行的 SQL 语句；</li> 
     <li>action 表示执行完 SQL 语句后，要调用的函数。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td>public T execute(String sql, PreparedStatementCallback action)</td> 
  </tr> 
  <tr> 
   <td colspan="1">public &lt;T&gt; List&lt;T&gt; query(String sql, RowMapper&lt;T&gt; rowMapper, @Nullable Object... args)&nbsp;</td> 
  </tr> 
  <tr> 
   <td colspan="1">用于执行查询语句； 
    <ul> 
     <li>sql：需要执行的 SQL 语句；</li> 
     <li>rowMapper：用于确定返回的集合(List)的类型；</li> 
     <li>args：表示需要传入到 SQL 语句的参数。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td>public &lt;T&gt; T queryForObject(String sql, RowMapper&lt;T&gt; rowMapper, @Nullable Object... args)</td> 
  </tr> 
  <tr> 
   <td>public int[] batchUpdate(String sql, List&lt;Object[]&gt; batchArgs, final int[] argTypes)&nbsp;</td> 
   <td>用于批量执行新增、更新、删除等语句； 
    <ul> 
     <li>sql：需要执行的 SQL 语句；</li> 
     <li>argTypes：需要注入的 SQL&nbsp;参数的 JDBC 类型；</li> 
     <li>batchArgs：表示需要传入到 SQL 语句的参数。</li> 
    </ul> </td> 
  </tr> 
 </tbody> 
</table>

###  ###

### 示例 1 ###

![e7e68381a0a5ffa75c820a89a60dfc6a.png][]

![1c4db184c761942c88ec8d8f32c540dd.png][]

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

![0f9e5b7b2e6b2b95325bde437be2c1b9.png][]

在以上配置中，我们共定义了两个 Bean，

*  dataSource 为数据库连接池对象的 Bean。
 *  jdbcTemplate 则为 JdbcTemplate 的 Bean，它由一个名为 datasSource 的属性。

Spring 默认使用 DriverManagerDataSource 对数据库连接池进行管理，我们可以在 Spring 的 XML 配置文件中定义 DriverManagerDataSource 的 Bean，并注入到 JdbcTempate 的 Bean 中。  
在 dataSource 中，定义了 4 个连接数据库的属性，如下表所示。

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>driverClassName</td> 
   <td>所使用的驱动名称，对应驱动 JAR 包中的 Driver 类</td> 
  </tr> 
  <tr> 
   <td>url</td> 
   <td>数据源所在地址</td> 
  </tr> 
  <tr> 
   <td>username</td> 
   <td>访问数据库的用户名</td> 
  </tr> 
  <tr> 
   <td>password</td> 
   <td>访问数据库的密码</td> 
  </tr> 
 </tbody> 
</table>

上表中的属性值需要根据数据库类型或者机器配置的不同进行相应设置。如果数据库类型不同，则需要更改驱动名称；如果数据库不在本地，则需要将 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<User> getList(User user);
    
        /**
         * 查询单个用户信息
         *
         * @param user
         * @return
         */
        User getUser(User user);
    
        /**
         * 批量增加用户
         *
         * @param batchArgs
         */
        void batchAddUser(List<Object[]> 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<User> getList(User user) {
            String sql = "SELECT * FROM `user` where `status`=?;";
            return jdbcTemplate.query(sql, new BeanPropertyRowMapper<User>(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>(User.class), user.getUserId());
        }
    
        @Override
        public void batchAddUser(List<Object[]> 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<User> getUserList(User user);
    
        /**
         * 查询单个用户信息
         *
         * @param user
         * @return
         */
        public User getUser(User user);
    
        /**
         * 批量添加用户
         *
         * @param batchArgs
         */
        public void batchAddUser(List<Object[]> 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<User> getUserList(User user) {
            return userDao.getList(user);
        }
    
        @Override
        public User getUser(User user) {
            return userDao.getUser(user);
        }
    
        @Override
        public void batchAddUser(List<Object[]> 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<Object[]> 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<User> userList = userService.getUserList(user2);
            System.out.println("在线用户列表查询成功！");
            for (User user4 : userList) {
                System.out.println("用户 ID:" + user4.getUserId() + "，用户名：" + user4.getUserName() + "，状态：" + user4.getStatus());
            }
        }
    }

![cadb4f3f30707586c87d1f5788f58486.png][]

[e7e68381a0a5ffa75c820a89a60dfc6a.png]: https://img-blog.csdnimg.cn/img_convert/e7e68381a0a5ffa75c820a89a60dfc6a.png
[1c4db184c761942c88ec8d8f32c540dd.png]: https://img-blog.csdnimg.cn/img_convert/1c4db184c761942c88ec8d8f32c540dd.png
[0f9e5b7b2e6b2b95325bde437be2c1b9.png]: https://img-blog.csdnimg.cn/img_convert/0f9e5b7b2e6b2b95325bde437be2c1b9.png
[cadb4f3f30707586c87d1f5788f58486.png]: https://img-blog.csdnimg.cn/img_convert/cadb4f3f30707586c87d1f5788f58486.png