MyBatis核心源码知识点

最新推荐文章于 2025-07-04 16:45:07 发布
原创 最新推荐文章于 2025-07-04 16:45:07 发布 · 1.8k 阅读 · 11 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
java

当前文章被收录于：

java
35 篇文章 2 人学习
订阅专栏 查看详情

0 前言

MyBatis是什么？
解决了使用jdbc操作数据库的弊端，用JDBC去操作数据库，弊端有如下几点。
1.首先，数据库配置、SQL语句在代码中硬编码、可维护性差。
2.JDBC频繁创建和关闭连接数据库，消耗资源。利用连接池，避免反复连接和销毁。
3.一二级缓存， 查询语句不变的话，直接取缓存中的数据。
4.参数的设置，封装查询数据比较麻烦。
5.返回结果数据获取，需要封装，没有映射关系。
其中mybatis的底层本质上就是封装了JDBC，其结构图如下。
在这里插入图片描述

一、MyBatis源码解析

前置知识
为了加深对源码的理解，本文单独开启一个章节来描述JDK动态代理，动态代理，就是Java提供的一种在运行时创建代理对象的机制。
核心概念

  • Proxy类：这是JDK动态代理的核心类，位于java.lang.reflect包中。它提供了用于创建动态代理对象的方法，其中最关键的是newProxyInstance静态方法。
  • InvocationHandler接口：所有通过JDK动态代理创建的代理对象都需要实现这个接口。该接口定义了一个invoke方法，当代理对象上的方法被调用时，会触发这个方法。

工作原理

  • 通过Proxy.newProxyInstance方法创建一个实现了指定接口的代理对象。当调用代理对象的任何方法时，实际上会调用InvocationHandler的invoke方法。在invoke方法内部，可以根据需要自定义方法调用前的逻辑（如权限校验、日志记录等）、调用实际的目标方法，以及方法调用后的逻辑（如异常处理、资源释放等）。

MyBatis的执行过程可分为，解析和 执行两个步骤，就是对xml配置文件的读取并解析，并解析对应 的SQL语句。解析的标签有、别名、数据库连接、mapper扫描等信息。
MyBatis 源码的核心模块包括以下几个部分：

  1. 配置模块（Configuration）

  • 作用：解析 XML 或注解配置，构建全局配置对象 Configuration。

  • 关键类：
    * SqlSessionFactoryBuilder：构建 SqlSessionFactory。
    * XMLConfigBuilder：解析 mybatis-config.xml 文件。
    * XMLMapperBuilder：解析 Mapper XML 文件。

  • 流程：
    1.加载 mybatis-config.xml，解析全局配置（数据源、插件、类型处理器等）。
    2.解析 Mapper XML 文件或注解，生成 MappedStatement 对象（封装 SQL 信息）。

  1. SQL 执行模块（Executor）

  • 作用：执行 SQL 并处理结果。

  • 关键类：
    Executor：执行器的接口，定义了 update、query 等方法。
    SimpleExecutor：默认的简单执行器。
    CachingExecutor：带二级缓存的执行器（装饰器模式）。

  • 流程：
    通过 Executor 执行 SQL。
    结合 StatementHandler 创建 JDBC Statement。
    通过 ResultSetHandler 处理结果集。

  1. 映射模块（Mapper）

  • 作用：将 Java 接口与 SQL 映射关联。

  • 关键类：
    MapperProxy：动态代理对象，拦截 Mapper 接口方法调用。
    MapperMethod：封装了 SQL 命令类型（SELECT/INSERT 等）和参数处理逻辑。

  • 流程：
    1.通过 MapperRegistry 注册 Mapper 接口。
    2.使用 JDK 动态代理生成 MapperProxy 对象，将方法调用转发给 SqlSession。

二、SQL 执行流程源码解析

以下是 MyBatis 执行一条 SQL 的核心流程（以查询为例）：

  1. 入口：Mapper 接口方法调用；
User user = userMapper.selectById(1);
  • userMapper 是动态代理对象（MapperProxy），调用方法时触发 invoke()。
  1. MapperProxy 动态代理
public class MapperProxy<T> implements InvocationHandler {
    @Override
    public Object invoke(Object proxy, Method method, Object[] args) {
        // 将方法转换为 MapperMethod
        MapperMethod mapperMethod = cachedMapperMethod(method);
        return mapperMethod.execute(sqlSession, args);
    }
}
  1. MapperMethod 执行逻辑
public class MapperMethod {
    public Object execute(SqlSession sqlSession, Object[] args) {
        switch (command.getType()) {
            case SELECT:
                Object param = method.convertArgsToSqlCommandParam(args);
                return sqlSession.selectOne(command.getName(), param);
            // 处理其他命令类型（INSERT/UPDATE/DELETE）
        }
    }
}
  1. SqlSession 委托 Executor
public class DefaultSqlSession implements SqlSession {
    @Override
    public <T> T selectOne(String statement, Object parameter) {
        List<T> list = executor.query(statement, parameter, RowBounds.DEFAULT, Executor.NO_RESULT_HANDLER);
        return list.get(0);
    }
}
  1. Executor 执行查询
public class SimpleExecutor extends BaseExecutor {
    @Override
    public <E> List<E> query(...) {
        // 1. 获取 BoundSQL（解析动态 SQL 后的最终 SQL）
        BoundSQL boundSql = configuration.getMappedStatement(statement).getBoundSql(parameter);
        // 2. 创建 StatementHandler（如 PreparedStatementHandler）
        StatementHandler handler = configuration.newStatementHandler(...);
        // 3. 准备 Statement，设置参数
        Statement stmt = prepareStatement(handler, ...);
        // 4. 执行查询并处理结果
        return handler.query(stmt, resultHandler);
    }
}
  1. 结果集处理
    • ResultSetHandler 将 JDBC ResultSet 转换为 Java 对象：
public class DefaultResultSetHandler implements ResultSetHandler {
    @Override
    public List<Object> handleResultSets(Statement stmt) {
        // 遍历 ResultSet，根据 ResultMap 映射字段到对象属性
    }
}

三、关键设计解析

  1. 动态 SQL 解析
  • 原理：基于 OGNL 表达式和 XMLScriptBuilder 解析动态标签（如 、）。
  • 核心类：
  • SqlSource：表示原始 SQL 内容（静态或动态）。
  • DynamicSqlSource：处理动态 SQL，生成 BoundSQL（包含最终 SQL 和参数映射）。
  1. 插件机制（Interceptor）
  • 原理：基于动态代理和责任链模式，拦截四大组件：
    Executor、StatementHandler、ParameterHandler、ResultSetHandler。
  • 实现：
@Intercepts({@Signature(type=Executor.class, method="query", args={...})})
public class MyPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 前置逻辑
        Object result = invocation.proceed();
        // 后置逻辑
        return result;
    }
}
  1. 缓存设计
    缓存的设计师为了提高 数据的复用性，以及避免过度访问数据库造成点的消耗，由此提高了数据的查询速度。一级缓存在SqlSession级别提供快速的数据访问，而二级缓存则在整个应用程序范围内实现了数据的共享和重用。
  • 一级缓存：
    • 作用域：SqlSession 级别，默认开启。
    • 实现：BaseExecutor 中的 localCache（PerpetualCache）。
    • MyBatis在创建SqlSession对象时，会为其创建一个Executor对象来执行数据库操作。Executor对象内部维护了一个Cache缓存，用于存储查询结果。当执行查询操作时，Executor会先检查一级缓存中是否已存在该查询的结果，如果存在则直接返回；如果不存在，则执行查询操作，并将查询结果存入一级缓存中，以便后续使用
  • 二级缓存：
    • 作用域：Mapper 级别，需手动配置 。
    • 实现：CachingExecutor 装饰器，通过 TransactionalCacheManager 管理缓存。
  1. 事务管理
  • 原理：通过 Transaction 接口管理 JDBC 连接的事务。
    • JdbcTransaction：基于 JDBC 连接的事务。
    • ManagedTransaction：由容器（如 Spring）管理的事务。

四、源码调试建议

1.入口示例：

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
User user = userMapper.selectById(1);

2.关键断点：

  • XMLConfigBuilder.parse()：解析全局配置。
  • MapperProxy.invoke()：Mapper 方法代理入口。
  • SimpleExecutor.doQuery()：SQL 执行核心逻辑。
  • DefaultResultSetHandler.handleResultSets()：结果集映射。

五、总结

MyBatis 源码通过模块化设计实现高效灵活的 ORM 功能：
1.配置解析：构建全局 Configuration 对象，统一管理所有组件。
2.动态代理：通过 MapperProxy 将接口调用映射到 SQL 执行。
3.执行链：Executor 协调 StatementHandler、ResultSetHandler 完成 SQL 执行和结果映射。
4.扩展性：插件机制和缓存设计提供了高度的可定制性。
通过深入源码，可以更好地理解 MyBatis 的设计哲学，并为定制化开发（如编写插件、优化性能）提供理论支持。

标签
#mybatis
Mybatis源码详解
共勉
11-16 8726
基于3.5.10的版本对Mybatis源码从加载到执行全流程的解析，通过与传统JDBC方法的对比更深一步的了解Mybatis帮我们做了什么，以及是如何做的
Java面试题整理，一线互联网公司java面试核心知识点
m0_57066131的博客
07-19 516
SpringBoot经典之作 进入Spring Boot世界 准备开发环境搭建开发工具 基础 Spring Boot基础 分层开发Web应用程序 响应式编程 进阶 Spring Boot进阶 用ORM操作SQL数据库 接口架构风格——RESTful 集成安全框架，实现安全认证和授权 集成Redis，实现高并发 集成RabbitMQ，实现系统间的数据交换 集成 NoSQL 数据库，实现搜索引擎 项目实战 开发企业级通用的后台系统 实现一个类似“京东”的电子商务商城
mybatis逆向工程源码
07-20
mybatis是需要自己在mapper文件中编写sql，这样一来，如果表特别多的话，那么我们需要自己建很多类（pojo，mapper文件，sql语句等），会非常麻烦。为了解决这个问题，mybatis官方提供逆向工程 可以针对单表自动生成mybatis执行所需要的代码（mapper.java,mapper.xml、pojo等），mapper中也会提供单表增删改查等基础功能，大大简化了我们的开发，可以说是非常实用。
阿里P8大牛手写的源码笔记：Java集合+Java多线程+MyBatis+Spring
一入Java深似海
05-07 2356
Java集合源码笔记 Java集合是我认为在Java基础中最最重要的知识点了，Java集合是必须掌握的。我在实习/秋招面试的时候，只要是面到Java，那一定是少不了Java集合。 如何入门Java集合以及每个常用的子类我在PDF整理好了，这份PDF绝对令你满意。 内容介绍 学习指南 Collection List集合 Map集合 HashMap LinkedHashMa...
Mybatis逆向工程源代码
01-14
Mybatis逆向工程源代码
Mybatis知识总结（超详细、超全面）
靖妖傩舞
04-11 9000
mybatis重点详细整理
mybatis逆向工程（附源码）
yaoqianss的博客
02-24 541
源码github下载地址：https://github.com/wcyong/mybatisGeneratorCustom.git 源码百度云盘下载地址：链接: https://pan.baidu.com/s/1czwasu 密码: nc9w mybaits需要程序员自己编写sql语句，mybatis官方提供逆向工程 可以针对单表自动生成mybatis执行所需要的代码（mapper.java,mapper.xml、pojo等） 有了sql表的结构后, 我们就可以利用逆向工程直接生成相应的Dao和JavaBe
【Mybatis】Mybatis逆向工程的创建和测试过程【附源码】
weixin_46081857的博客
03-10 1836
文章目录Mybatis的逆向工程1.实现逆向工程步骤2.测试逆向工程Could not find resource com/jd/wds/mapper/EmpMapper.xml Mybatis的逆向工程 正向工程：先创建Java实体类，由框架负责根据实体类生成数据库表。Hibernate是支持正向工程的。逆向工程：先创建数据库表，由框架负责根据数据库表，反向生成如下资源：Java实体类、Mapper接口、Mapper映射文件 简单点说，逆向工程就是通过数据库中的单表，自动生成java代码。 1.实现逆向工
mybatis逆向工程
qq_47895373的博客
12-16 633
逆向工程简单来说就是传统写代码一般先写对应数据库里面的实体类、数据库接口类、实现类（即xml配置文件）。然而逆向工程是先通过数据库系统自动为你生成这些文件。
【SSM-SSM整合】将Spring、SpringMVC、Mybatis三者进行整合；本文阐述了几个核心原理知识点，附带对应的源码以及描述解析
拔高、提升、创新！
05-12 1050
平时开发接触最多的估计就是这个IOC容器，它可以装载bean（也就是Java中的类，当然也包括service、dao里面的），有了这个机制，就不用在每次使用这个类的时候为它初始化，很少看到关键字new。
Mybatis核心技术
m0_75011249的博客
05-03 905
《一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码》，点击传送门，即可获取！ 配表与pojo关系,以及sqlselect * from user where id = #{id}id: sql语句的唯一标识,与dao接口中的方法名一致parameterType：定义输入到sql中的映射类型(请求参数)，#{id}表示使用preparedstatement设置占位符号并将输入变量id传到sql。id 可以用任意字符代替并不固定resultType：定义结果映射类型(返回值)。注意:当返
为什么大家更愿意使用MyBatis，读完源码我知道了…
HollisChuang's Blog
06-29 996
最近有朋友在忙着面试，刚开始一路过关斩将，结果最后他和我说，面试官问了他下面这几个和Mybatis源码相关的问题：你确定你真正了解ORM底层原理?Mybatis缓存的实现和使用你清楚吗?...
MyBatis入门学习教程，最详细的原理使用讲解
2401_84152223的博客
05-03 836
各位读者，由于本篇幅度过长，为了避免影响阅读体验，下面我就大概概括了整理了《一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码》点击传送门，即可获取！", user);// 提交事务// 关闭会话mybatis的优缺点优点：===1.易于上手和掌握。各位读者，由于本篇幅度过长，为了避免影响阅读体验，下面我就大概概括了整理了[外链图片转存中…(img-cEwjBuh2-1714707703257)]
mybatis逆向工程详解源码
10-09
MyBatis的一个主要的特点就是需要程序员自己编写sql，那么如果表太多的话，难免会很麻烦，所以mybatis官方提供了一个逆向工程，可以针对单表自动生成mybatis执行所需要的代码（包括mapper.xml、mapper.java、po..）。一般在开发中，常用的逆向工程方式是通过数据库的表生成代码。
MyBatis可自动生成代码的逆向工程
07-16
MyBatis可以根据数据库表单自动生成代码的逆向工程
最简单的mybatis逆向工程源码
08-10
最简单的mybatis逆向工程源码,开箱即用,非常方便,有需要的小伙伴可以参考一下哦
【MyBatis 源码阅读与笔记】Mapper 接口的动态代理实现
鸿蒙初开
11-17 1210
核心类，负责拦截接口方法调用并执行 SQL。：创建的工厂。：封装接口方法与 SQL 之间的映射关系。SqlSession：MyBatis 的核心接口，负责 SQL 执行与事务管理。动态代理实现：MyBatis 使用 JDK 动态代理为 Mapper 接口生成代理类，所有方法调用通过方法处理。MapperProxy 类：拦截方法调用，并通过执行 SQL。MapperMethod 类：负责接口方法与 SQL 语句的映射，执行 SQL 后处理结果。SQL 执行与封装：使用SqlSession。
【Java持久层技术演进全解析】从JDBC到MyBatis再到MyBatis-Plus
最新发布
weixin_35225264的博客
07-04 97
Data@Version通过本文的系统性讲解，我们从最基础的JDBC开始，逐步深入到MyBatis和MyBatis-Plus的核心实现原理。理解这些技术的演进过程和底层机制，有助于我们在实际项目中做出合理的技术选型，并根据业务需求进行适当的定制和优化。无论选择哪种技术，都要在开发效率、维护成本和系统性能之间找到平衡点。原创作者: sun-10387834转载于: https://www.cnblogs.com/sun-10387834/p/18873873。
Android 上传图片实例，java上传图片接口
2401_84585372的博客
05-16 911
我们总是喜欢瞻仰大厂的大神们，但实际上大神也不过凡人，与菜鸟程序员相比，也就多花了几分心思，如果你再不努力，差距也只会越来越大。实际上，作为程序员，丰富自己的知识储备，提升自己的知识深度和广度是很有必要的。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值