概述
结果值的处理相当于参数的处理会复杂一些,负责结果值转换的类是 ResultSetHandler
public interface ResultSetHandler {
/**
* 处理数据集并返回
* @param stmt
* @param <E>
* @return
* @throws SQLException
*/
<E> List<E> handleResultSets(Statement stmt) throws SQLException;
<E> Cursor<E> handleCursorResultSets(Statement stmt) throws SQLException;
void handleOutputParameters(CallableStatement cs) throws SQLException;
}
这里将存储过程、游标相关的忽略,我们只看普通的处理就行。
相当于就一个方法handleResultSets,处理ResultSet转换结果值。
ResultSetHandler只有一个实现类,即DefaultResultSetHandler。
但在解析结果值的时候还依赖一些其他的类。
ResultSetWrapper:ResultSet包装器,丰富ResultSet方法,包含了ResultSet相关元数据
ResultContext:结果值上下文,存储值结果值、总数等。
ResultHandler:结果处理器。做处理完的类型转换的结果,进行后置处理。
ResultSetWrapper
public class ResultSetWrapper {
/**
* 数据集
*/
private final ResultSet resultSet;
private final TypeHandlerRegistry typeHandlerRegistry;
/**
* 字段名集合
*/
private final List<String> columnNames = new ArrayList<>();
/**
* 字段对应的javaType类型名
*/
private final List<String> classNames = new ArrayList<>();
/**
* jdbcType
*/
private final List<JdbcType> jdbcTypes = new ArrayList<>();
// 类型处理器
private final Map<String, Map<Class<?>, TypeHandler<?>>> typeHandlerMap = new HashMap<>();
/**
* 针对当前ResultSet中,resultMap中映射的字段名
* key: resultMapId
* value:resultMap映射字段
*/
private final Map<String, List<String>> mappedColumnNamesMap = new HashMap<>();
/**
* 针对当前ResultSet中,resultMap中未映射的字段名
* key: resultMapId
* value:resultMap未映射字段
*/
private final Map<String, List<String>> unMappedColumnNamesMap = new HashMap<>();
public ResultSetWrapper(ResultSet rs, Configuration configuration) throws SQLException {
super();
this.typeHandlerRegistry = configuration.getTypeHandlerRegistry();
this.resultSet = rs;
// 从ResultSet中获取元数据
final ResultSetMetaData metaData = rs.getMetaData();
// 总列数
final int columnCount = metaData.getColumnCount();
for (int i = 1; i <= columnCount; i++) {
// columnLabel代表as的值,columnName代表原名
// 默认取columnLabel的值
columnNames.add(configuration.isUseColumnLabel() ? metaData.getColumnLabel(i) : metaData.getColumnName(i));
// 每个字段对应的jdbc类型
jdbcTypes.add(JdbcType.forCode(metaData.getColumnType(i)));
// 每个字段对应的java类型
classNames.add(metaData.getColumnClassName(i));
}
}
}
ResultSetWrapper包装了ResultSet,通过ResultSetMetaData(JDBC)获取列信息。结合ResultMap进行列相关方法的提供。
看下ResultSetWrapper提供的所有方法:
基本是针对自身属性提供的get方法,了解了各个属性的意义之后,方法的作用也就比较清楚了。
ResultContext
public interface ResultContext<T> {
T getResultObject();
int getResultCount();
boolean isStopped();
void stop();
}
结果的载体,实现类 DefaultResultContext
DefaultResultContext
public class DefaultResultContext<T> implements ResultContext<T> {
/**
* 结果值
*/
private T resultObject;
/**
* 累计的结果数量
*/
private int resultCount;
/**
* 是否停止
*/
private boolean stopped;
public DefaultResultContext() {
resultObject = null;
resultCount = 0;
stopped = false;
}
@Override
public T getResultObject() {
return resultObject;
}
@Override
public int getResultCount(