最近在思考一个问题：如何能够更好的分享主流框架源码学习笔记（主要是源码部分）?让有缘刷到的同学既可以有所收获，还能保持对相关技术架构探讨学习热情和兴趣。以及自己也保持较高的分享热情和动力。
今天尝试用一个SQL查询作为引子，去解构Mybatis的核心原理和关键源码处理流程。这种更加贴合工作实践方式，相信可以降低探索核心源码门槛。
一、前言背景
二、Mybatis概述
三、Mybatis的核心原理
3.1 Mybatis核心功能处理流程
3.1.1 解析配置-加载并解析Mapper配置文件
3.1.2 创建连接-创建SqlSessionFactory并获取sqlSession连接
3.1.3 执行SQL语句-Executor
3.1.4 结果数据封装 MapperStatement & ResultSetHandler
3.1.5 关闭连接
四、核心功能特性
4.1 支持动态灵活的SQL
4.2 详解一级、二级缓存机制
4.2.1 二级缓存为什么默认不开启？
4.3 支持插件扩展
4.4 延迟加载
4.5 SQL注解
一、前言背景
在10多年前，那时候刚开始工作，移动互联网还没发展起来，Mybatis还没流行，后端应用开发，主流用的是SSH框架。回想那时候的Hibernate、Spring，配置多又杂，其实对新手并不友好。然而相比手写JDBC连接管理、繁琐的结果数据转换，让SSH当年也是火了好几年。
随着Hibernate和Mybatis的不断发展，研发人员成功解放手写JDBC数据库连接查询相关研发工作。他们都是优秀的ORM对象关系映射管理框架，也就是持久层框架。但是Hibernate存在对复杂sql关系支持弱、不支持存储过程、性能差、调优难、全表映射复杂等问题，用的人越来越少。
而后起之秀Mybatis，当今最经典ORM框架，由于其灵活易用、好扩展、支持复杂SQL、出色的性能，较好的平衡对象关系映射管理和SQL编写支持，称为半ORM框架，已经成功替代Hibernate。
今天我们梳理Mybatis的核心原理和工作流程，以及重点分析它的一些核心功能特性。
二、Mybatis概述
Mybatis是一个持久层框架，具体就是用来操作数据库数据，并转换成目标对象的技术框架。它的核心在于将表数据和对象实例进行关联映射，也就是ORM（object relation Mapping）。
Mybatis之所以可以替换Hibernate，主要是支持SQL定制、高级的映射管理功能、缓存机制、还有存储过程(由于大数据技术发展，目前存储过程用的人也越来越少，但是在那个年代支持存储过程非常实用)。Mybatis灵活可扩展高性能的特性，让我们开发读写数据，几乎不需要编程，主要做的工作就是编写Mapper配置文件，把SQL和对象关系映射管理好，就可以实现CRUD。而多类型数据库的切换迁移，对系统应用来说，简单到只需要替换JDBC的驱动。
三、Mybatis的核心原理
如上所述，Mybatis核心工作就是帮助研发人员对数据库的读写操作，简化成面向对象操作。
对于一个完全不懂Mybatis或者ORM的人来说，如果要实现读写数据库，该怎么实现？这个相信很多人都能回答：通过jdbc连接数据库、执行SQL、解析sql数据结果，就三个步骤完成。
而Mybatis的核心原理逻辑更加细化，但整体也是类似以上三个步骤。毕竟大家目标一致，只是实现过程不同而已。
接下来我们用一个非常简单的demo，就是通过Mybatis去读数据库数据，demo就只有几行代码，然后循序渐进了解Mybatis的核心工作原理，以及核心源码组件功能。
package com.lading.mybaties; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import java.io.IOException; import java.io.InputStream; public class MyBatisDemo { public static void main(String[] args) throws IOException { InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); try (SqlSession sqlSession = sqlSessionFactory.openSession()) { sqlSession.selectOne("com.lading.mapper.UserMapper.getUserById", 1); } } }
3.1 Mybatis核心功能处理流程
Mybatis整体框架，基于面向对象思想去实现与数据库表数据交互，它的核心步骤按顺序处理有以下五个。
3.1.1 解析配置-加载并解析Mapper配置文件
Mybatis通过SqlSessionFactoryBuilder来加载解析配置文件，并生SqlSessionFactory。
SqlSessionFactoryBuilder是Mybatis的入口类，类似tomcat的org.apache.catalina.startup.Bootstrap 启动类。
比如我们项目只有Mybatis包、jdbc驱动，想要基于Mybatis去读写数据，首先需要通过以下三行代码去解析你的Mybatis相关配置文件，以及构建一个SqlSessionFactory，为后续创建数据库连接和读写做准备。
String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
这三行代码里最后一行，看源码会发现，里面做了非常多的工作，细无巨细的把Mybatis管理配置文件、还有对象sql映射Mapper文件一一解析，包括properties、settings、environment、mapper等标签数据，以及业务相关的mapper文件里的resultMap、CURD 标签都会转成configration对象属性。
最后利用解析结果数据存放的对象configration去实例化构建sql 会话工厂：
new DefaultSqlSessionFactory(config)。
3.1.2 创建连接-创建SqlSessionFactory并获取sqlSession连接
解析完成配置文件后，Mybatis框架已经清晰知道Mybatis的基础配置信息、连接数据库的类型、用户密码信息，还有相关表映射关系。
通过SqlSessionFactoryBuilder构建了session工厂实例SqlSessionFactory，看名字可以知道是通过建造者模式去实例化该对象。
SqlSessionFactory是Mybatis的核心接口，它就是用来负责实现管理会话连接。
在应用启动或者需要用到Mybatis读写数据时候，就生成一个实例DefaultSqlSessionFactory（它是session工厂接口唯一实现类）。
SqlSessionFactory，通常在应用里是全局唯一并共享。
然后通过会话工厂实例sqlSessionFactory去开启一个session连接：
SqlSession sqlSession = sqlSessionFactory.openSession();
SqlSession就是真正负责执行sql、并且管理事务的核心功能类，它底层是jdbc的连接。
session每次用完就关闭，需要用的时候再次新建。但是Mybatis也有实现对应的连接池，如果配置了连接池就不会关闭。 Mybatis的连接池，后面出一篇文章专门分享Mybatis如何管理连接池。
比如，通过session去查询用户ID=1的用户数据：
SqlSession sqlSession = sqlSessionFactory.openSession(); UserMapper userMapper = sqlSession.getMapper(UserMapper.class); User ladingUser = userMapper.selectUserById(1); System.out.println(ladingUser);
3.1.3 执行SQL语句-Executor
在3.1.2里，看起来sql session执行了sql查询，但是DefaultSqlSession里面封装了一个Executor执行器。
Executor执行器，它是真正负责执行sql的打工人，里面有一个抽象类BaseExecutor，通过模板方法模式去共享自己的模板方法能力。另外三个子类去继承实现不同的db操作。
这三个执行器的主要区别在于：
SimpleExecutor，是一个最简单的执行器，每次执行sql都新建一个Statement对象。
比如它里面的query方法源码：
@Override public <E> List<E> doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException { // JDBC中 Statement接口 Statement stmt = null; try { // 获取到Configuration对象 Configuration configuration = ms.getConfiguration(); StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql); // 里面创建Connection代理对象，新增这个Statement stmt = prepareStatement(handler, ms.getStatementLog()); // 执行查询，封装结果集 return handler.query(stmt, resultHandler); } finally { closeStatement(stmt); } }
ReuseExecutor，顾名思义是可复用执行器。特点是，复用预处器PreparedStatement。
比如获取预处理Statement的方法源码：
而BatchExcutor，叫做批量执行器，支持批量处理SQL语句。
3.1.4 结果数据封装 MapperStatement & ResultSetHandler
结果数据封装逻辑里面相对繁琐。实际上在Excutor执行sql之前，也依赖mapperStatement去封装sql语句、sql的入参。底层通过jdbc connection执行sql后，通过ResultSetHandler和TypeHandler去解析封装结果数据。
3.1.5 关闭连接
最后是关闭sqlsession，释放资源。如果是配置应用连接池，就是归还连接操作。
四、核心功能特性
4.1 支持动态灵活的SQL
直接允许在mapper XML文件配置动态的sql。包括if、where、choose、when、foreach等多种动态条件。这个能力让Mybatis成功支持复杂关联sql处理。
4.2 详解一级、二级缓存机制
Mybatis支持缓存，大幅提升数据库查询性能。默认开启一级缓存，关闭二级缓存。
一级缓存：是基于sqlsession去实现，同一个sql session多次查询，会复用相同sql 的缓存结果。底层是通过把一个SQL的id、名称、入参计算得到一个唯一key，并和结果数据存入一个map里。
当同一个sql session后面重复的查询，就会判断缓存是否有数据，如果有就直接返回，不再继续从数据库里查询数据，大幅提升单个sql session里的重复查询效率。
如果在一个sql session里出现了update、delete、insert、或者commit、close session操作，就会自动去清空缓存，确保没有脏数据在Mybatis一级缓存里。
该缓存默认开启。如果要关闭，可以通过flushCache=true去关闭。
二级缓存：是基于mapper，也就是命名空间级别的缓存。相当于sqlSessionFactory级别，比一级缓存sqlSession更高一个层级。在同一个mapper下，所有session会话产生的缓存数据统一在mapper里命名空间管理。多个mapper的二级缓存互不干扰。
二级缓存，默认是关闭的。可以在mapper里，新增cache标签就可以开启。
<mapper namespace="com.lading.mapper.UserMapper"> <!--启用二级缓存--> <cache eviction="FIFO" flushInterval="30000" readOnly="true"/> </mapper>
4.2.1 二级缓存为什么默认不开启？
之所以默认关闭，主要因为二级缓存可能有脏读。
正因为所有session会话产生的缓存数据，统一在mapper里命名空间管理，多个mapper的二级缓存互不干扰。这里就可能导致研发人员如果在另一个mapper新增或者修改了数据，其他地方mapper缓存的数据就没有被自动更新，就会造成生产故障。
当然这个Mybatis有提供相关配置，支持关联mapper同步被动去清空二级缓存，避免干扰。
4.3 支持插件扩展
Mybatis允许研发人员在核心组件中插入自定义的逻辑，比如分页、拦截器、性能监控插件功能 。
插件的开发，可以通过实现 org.apache.ibatis.pluginInterceptor接口，然后实现里面 intercept、plugin 和 setProperties方法来新增插件功能。
比如增加一个执行sql监控功能。
package com.lading.mybaties; import org.apache.ibatis.executor.Executor; import org.apache.ibatis.mapping.MappedStatement; import org.apache.ibatis.plugin.*; import java.util.Properties; public class TimeMonitorPlugin implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { long startTime = System.currentTimeMillis(); Object result = invocation.proceed(); // 执行目标方法 long endTime = System.currentTimeMillis(); System.out.println("SQL 执行耗时: " + (endTime - startTime) + "ms"); return result; } @Override public Object plugin(Object target) { return Plugin.wrap(target, this); } @Override public void setProperties(Properties properties) { // 可以设置拦截器的属性 } }
在 mybatis-config.xml 文件中注册自定义拦截器：
<plugins> <plugin interceptor="lading.mybaties.TimeMonitorPlugin"/> </plugins>
sql查询的时候就会打印sql执行时间。
4.4 延迟加载
可以控制关联对象，在需要用到的时候才去加载。比如1-n的场景，一个学生有多门课程信息。查询一个学生基本信息的时候，如果没有用到课程列表，就不需要在关联查询里把课程列表页拉出去，提升了查询效率。
//fetchType=lazy开启延迟加载 <association property="xxx" fetchType="lazy">
这个延迟加载功能，和Springboot通过@lazy注解去解决循环依赖问题，有类似异曲同工的作用。
4.5 SQL注解
MyBatis 也支持使用注解来配置 SQL 映射，从而简化 XML 配置，可以实现零xml配置文件去操作数据库数据。常用的注解包括常规的CURD：
@Select
@Insert
@Update
@Delete
还有，@Results结果映射注解。
比如通过名称去查询用户：
@Select("SELECT * FROM user WHERE name = #{name}") @Results({ @Result(property = "id", column = "id"), @Result(property = "name", column = "name") }) User selectUserByName(String name);
