Spring JDBC最佳实践(3)

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());

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