Mybatis如何执行Select语句

撸起袖子就是干

• 二话不说，先来一张流程图，Mybatis六剑客，如下：

  

• 上图中的这六剑客在前面两篇文章中已经介绍的非常清楚了，此处略过。为什么源码解析的每一篇文章中都要放一张这个流程图呢？因为Mybatis底层就是围绕着这六剑客展开的，我们需要从全局掌握Mybatis的源码究竟如何执行的。

测试环境搭建

• 举个栗子：根据用户id查询用户信息，Mapper定义如下：

List<UserInfo> selectList(@Param("userIds") List<String> userIds);

• 对应XML配置如下：

<mapper namespace="cn.cb.demo.dao.UserMapper">
    <!--开启二级缓存-->
    <cache/>
    <select id="selectList" resultType="cn.cb.demo.domain.UserInfo">
        select * from user_info where status=1
        and user_id in
        <foreach collection="userIds" item="item" open="(" separator="," close=")" >
            #{item}
        </foreach>
    </select>
</mapper>

• 单元测试如下：

    @Test
    void contextLoads() {
        List<UserInfo> userInfos = userMapper.selectList(Arrays.asList("192","198"));
        System.out.println(userInfos);
    }

DEBUG走起

• 具体在哪里打上断点，上篇文章已经讲过了，不再赘述了。

• 由于SpringBoot与Mybatis整合之后，自动注入的是SqlSessionTemplate，因此代码执行到org.mybatis.spring.SqlSessionTemplate#selectList(java.lang.String, java.lang.Object)，如图1：

  

• 从源码可以看到，实际调用的还是DefaultSqlSession中的selectList方法。如下图2：

  

• 「具体的逻辑如下」：

  1. 根据Mapper方法的全类名从Mybatis的配置中获取到这条SQL的详细信息，比如paramterType,resultMap等等。

  2. 既然开启了二级缓存，肯定先要判断这条SQL是否缓存过，因此实际调用的是CachingExecutor这个缓存执行器。

• DefaultSqlSession只是简单的获取SQL的详细配置，最终还是把任务交给了Executor（当然这里走的是二级缓存，因此交给了缓存执行器）。下面DEBUG走到CachingExecutor#query(MappedStatement, java.lang.Object, RowBounds,ResultHandler)，源码如下图3：

  

• 上图中的query方法实际做了两件事，实际执行的查询还是其中重载的方法List<E> query(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql)，如下图4：

  

• 根据上图源码的分析，其实CachingExecutor执行的逻辑并不是很难，反倒很容易理解，「具体的逻辑如下」：

  1. 如果开启了二级缓存，先根据cacheKey从二级缓存中查询，如果查询到了直接返回

  2. 如果未开启二级缓存，再执行BaseExecutor中的query方法从一级缓存中查询。

  3. 如果二级缓存中未查询到数据，再执行BaseExecutor中的query方法从一级缓存中查询。

  4. 将查询到的结果存入到二级缓存中。

• BaseExecutor中的query方法无非就是从一级缓存中取数据，没查到再从数据库中取数据，一级缓存实际就是一个Map结构，这里不再细说，真正执行SQL从数据库中取数据的是SimpleExecutor中的public <E> List<E> doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql)方法，源码如下图5：

  

• 从上面的源码也是可以知道，在真正执行SQL之前，是要调用prepareStatement(handler, ms.getStatementLog())方法做一些参数的预处理的，其中涉及到了六大剑客的另外两位，分别是ParameterHandler和TypeHandler，源码如图6：

  

• 从上图可以知道设置SQL参数的真正方法是handler.parameterize(stmt)，真正执行的是DefaultParameterHandler中的setParameters方法，由于篇幅较长，简单的说一下思路：

  1. 获取所有参数的映射

  2. 循环遍历，获取参数的值，使用对应的TypeHandler将其转换成相应类型的参数。

  3. 真正的设置参数的方法是TypeHandler中setParameter方法

• 继续图6的逻辑，参数已经设置完了，此时就该执行SQL了，真正执行SQL的是PreparedStatementHandler中的<E> List<E> query(Statement statement, ResultHandler resultHandler)方法，源码如下图7：

  

• 上图的逻辑其实很简单，一个是JDBC执行SQL语句，一个是调用六剑客之一的ResultSetHandler对结果进行处理。

• 真正对结果进行处理的是DefaultResultSetHandler中的handleResultSets方法，源码比较复杂，这里就不再展示了，具体的逻辑如下：

  1. 获取结果映射(resultMap)，如果没有指定，使用内置的结果映射

  2. 遍历结果集，对SQL返回的每个结果通过结果集和TypeHandler进行结果映射。

  3. 返回结果

• ResultSetHandler对结果处理结束之后就会返回。至此一条selectList()如何执行的大概心里已经有了把握，其他的更新，删除都是大同小异。

总结

• Mybatis的源码算是几种常用框架中比较简单的，都是围绕六大组件进行的，只要搞懂了每个组件是什么角色，有什么作用，一切都会很简单。

• 一条select语句简单执行的逻辑总结如下（前提：「默认配置」）：

  1. 「SqlSesion」：#SqlSessionTemplate.selectList()实际调用#DefaultSqlSession.selectList()

  2. 「Executor」：#DefaultSqlSession.quer()实际调用的是#CachingExecutor().query()，如果二级缓存中存在直接返回，不存在调用#BaseExecutor.quer()查询一级缓存，如果一级缓存中存在直接返回。不存在调用#SimpleExecutor.doQuery()方法查询数据库。

  3. 「StatementHandler」：#SimpleExecutor.doQuery()生成StatementHandler实例，执行#PreparedStatementHandler.parameterize()方法设置参数，实际调用的是#ParamterHandler.setParameters()方法，该方法内部调用TypeHandler.setParameter()方法进行类型转换;参数设置成功后，调用#PreparedStatementHandler.parameterize().query()方法执行SQL，返回结果

  4. 「ResultSetHandler」：#DefaultResultSetHandler.handleResultSets()对返回的结果进行处理，内部调用#TypeHandler.getResult()对结果进行类型转换。全部映射完成，返回结果。