JDBCTemplate的详细讲解

最新推荐文章于 2025-06-21 15:09:14 发布

原创最新推荐文章于 2025-06-21 15:09:14 发布 · 2.7k 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#JDBC #Spring

Java 同时被 3 个专栏收录

16 篇文章

订阅专栏

Java学习园

15 篇文章

订阅专栏

MySQL

10 篇文章

订阅专栏

本文深入解析Spring框架下的JDBCTemplate组件，通过实例演示如何利用JDBCTemplate进行数据库的增删改查操作，包括执行DML与DQL语句，以及结果集的封装技巧。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

JDBCTemplate的详细讲解

一、JDBCTemplate_介绍

Spring框架对JDBC的简单封装。提供了一个JDBCTemplate对象简化JDBC的开发。

二、JDBCTemplate_快速入门【应用】

步骤：

1. 导入jar包（ Spring5.X需要JDK8及其以上支持）

2. 创建JdbcTemplate对象。依赖于数据源DataSource

JdbcTemplate template = new JdbcTemplate(ds);

3. 调用JdbcTemplate的方法来完成CRUD的操作

* update():执行DML语句。增、删、改语句，即非DQL都可以使用update()

* queryForMap():查询结果将结果集封装为map集合，将列名作为key，将值作为value 将这条记录封装为一个map集合

* 注意：这个方法查询的结果集长度只能是1

* queryForList():查询结果将结果集封装为list集合

* 注意：将每一条记录封装为一个Map集合，再将Map集合装载到List集合中

* query():查询结果，将结果封装为JavaBean对象

* query的参数：RowMapper

* 一般我们使用BeanPropertyRowMapper实现类。

可以完成数据到JavaBean的自动封装

* new BeanPropertyRowMapper<类型>(类型.class)

* queryForObject：查询结果，将结果封装为对象

* 一般用于聚合函数的查询

代码：

/**
 * JdbcTemplate入门
 */
public class JdbcTemplateDemo1 {
    public static void main(String[] args) {
        //1.导入jar包
        //2.创建JDBCTemplate对象
        JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource());
        //3.调用方法
        String sql = "update account set balance = 5000 where id = ?";
        int count = template.update(sql, 3);
        System.out.println(count);
    }
}

三、JDBCTemplate_执行DML语句【应用】

代码：

public class JdbcTemplateDemo2 {

    //Junit单元测试，可以让方法独立执行

    //1. 获取JDBCTemplate对象
    private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource());

    /**
     * 1. 修改1号数据的 salary 为 10000
     */
    @Test
    public void test1(){

        //2. 定义sql
        String sql = "update emp set salary = 10000 where id = 1001";
        //3. 执行sql
        int count = template.update(sql);
        System.out.println(count);
    }

    /**
     * 2. 添加一条记录
     */
    @Test
    public void test2(){
        String sql = "insert into emp(id,ename,dept_id) values(?,?,?)";
        int count = template.update(sql, 1015, "郭靖", 10);
        System.out.println(count);

    }

    /**
     * 3.删除刚才添加的记录
     */
    @Test
    public void test3(){
        String sql = "delete from emp where id = ?";
        int count = template.update(sql, 1015);
        System.out.println(count);
    }
}

四、JDBCTemplate_执行DQL语句【应用】

代码：

public class JdbcTemplateDemo2 {

    //Junit单元测试，可以让方法独立执行

    //1. 获取JDBCTemplate对象
    private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource());

    /**
     * 4.查询id为1001的记录，将其封装为Map集合
     * 注意：这个方法查询的结果集长度只能是1
     */
    @Test
    public void test4(){
        String sql = "select * from emp where id = ? or id = ?";
        Map<String, Object> map = template.queryForMap(sql, 1001,1002);
        System.out.println(map);
        //{id=1001, ename=孙悟空, job_id=4, mgr=1004, joindate=2000-12-17, salary=10000.00, bonus=null, dept_id=20}

    }

    /**
     * 5. 查询所有记录，将其封装为List
     */
    @Test
    public void test5(){
        String sql = "select * from emp";
        List<Map<String, Object>> list = template.queryForList(sql);

        for (Map<String, Object> stringObjectMap : list) {
            System.out.println(stringObjectMap);
        }
    }

    /**
     * 6. 查询所有记录，将其封装为Emp对象的List集合
     */
    @Test
    public void test6(){
        String sql = "select * from emp";
        List<Emp> list = template.query(sql, new RowMapper<Emp>() {

            @Override
            public Emp mapRow(ResultSet rs, int i) throws SQLException {
                Emp emp = new Emp();
                int id = rs.getInt("id");
                String ename = rs.getString("ename");
                int job_id = rs.getInt("job_id");
                int mgr = rs.getInt("mgr");
                Date joindate = rs.getDate("joindate");
                double salary = rs.getDouble("salary");
                double bonus = rs.getDouble("bonus");
                int dept_id = rs.getInt("dept_id");

                emp.setId(id);
                emp.setEname(ename);
                emp.setJob_id(job_id);
                emp.setMgr(mgr);
                emp.setJoindate(joindate);
                emp.setSalary(salary);
                emp.setBonus(bonus);
                emp.setDept_id(dept_id);

                return emp;
            }
        });


        for (Emp emp : list) {
            System.out.println(emp);
        }
    }

    /**
     * 6. 查询所有记录，将其封装为Emp对象的List集合
     */
    @Test
    public void test6_2(){
        String sql = "select * from emp";
        List<Emp> list = template.query(sql, new BeanPropertyRowMapper<Emp>(Emp.class));
        for (Emp emp : list) {
            System.out.println(emp);
        }
    }

    /**
     * 7. 查询总记录数
     */
    @Test
    public void test7(){
        String sql = "select count(id) from emp";
        Long total = template.queryForObject(sql, Long.class);
        System.out.println(total);
    }

}

扩展：

1. 查询总记录数，也可以将结果封装成Integer类型

//查询总记录数
    @Test
    public void test4(){
        JdbcTemplate jt = new JdbcTemplate(DataSourceUtils.getDataSource());
        String sql = "select count(*) from emp";
        Long total = jt.queryForObject(sql, Long.class);
        System.out.println(total);
    }

    //查询总记录数
    @Test
    public void test5(){
        JdbcTemplate jt = new JdbcTemplate(DataSourceUtils.getDataSource());
        String sql = "select count(*) from emp";
        Integer total = jt.queryForObject(sql, Integer.class);
        System.out.println(total);
    }

2. 统计平均分，也可以将结果封装成Double类型

//统计平均分
    @Test
    public void test6(){
        JdbcTemplate jt = new JdbcTemplate(DataSourceUtils.getDataSource());
        String sql = "select avg(salary) from emp";
        Integer total = jt.queryForObject(sql, Integer.class);
        System.out.println(total);//20875
    }

    //统计平均分
    @Test
    public void test7(){
        JdbcTemplate jt = new JdbcTemplate(DataSourceUtils.getDataSource());
        String sql = "select avg(salary) from emp";
        Double total = jt.queryForObject(sql, Double.class);
        System.out.println(total);//20875.0
    }

3. 查询id为1001的记录，将其封装成Emp对象，如果查询失败，报错

org.springframework.dao.EmptyResultDataAccessException:

Incorrect result size: expected 1, actual 0

项目中建议使用try..catch处理

//查询id为1001的记录，将其封装成Emp对象
@Test
public void test8(){
   try {
        JdbcTemplate jt = new JdbcTemplate(DataSourceUtils.getDataSource());
        String sql = "SELECT * FROM emp WHERE id=?";
        Object[] params = {1};
        Emp emp = 
jt.queryForObject(sql, new BeanPropertyRowMapper<Emp>(Emp.class),params);
        System.out.println(emp);
   } catch (DataAccessException e) {
        System.out.println("查无此人，可以返回null");
        //return null;
   }
}

import datasource.util.JdbcUtil;
import domain.Emp;
import org.junit.Test;
import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.JdbcTemplate;

public class JdbcTemplateDemo2 {

    private JdbcTemplate jt = new JdbcTemplate(JdbcUtil.getDataSource());

    //需求：获取emp表所有员工的平均工资
    @Test
    public void test1(){
        String sql = "SELECT AVG(salary) FROM emp";
        double avg = jt.queryForObject(sql, double.class);
        System.out.println("平均工资为:" + avg);
    }

    //需求：查询id=3的用户的姓名
    @Test
    public void test2(){
        String sql = "SELECT NAME FROM emp WHERE id=?";
        //String name = jt.queryForObject(sql, String.class);
        String name = jt.queryForObject(sql, String.class, 3);
        System.out.println("3号用户的姓名是：" + name);
    }

    //需求：根据姓名和工资查询某个用户，模拟登录
    //最难，但最实用
    //分析：
    //将一条记录封装成一个Emp对象,我们想到了BeanPropertyRowMapper
    //这个方法必须返回1条记录，否则出错
    @Test
    public void test3() {
        String username = "猪八戒";
        double salary = 3600;

        String sql = "SELECT * FROM emp WHERE NAME = ? AND salary = ?";
        Object[] arr = {username, salary};


        try{
            Emp emp = jt.queryForObject(sql, new BeanPropertyRowMapper<Emp>(Emp.class), arr);
            if(emp != null){
                System.out.println("查有此人");
            }
        }catch(Exception e){
            e.printStackTrace();
            System.out.println("查无此人");
        }


    }

}