Spring之对JDBC的支持

深碍√TFBOYSˉ_ 2022-07-11 09:27 208阅读 0赞

## 前言—JDBC相对于持久化技术的优势 ##

持久化技术有很多种，而Hibernate，iBATIS和JPA只是其中几种而已。尽管如此，还是有很多的应用程序使用最古老的方法将Java对象保存到数据库中，这种久经考验并证明行之有效的持久化方法就是JDBC技术（JDBC具体介绍可以参考之前博客[http://blog.csdn.net/megustas\_jjc/article/details/53764507][http_blog.csdn.net_megustas_jjc_article_details_53764507]）。

JDBC不要求我们掌握其他框架的查询语言。它是建立在SQL之上的，而SQL本身就是数据库访问语言。此外，与其它技术相比，使用JDBC能够更好的对数据访问的性能进行优化。JDBC允许你使用数据库的所有性能，而这是其它框架不鼓励甚至禁止的。

再者，相对于持久层框架，JDBC能够让我们在更低的层次上处理数据，我们可以完全的控制程序如何读取和管理数据，包括访问和管理数据库中单独的列。这种细粒度的数据访问方式在很多应用程序中是很方便的。例如在报表应用中，如果将数据组织为对象，而接下来唯一要做的就是将其解包为原始数据，那就没有太大的意义了。

但是JDBC也不是十全十美的，虽然JDBC具有强大，灵活和其它一些优点，但也有不足之处。

## 应对失控的JDBC代码 ##

如果使用JDBC所提供的直接操作数据库的API，你需要负责处理与数据库访问相关的所有事情，其中包含管理数据库资源和处理异常，如果你曾经使用JDBC往数据库插入数据，如下代码应该并不陌生：

private static final String SQL_INSERT_SPITTER = 
    "insert into spitter(username，password,fullname) values(?,?,?)";
    private DataSource dataSource;
    public void addSpitter(Spitter spitter){
        Connection conn = null;
        PreparedStatement stmt = null;
        try{
            conn = dataSource.getConnection();//获取连接
            stmt = conn.prepareStatement(SQL_INSERT_SPITTER);//创建语句
            stmt.setString(1,spitter.getUsername());
            stmt.setString(2,spitter.getPassword());
            stmt.setString(1,spitter.getFullname());
            stmt.execute();//执行语句
        }catch (SQLException e){
            //do something...
        }finally{
            try{
                if(stmt != null){
                    stmt.close();//清理资源
                }
                if(conn != null){
                    conn.close();
                }
            }catch (SQLException e){
                //...
            }
        }
    }

这段代码与插入和更新样例一样冗长，甚至更为复杂。只有20%的代码是真正用于查询数据的，而80%代码都是样板代码。大量的JDBC代码都是用于创建连接的语句以及异常处理的样板代码。但是实际上，这些样板代码是非常重要的。清理资源和处理错误确保了数据访问的健壮性，没有这些语句会导致意外的代码和资源泄露。因此，不仅需要这些代码，还要保证这些代码的正确性。

## 使用JDBC模版 ##

Spring的JDBC框架承担了资源管理和异常处理的工作，从而简化了JDBC代码，让我们只需要编写从数据库写数据的必需代码。Spring将数据访问的样板代码抽象到模板类之中，Spring为JDBC提供了三个模板类供选择：

*  JdbcTemplate：最基本的Spring JDBC模板类，这个模板类支持简单的JDBC数据库访问功能以及基于索引参数的查询。
 *  NameParameterJdbcTemplate：使用该模板类执行查询时可以将值以命名参数的形式绑定到SQL中，而不是使用简单的索引参数。
 *  SimpleJdbcTemplate：该模板类利用Java5的一些特性例如自动装箱，泛型以及可变参数列表来简化JDBC模板的使用（已经被废弃，Java5的特性被转移到了JdbcTemplate中）。

对于大多数的JDBC任务来说，JdbcTemplate就是最好的可选方案。

### 使用JdbcTemplate来操作数据库 ###

数据类的bean：

public class Employee {
    
        private Integer id;
        private String lastName;
        private String email;
    
        private Integer dpetId;
    
        public Integer getId() {
            return id;
        }
    
        public void setId(Integer id) {
            this.id = id;
        }
    
        public String getLastName() {
            return lastName;
        }
    
        public void setLastName(String lastName) {
            this.lastName = lastName;
        }
    
        public String getEmail() {
            return email;
        }
    
        public void setEmail(String email) {
            this.email = email;
        }
    
        public Integer getDpetId() {
            return dpetId;
        }
    
        public void setDpetId(Integer dpetId) {
            this.dpetId = dpetId;
        }
    
        @Override
        public String toString() {
            return "Employee [id=" + id + ", lastName=" + lastName + ", email="
                    + email + ", dpetId=" + dpetId + "]";
        }
    
    
    }

数据表是一个复合类型，表employee中的deptId关联到另一个bean：

public class Department {
    
        private Integer id;
        private String name;
    
        public Integer getId() {
            return id;
        }
    
        public void setId(Integer id) {
            this.id = id;
        }
    
        public String getName() {
            return name;
        }
    
        public void setName(String name) {
            this.name = name;
        }
    
        @Override
        public String toString() {
            return "Department [id=" + id + ", name=" + name + "]";
        }
    
    }

我们封装了通过id获取employee对象和department对象的方法：

@Repository
    public class EmployeeDao {
        
    
        @Autowired
        private JdbcTemplate jdbcTemplate;
    
        public Employee get(Integer id){
            String sql = "SELECT id, last_name lastName, email FROM employees WHERE id = ?";
            RowMapper<Employee> rowMapper = new BeanPropertyRowMapper<>(Employee.class);
            Employee employee = jdbcTemplate.queryForObject(sql, rowMapper, id);
    
            return employee;
        }
    }

/**
     * 不推荐使用 JdbcDaoSupport, 而推荐直接使用 JdbcTempate 作为 Dao 类的成员变量
     */
    @Repository
    public class DepartmentDao extends JdbcDaoSupport{
        
    
        @Autowired
        public void setDataSource2(DataSource dataSource){
            setDataSource(dataSource);
        }
    
        public Department get(Integer id){
            String sql = "SELECT id, dept_name name FROM departments WHERE id = ?";
            RowMapper<Department> rowMapper = new BeanPropertyRowMapper<>(Department.class);
            return getJdbcTemplate().queryForObject(sql, rowMapper, id);
        }
    
    }

配置：

<context:component-scan base-package="com.atguigu.spring"></context:component-scan>
        
        <context:property-placeholder location="classpath:db.properties"/>
    
        
        <bean id="dataSource"
            class="com.mchange.v2.c3p0.ComboPooledDataSource">
            <property name="user" value="${jdbc.user}"></property>
            <property name="password" value="${jdbc.password}"></property>
            <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property>
            <property name="driverClass" value="${jdbc.driverClass}"></property>
    
            <property name="initialPoolSize" value="${jdbc.initPoolSize}"></property>
            <property name="maxPoolSize" value="${jdbc.maxPoolSize}"></property>
        </bean>
    
        
        <bean id="jdbcTemplate" 
            class="org.springframework.jdbc.core.JdbcTemplate">
            <property name="dataSource" ref="dataSource"></property>
        </bean>

JdbcTemplate数据库操作：

public class JDBCTest {
        
    
        private ApplicationContext ctx = null;
        private JdbcTemplate jdbcTemplate;
        private EmployeeDao employeeDao;
        private DepartmentDao departmentDao;
        private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
    
        {
            ctx = new ClassPathXmlApplicationContext("applicationContext.xml");
            jdbcTemplate = (JdbcTemplate) ctx.getBean("jdbcTemplate");
            employeeDao = ctx.getBean(EmployeeDao.class);
            departmentDao = ctx.getBean(DepartmentDao.class);
            namedParameterJdbcTemplate = ctx.getBean(NamedParameterJdbcTemplate.class);
        }
    
    
        /**
         * 使用具名参数时, 可以使用 update(String sql, SqlParameterSource paramSource) 方法进行更新操作
         * 1. SQL 语句中的参数名和类的属性一致!
         * 2. 使用 SqlParameterSource 的 BeanPropertySqlParameterSource 实现类作为参数. 
         */
        @Test
        public void testNamedParameterJdbcTemplate2(){
            String sql = "INSERT INTO employees(last_name, email, dept_id) "
                    + "VALUES(:lastName,:email,:dpetId)";
    
            Employee employee = new Employee();
            employee.setLastName("XYZ");
            employee.setEmail("xyz@sina.com");
            employee.setDpetId(3);
    
            SqlParameterSource paramSource = new BeanPropertySqlParameterSource(employee);
            namedParameterJdbcTemplate.update(sql, paramSource);
        }
    
        /**
         * 可以为参数起名字. 
         * 1. 好处: 若有多个参数, 则不用再去对应位置, 直接对应参数名, 便于维护
         * 2. 缺点: 较为麻烦. 
         */
        @Test
        public void testNamedParameterJdbcTemplate(){
            String sql = "INSERT INTO employees(last_name, email, dept_id) VALUES(:ln,:email,:deptid)";
    
            Map<String, Object> paramMap = new HashMap<>();
            paramMap.put("ln", "FF");
            paramMap.put("email", "ff@atguigu.com");
            paramMap.put("deptid", 2);
    
            namedParameterJdbcTemplate.update(sql, paramMap);
        }
    
        @Test
        public void testDepartmentDao(){
            System.out.println(departmentDao.get(1));
        }
    
        @Test
        public void testEmployeeDao(){
            System.out.println(employeeDao.get(1));
        }
    
        /**
         * 获取单个列的值, 或做统计查询
         * 使用 queryForObject(String sql, Class<Long> requiredType) 
         */
        @Test
        public void testQueryForObject2(){
            String sql = "SELECT count(id) FROM employees";
            long count = jdbcTemplate.queryForObject(sql, Long.class);
    
            System.out.println(count);
        }
    
        /**
         * 查到实体类的集合
         * 注意调用的不是 queryForList 方法
         */
        @Test
        public void testQueryForList(){
            String sql = "SELECT id, last_name lastName, email FROM employees WHERE id > ?";
            RowMapper<Employee> rowMapper = new BeanPropertyRowMapper<>(Employee.class);
            List<Employee> employees = jdbcTemplate.query(sql, rowMapper,5);
    
            System.out.println(employees);
        }
    
        /**
         * 从数据库中获取一条记录, 实际得到对应的一个对象
         * 注意不是调用 queryForObject(String sql, Class<Employee> requiredType, Object... args) 方法!
         * 而需要调用 queryForObject(String sql, RowMapper<Employee> rowMapper, Object... args)
         * 1. 其中的 RowMapper 指定如何去映射结果集的行, 常用的实现类为 BeanPropertyRowMapper
         * 2. 使用 SQL 中列的别名完成列名和类的属性名的映射. 例如 last_name的别名是lastName
         * 3. 不支持级联属性. JdbcTemplate 到底是一个 JDBC 的小工具, 而不是 ORM 框架,dept_id as \"department.id\" 并不好用
         */
        @Test
        public void testQueryForObject(){
            String sql = "SELECT id, last_name lastName, email, dept_id as \"department.id\" FROM employees WHERE id = ?";
            RowMapper<Employee> rowMapper = new BeanPropertyRowMapper<>(Employee.class);
            Employee employee = jdbcTemplate.queryForObject(sql, rowMapper, 1);
    
            System.out.println(employee);
        }
    
        /**
         * 执行批量更新: 批量的 INSERT, UPDATE, DELETE
         * 最后一个参数是 Object[] 的 List 类型: 因为修改一条记录需要一个 Object 的数组, 那么多条不就需要多个 Object 的数组吗
         */
        @Test
        public void testBatchUpdate(){
            String sql = "INSERT INTO employees(last_name, email, dept_id) VALUES(?,?,?)";
    
            List<Object[]> batchArgs = new ArrayList<>();
    
            batchArgs.add(new Object[]{
       "AA", "aa@atguigu.com", 1});
            batchArgs.add(new Object[]{
       "BB", "bb@atguigu.com", 2});
            batchArgs.add(new Object[]{
       "CC", "cc@atguigu.com", 3});
            batchArgs.add(new Object[]{
       "DD", "dd@atguigu.com", 3});
            batchArgs.add(new Object[]{
       "EE", "ee@atguigu.com", 2});
    
            jdbcTemplate.batchUpdate(sql, batchArgs);
        }
    
        /**
         * 执行 INSERT, UPDATE, DELETE
         */
        @Test
        public void testUpdate(){
            String sql = "UPDATE employees SET last_name = ? WHERE id = ?";
            jdbcTemplate.update(sql, "Jack", 5);
        }
    
        /**
         * 测试数据库连接
         * @throws SQLException
         */
        @Test
        public void testDataSource() throws SQLException {
            DataSource dataSource = ctx.getBean(DataSource.class);
            System.out.println(dataSource.getConnection());
        }
    
    }

每次使用都创建一个JdbcTemplate的新实例，这种做法效率低下，JdbcTemplate类被设计成线程安全的，可以在IOC容器中声明它的单个实例，并将这个实例注入到所有DAO实例中。

[http_blog.csdn.net_megustas_jjc_article_details_53764507]: http://blog.csdn.net/megustas_jjc/article/details/53764507