spring jdbc 之二

spring jdbcTemplate 提供了很多查询和更新功能，但是如果我们需要高层次的抽象spring还有个RDBMS其中包括了SqlQuery,MappingSqlQuery,SqlUpdate等
我们首先来看下一个简单的查询简单例子
public class BokkQuery extends MappingSqlQuery<VersionInfo>
{
public BokkQuery(DataSource dataSource)
{
super(dataSource, "select * from t_soft_version t where t.id=?");
//设置参数
super.declareParameter(new SqlParameter("id", Types.INTEGER));
compile();
}

@Override
protected VersionInfo mapRow(ResultSet rs, int i) throws SQLException
{
VersionInfo versionInfo = new VersionInfo();
versionInfo.setId(rs.getInt("id"));
versionInfo.setVersion_name(rs.getString("version_name"));
return versionInfo;
}
}

public static void main(String[] args)
{
DataSource dataSource = (DataSource) cxf.getBean("dataSource");
BokkTest test = new BokkTest();
test.listbook(dataSource);
}

public void listbook(DataSource dataSource)
{
BokkQuery bokkQuery = new BokkQuery(dataSource);
List<VersionInfo> list = bokkQuery.execute(new Object[]{11111});
for (VersionInfo versionInfo : list)
{
System.out.println("versionname:" + versionInfo.getVersion_name());
}

}


首先我们看下RdbmsOperation下其类的结构图：



下面我们从declareParameter入手分下一下该功能是如何实现的，其具体的实现在MappingQuery的基类RdbmsOperation的源码可以看到
RdbmsOperation源码如下：
public abstract class RdbmsOperation
implements InitializingBean
{

public void declareParameter(SqlParameter param)
throws InvalidDataAccessApiUsageException
{
//声明参数只能在compile之前，否则声明是无效的，并会抛出异常
if(isCompiled())
{
throw new InvalidDataAccessApiUsageException("Cannot add parameters once the query is compiled");
} else
{
//把参数添加到一个LinkedList集合的属性中,供compile方法使用
declaredParameters.add(param);
return;
}
}

//我们看到了compile
public final void compile()
throws InvalidDataAccessApiUsageException
{
if(!isCompiled())
{
if(getSql() == null)
throw new InvalidDataAccessApiUsageException("Property 'sql' is required");
try
{
//调用了afterPropertesSet方法
jdbcTemplate.afterPropertiesSet();
}
catch(IllegalArgumentException ex)
{
throw new InvalidDataAccessApiUsageException(ex.getMessage());
}
//调用compileInternal完成具体的compile过程，并设置compiled标志位
compileInternal();
compiled = true;
if(logger.isDebugEnabled())
logger.debug((new StringBuilder("RdbmsOperation with SQL [")).append(getSql()).append("] compiled").toString());
}
}

public void afterPropertiesSet()
{
compile();
}
}

compileInternal方法在sqlOperation里完成，在compileInternal中生成一个PreparedStatementCreatorFactory作为Statement的工厂，这个工厂负责生成参数的Statement，其源码如下：

protected final void compileInternal()
{
preparedStatementFactory = new PreparedStatementCreatorFactory(getSql(), getDeclaredParameters());
preparedStatementFactory.setResultSetType(getResultSetType());
preparedStatementFactory.setUpdatableResults(isUpdatableResults());
preparedStatementFactory.setReturnGeneratedKeys(isReturnGeneratedKeys());
if(getGeneratedKeysColumnNames() != null)
preparedStatementFactory.setGeneratedKeysColumnNames(getGeneratedKeysColumnNames());
preparedStatementFactory.setNativeJdbcExtractor(getJdbcTemplate().getNativeJdbcExtractor());
onCompileInternal();
}


在完成compile之后，对MappingSqlQuery的准备工作就基本完成，在执行查询时，实际执行的是SqlQuery的executeByNameParam方法，这个方法需要完成的工作包括配置sql语句，配置数据记录对象转换RowMapper，然后使用JdbcTemplate来完成数据的查询，并启动数据记录到java数据对象的转换，其源码如下:

public List executeByNamedParam(Map paramMap, Map context)
throws DataAccessException
{
validateNamedParameters(paramMap);
//需要执行sql语句
org.springframework.jdbc.core.namedparam.ParsedSql parsedSql = getParsedSql();
MapSqlParameterSource paramSource = new MapSqlParameterSource(paramMap);
String sqlToUse = NamedParameterUtils.substituteNamedParameters(parsedSql, paramSource);
//配置好SQL语句需要的Paramters即rowMapper，这个Rowmapper完成数据记录对象的转换
Object params[] = NamedParameterUtils.buildValueArray(parsedSql, paramSource, getDeclaredParameters());
RowMapper rowMapper = new RowMapper(params, context);
//转换成Rowmapper调用的是jdbcTemplate中的模板方法
return getJdbcTemplate().query(newPreparedStatementCreator(sqlToUse, params), rowMapper);
}