Spring JDBC最佳实践(3)

原文地址：https://my.oschina.net/u/218421/blog/38598

spring jdbc包提供了JdbcTemplate和它的两个兄弟SimpleJdbcTemplate和NamedParameterJdbcTemplate，我们可以先从JdbcTemplate入手，领略一下这个类的便利和优雅。
1、使用JdbcTemplate进行数据访问：
初始化JdbcTemplate
初始化JdbcTemplate很容易，只需要向它的构造方法传入它所使用的DataSource便可以。如果使用Jakarta Commons DBCP，那么初始化代码如下所示：

BasicDataSource dataSource = new BasicDataSource();
        dataSource.setDriverClassName("com.mysql.jdbc.Driver");
        dataSource.setUrl("jdbc:mysql://localhost/mysql?characterEncoding=gb2312");
        dataSource.setUsername("***");
        dataSource.setPassword("***");
        JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);

也可以通过无参的构造方法构造JdbcTemplate，然后通过setDataSource(DataSource dataSource)来设置其dataSource。
上述这种方法是通过编码的方式构造JdbcTemplate，如果应用程序使用spring的IOC容器，其初始化工作便可移植到容器的配置文件当中：

<!-- dataSource -->
    <bean id="dataSource"
        class="org.apache.commons.dbcp.BasicDataSource"
        destroy-method="close">
        
        <property name="driverClassName">
            <value>com.mysql.jdbc.Driver</value>
        </property>
        <property name="url" value="jdbc:mysql://localhost:3306/oa?characterEncoding=gb2312" />
        <property name="username" value="root" />
        <property name="password" value="root" />
        <property name="maxActive" value="100" />
        <property name="maxIdle" value="30" />
        <property name="maxWait" value="1000" />
        <property name="defaultAutoCommit" value="true" />
        <property name="removeAbandoned" value="true" />
    </bean>
    <!-- jdbcTemplate -->
    <bean id="jdbc"
        class="org.springframework.jdbc.core.JdbcTemplate">
        <property name="dataSource">
            <ref bean="dataSource" />
        </property>
    </bean>

之后，想把jdbcTemplate注入到哪个bean都可以，初始化好了JdbcTemplate以后，便可以大施拳脚了！

使用JdbcTemplate查询数据：
JdbcTemplate针对数据查询提供了多个重载的模板方法，我们可以根据需要选用不同的模板方法。如果查询很简单，仅仅是传入相应的SQL或者是相关的参数，然后取得一个结果，那么我们可以用如下的一组便利的模板方法：

public int queryForInt(String sql)
public int queryForInt(String sql, Object[] args)
public int queryForInt(String sql, Object[] args)
public long queryForLong(String sql)
public long queryForLong(String sql, Object[] args)
public long queryForLong(String sql, Object[] args, int[] argTypes)
public Object queryForObject(String sql, Class requiredType)
public Object queryForObject(String sql, Object[] args, int[] argTypes, Class requiredType)
public Object queryForObject(String sql, Object[] args, int[] argTypes, RowMapper rowMapper)
public Object queryForObject(String sql, Object[] args, Class requiredType)
public Object queryForObject(String sql, Object[] args, RowMapper rowMapper)
public Object queryForObject(String sql, RowMapper rowMapper)

注意：这些针对的resultset返回的必须是一行记录，否则会出错！
 如果查询的结果包含一列数字型的结果，或者使用了SQL函数，或者其它的单列的结果，那么便可以直接通过这组便利的模板方法进行查询：

int postId = jdbcTemplate.queryForInt("SELECT POSTID FROM USERS WHERE USERNAME=?",new String[]{"jason"});
        System.out.println(postId);
        long userCount = jdbcTemplate.queryForLong("SELECT COUNT(*) FROM USERS");
        System.out.println(userCount);
        String nickname = (String)jdbcTemplate.queryForObject("SELECT USERNAME1 FROM USERS WHERE USERNAME='jason'", String.class);
        System.out.println(nickname);
        Map singleUser = jdbcTemplate.queryForMap("SELECT * FROM USERS WHERE USERNAME = 'jason'");
        System.out.println(singleUser);

queryForMap与其它的方法的不同之处在于它的查询的结果以java.util.Map的形式返回，Map的键对应查询的表的列的名字，Map的值对应键所在的列的值。

如果查询的结果返回多行，而我们又不在乎他们是否拥有较强的约束类型，那么可以用以下的模板方法：

public List queryForList(String sql)
public List queryForList(String sql, Object[] args)
public List queryForList(String sql, Object[] args, int[] argTypes)

queryForList()方法根据传入的sql以及相应的参数执行查询，将查询的结果以java.util.List的形式返回，返回的java.util.List中的每个元素都是java.lang.Map类型，分别对应结果集中的一行，Map的键对应每列的列名，Map的值对应当前列名对应的值.

如果这些还不足以满足我们的需要，那么我们可以自己定义回调接口
用于查询的回调接口有以下三种：
org.springframework.jdbc.core.ResultSetExtractor,它是属于JdbcTemplate内部使用的Callback接口，相对于下面的两个接口，这个接口拥有更多的控制权，因为在使用它的时候，我们需要自行的处理ResultSet，该接口的定义如下：

package org.springframework.jdbc.core;

import java.sql.ResultSet;
import java.sql.SQLException;

import org.springframework.dao.DataAccessException;

public interface ResultSetExtractor {

    
    Object extractData(ResultSet rs) throws SQLException, DataAccessException;

}

我们可以将处理的结果以任意的形式包装后返回。

org.springframework.jdbc.core.RowCallbackHandler 相对于ResultSetExtractor，它只关注单行结果的处理，处理的结果可以根据需要存放在当前的RowCallbackHandler，或者使用JdbcTemplate中，当然，这完全看个人喜好，接口定义如下：

package org.springframework.jdbc.core;

import java.sql.ResultSet;
import java.sql.SQLException;

public interface RowCallbackHandler {

    void processRow(ResultSet rs) throws SQLException;

}

org.springframework.jdbc.core.RowMapper  它是 ResultSetExtractor的精简版，功能类似于 RowCallbackHandler，也是只关注当行结果的处理。不过它的返回的结果会有 ResultSetExtractor实现类进行组合。RowMapper的接口定义如下：

package org.springframework.jdbc.core;

import java.sql.ResultSet;
import java.sql.SQLException;

public interface RowMapper {

     Object mapRow(ResultSet rs, int rowNum) throws SQLException; 

}

为了说明这三种回调接口的使用方法，我们暂时设置如下的场景： 假设我们有一表users,里面有userid,username,userpwd三个字段，我们为此建立了一个Javabean

package com.google.spring.jdbc;

public class UserBean
{
    private Integer userId;
    private String username;
    private String userpwd;
    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 getUserpwd()
    {
        return userpwd;
    }
    public void setUserpwd(String userpwd)
    {
        this.userpwd = userpwd;
    }
    
}

使用自定义的ResultSetExtractor，可以如下进行处理：

List users = (List)jdbcTemplate.query("SELECT * FROM USERS WHERE USERNAME LIKE '%n%'", new ResultSetExtractor()
        {
            
            @Override
            public Object extractData(ResultSet rs) throws SQLException,
                    DataAccessException
            {
                List users = new ArrayList();
                while(rs.next())
                {
                    UserBean userBean = new UserBean();
                    userBean.setUserId(rs.getInt("userId"));
                    userBean.setUsername(rs.getString("username"));
                    userBean.setUserpwd(rs.getString("userpwd"));
                    users.add(userBean);
                }
                return users;
            }
        });
        System.out.println(users);

使用RowMapper，可进行如下的处理：

List users = jdbcTemplate.query("SELECT * FROM USERS WHERE USERNAME LIKE '%n%'", new RowMapper()
        {
            
            @Override
            public Object mapRow(ResultSet rs, int rowNum) throws SQLException
            {
                UserBean userBean = new UserBean();
                userBean.setUserId(rs.getInt("userId"));
                userBean.setUsername(rs.getString("username"));
                userBean.setUserpwd(rs.getString("userpwd"));
                return userBean;
            }
        });
        System.out.println(users.size());

使用RowCallbackHandler可进行如下的处理：

final List users = new ArrayList();
        jdbcTemplate.query("SELECT * FROM USERS WHERE USERNAME LIKE '%n%'", new RowCallbackHandler()
        {
            
            @Override
            public void processRow(ResultSet rs) throws SQLException
            {
                UserBean userBean = new UserBean();
                userBean.setUserId(rs.getInt("userId"));
                userBean.setUsername(rs.getString("username"));
                userBean.setUserpwd(rs.getString("userpwd"));
                users.add(userBean);
            }
        });
        System.out.println(users.size());

使用这三种接口的差别如下：