java mybatis怎么读源码

阅读 MyBatis 源码是理解其设计思想和提升 Java 开发能力的好方式。下面从准备 → 阅读路径 → 核心模块 → 调试技巧几个方面，系统讲一下「Java MyBatis 怎么读源码」。

一、源码准备

1. 获取源码

推荐从 GitHub 拉取官方源码：

git clone https://github.com/mybatis/mybatis-3.git

建议：

• 使用 稳定版本 tag（如 mybatis-3.5.x）
• 用 IntelliJ IDEA 打开（对 Java 源码支持最好）

2. 了解模块结构

MyBatis 核心模块（mybatis-3）：

org.apache.ibatis
 ├── session        // SqlSession 相关
 ├── binding        // Mapper 接口绑定
 ├── builder        // 配置解析
 ├── mapping        // SQL 映射
 ├── executor       // 执行器
 ├── plugin         // 插件（拦截器）
 ├── type           // 类型处理器
 ├── transaction    // 事务
 └── datasource     // 数据源

二、推荐阅读顺序（由浅入深）

✅ 第一阶段：从“使用”反推源码

不要一上来就读底层

1. 写一个简单的 MyBatis 示例

SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);

2. 带着问题读：

• SqlSessionFactory 是怎么创建的？
• getMapper() 返回的是什么？
• SQL 是怎么执行的？

✅ 第二阶段：配置加载流程（入口）

核心类：

• SqlSessionFactoryBuilder
• XMLConfigBuilder
• Configuration

阅读路径：

SqlSessionFactoryBuilder.build()
 → XMLConfigBuilder.parse()
   → Configuration 初始化

重点理解：

• Configuration 是 MyBatis 的“全局配置中心”
• Mapper、ResultMap、TypeHandler 都在这里注册

✅ 第三阶段：SqlSession 与 Executor

核心类：

• SqlSession
• DefaultSqlSession
• Executor
  • SimpleExecutor
  • ReuseExecutor
  • BatchExecutor

阅读路径：

SqlSession.selectOne()
 → Executor.query()
   → StatementHandler
     → ParameterHandler
     → ResultSetHandler

理解重点：

• Executor 是 SQL 执行的核心
• 一级缓存就在 Executor 中

✅ 第四阶段：Mapper 接口是怎么“变成 SQL”的

核心类：

• MapperProxy
• MapperMethod
• SqlCommand

阅读路径：

session.getMapper()
 → MapperProxy（JDK 动态代理）
   → MapperMethod.execute()

重点：

• Mapper 接口不是实现类
• 靠 动态代理 + 注解/XML 执行 SQL

✅ 第五阶段：SQL 执行细节

核心类：

• StatementHandler
• PreparedStatementHandler
• ParameterHandler
• ResultSetHandler

理解：

• SQL 参数设置
• 结果集映射（ResultMap）
• 类型转换（TypeHandler）

三、调试技巧（非常重要）

1. 写测试代码调试

在 src/test 下写 Demo：

@Test
public void testSelect() {
    // 单步调试
}

2. 打日志

<setting name="logImpl" value="STDOUT_LOGGING"/>

3. 关键断点位置

• SqlSessionFactoryBuilder.build
• DefaultSqlSession.selectList
• Executor.query
• MapperProxy.invoke

四、建议的学习资料

• 官方文档（先懂用法）
• 《MyBatis 技术内幕》
• 源码注释（英文但很清晰）
• Debug 比“硬读”更高效

五、一句话总结

MyBatis 源码 = 配置解析 + 动态代理 + 执行器 + JDBC 封装

如果你愿意，我也可以：

• 带你 逐行讲一个查询流程
• 画 MyBatis 执行时序图
• 对比 MyBatis vs JPA 源码设计

你想从哪一部分开始？