mybatis-ResultHandler解析

概述

结果值的处理相当于参数的处理会复杂一些，负责结果值转换的类是 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(