Mybatis 源码分析（一）—— 项目总览说明
1. 项目结构
本文主要分享MyBatis的项目结构，通过本文就可以对MyBatis 的整体项目有个简单的了解。另外提供了MyBatis 的中文文档 (https://mybatis.net.cn)，可以进行查阅。
2. 整体架构
Mybatis 的整体架构分为三层：基础支持层、核心处理层、接口层。如下图：
2.1 接口层
接口层是我们打交道最多的。核心对象是SqlSession，它是上层应用和MyBatis打交道的桥梁，SqlSession中定义了非常多的对数据库的操作方法。接口层在接收到调用请求的时候，会调用核心处理层的相应模块来完成具体的数据库操作。
2.2 核心处理层
核心处理层实现了Mybatis 的核心处理逻辑，包括MyBatis 的初始化和数据库操作相关的动作都是在这一层完成的。
核心处理层主要做了这几件事：
- 把接口中传入的参数解析并且映射成JDBC类型；
- 解析xml文件中的SQL语句，包括插入参数，和动态SQL的生成；
- 执行SQL语句；
- 处理结果集，并映射成Java对象。
2.2.1 配置解析
对应 builder 和 mapping 包。builder 为配置解析过程，mapping 为SQL操作解析后的映射。
在 MyBatis 初始化过程中，会加载 mybatis-config.xml 全局配置文件、映射配置文件以及 Mapper 接口中的注解信息，解析后的配置信息会形成相应的对象并保存到 Configuration 对象中。 例如： <resultMap>节点(即 ResultSet 的映射规则) 会被解析成 ResultMap 对象。 <result> 节点(即属性映射)会被解析成 ResultMapping 对象。
利用该 Configuration 对象创建 SqlSessionFactory对象。待 MyBatis 初始化之后，可以通过初始化得到 SqlSessionFactory 创建 SqlSession 对象并完成数据库操作。
2.2.2 SQL解析
对应 scripting 包。
拼凑 SQL 语句是一件烦琐且易出错的过程，为了从这项枯燥无趣的工作中解脱出来，MyBatis 实现动态 SQL 语句的功能，提供了多种动态 SQL语句对应的节点。 例如： <where> 节点、<if> 节点、<foreach> 节点等 。通过这些节点的组合使用， 写出几乎满足所有需求的动态 SQL 语句。 MyBatis 中的 scripting 模块，会根据用户传入的实参，解析映射文件中定义的动态 SQL 节点，并形成数据库可执行的 SQL 语句。
之后会处理 SQL 语句中的占位符，绑定用户传入的实参。
2.2.3 SQL执行
对应 executor 和 cursor 包。executor 对应解析器，cursor 对应执行结果的油标。
SQL 语句的执行涉及多个组件 ，其中比较重要的是 Executor、StatementHandler、ParameterHandler 和 ResultSetHandler 。 Executor 主要负责维护一级缓存和二级缓存，并提供事务管理的相关操作，它会将数据库相关操作委托给 StatementHandler完成。
StatementHandler 首先通过 ParameterHandler 完成 SQL 语句的实参绑定，然后通过 java.sql.Statement 对象执行 SQL 语句并得到结果集，最后通过 ResultSetHandler 完成结果集的映射，得到结果对象并返回。
2.2.4 插件层
对应 plugin 包。
插件也属于核心层，这是由它的工作方式和拦截的对象决定的。
Mybatis 自身的功能虽然强大，但是并不能完美切合所有的应用场景，因此 MyBatis 提供了插件接口，我们可以通过添加用户自定义插件的方式对 MyBatis 进行扩展。用户自定义插件也可以改变 Mybatis 的默认行为。
例如，我们可以拦截 SQL 语句并对其进行重写。 由于用户自定义插件会影响 MyBatis 的核心行为，在使用自定义插件之前，开发人员需要了解 MyBatis 内部的原理，这样才能编写出安全、高效的插件。
2.3 基础支持层
基础支持层主要是一些抽取出来的通用的功能（实现复用），用来支持核心处理层的功能。比如数据源、缓存、日志、xml解析、反射、IO、事务等等这些功能。
2.3.1 反射模块
对应 reflection 包。
Java 中的反射虽然功能强大，但对大多数开发人员来说，写出高质量的反射代码是有一定难度的。 MyBatis 中专门提供了反射模块，该模块对 Java 原生的反射进行了良好的封装，提了更加简洁易用的 API，方便上层使调用，并且对反射操作进行了一系列优化。
例如：缓存了类的元数据，提高了反射操作的性能。
2.3.2 类型转换模块
对应 type 包。
类型转换主要做以下两点：
- MyBatis 为简化配置文件提供了别名机制，该机制是类型转换模块的主要功能之一。
- 类型转换模块的另一个功能是实现 JDBC 类型与 Java 类型之间的转换，该功能在为 SQL 语句绑定实参以及映射查询结果集时都会涉及： 在为 SQL 语句绑定实参时，会将数据由 Java 类型转换成 JDBC 类型。 而在映射结果集时，会将数据由 JDBC 类型转换成 Java 类型。
2.3.3 日志模块
对应 logging 包。
无论在开发测试环境还是在线上生产环境中，日志在整个系统中的地位都是非常重要的。良好的日志功能可以帮助开发人员和测试人员快速定位 Bug 代码，也可以帮助运维人员快速定位性能瓶颈等问题。
目前的 Java 世界中存在很多优秀的日志框架，例如 Log4j、 Log4j2、Slf4j 等。 MyBatis 作为一个设计优良的框架，除了提供详细的日志输出信息，还要能够集成多种日志框架，其日志模块的一个主要功能就是集成第三方日志框架。
2.3.4 解析器模块
对应 parsing 包。
解析器模块，主要提供了两个功能：
- 对 XPath 进行封装，为 MyBatis 初始化时解析 mybatis-config.xml 全局配置文件以及映射配置文件提供支持。
- 为处理动态 SQL 语句中的占位符提供支持。
2.3.5 数据源模块
对应 datasource 包。
数据源是实际开发中常用的组件之一。现在开源的数据源都提供了比较丰富的功能，例如，连接池功能、检测连接状态等，选择性能优秀的数据源组件对于提升 ORM 框架乃至整个应用的性能都是非常重要的。
MyBatis 自身提供了相应的数据源实现，当然 MyBatis 也提供了与第三方数据源集成的接口，这些功能都位于数据源模块之中。
2.3.6 事务管理模块
对应 transaction 包。
MyBatis 对数据库中的事务进行了抽象，其自身提供了相应的事务接口和简单实现。 在很多场景中，MyBatis 会与 Spring 框架集成，并由 Spring 框架管理事务。
2.3.7 缓存模块
对应 cache 包。
在优化系统性能时，优化数据库性能是非常重要的一个环节，而添加缓存则是优化数据库时最有效的手段之一。正确、合理地使用缓存可以将一部分数据库请求拦截在缓存这一层。
MyBatis 中提供了一级缓存和二级缓存，而这两级缓存都是依赖于基础支持层中的缓存模块实现的。这里需要注意的是，MyBatis 中自带的这两级缓存与 MyBatis 以及整个应用是运行在同一个 JVM 中的，共享同一块堆内存。
如果这两级缓存中的数据量较大，则可能影响系统中其他功能的运行，所以当需要缓存大量数据时，优先考虑使用 Redis、Memcache 等缓存产品。
2.3.8 Bingding模块
对应 bingding 包。
在调用 SqlSession 相应方法执行数据库操作时，需要指定映射文件中定义的 SQL 节点，如果出现拼写错误，我们只能在运行时才能发现相应的异常。
为了尽早发现这种错误，MyBatis 通过 Binding 模块，将用户自定义的 Mapper 接口与映射配置文件关联起来，系统可以通过调用自定义 Mapper 接口中的方法执行相应的 SQL 语句完成数据库操作，从而避免上述问题。
值得注意的是，开发人员无须编写自定义 Mapper 接口的实现，MyBatis 会自动为其创建动态代理对象。在有些场景中，自定义 Mapper 接口可以完全代替映射配置文件，但有的映射规则和 SQL 语句的定义还是写在映射配置文件中比较方便，例如动态 SQL 语句的定义。
2.3.9 资源加载模块
对应 io 包。
资源加载模块，主要是对类加载器进行封装，确定类加载器的使用顺序，并提供了加载类文件以及其他资源文件的功能 。
2.3.10 注解模块
对应 annotation 包。
随着 Java 注解的慢慢流行，MyBatis 提供了注解的方式，使得我们方便的在 Mapper 接口上编写简单的数据库 SQL 操作代码，而无需像之前一样，必须编写 SQL 在 XML 格式的 Mapper 文件中。虽然说，实际场景下，大家还是喜欢在 XML 格式的 Mapper 文件中编写响应的 SQL 操作。
2.3.11 异常模块
对应 exception 包。
定义了 MyBatis 专有的 PersistenceException 和 TooManyResultsException 异常。
最后给出MyBatis的主要工作流程图：
浙公网安备 33010602011771号