SpringBoot中MyBatis的Mapper的原理

SpringBoot中MyBatis Mapper的原理核心是动态代理 与Spring自动配置 。通过@MapperScan或@Mapper注解,Spring启动时扫描接口,利用MapperFactoryBean和JDK动态代理将接口注册为Spring Bean,并由MapperProxy在运行时生成Mapper实例,将方法调用转化为SQL执行。 一、 核心工作原理

  1. 扫描与定义 (Scanning & Definition) :

    • SpringBoot启动时,@MapperScan注解或MybatisAutoConfiguration会扫描指定包下的Mapper接口。
    • 扫描到的接口并不会直接被实例化(因为它是接口),而是将其BeanDefinition注册到Spring容器中,定义其Bean类型为MapperFactoryBean。
  2. 动态代理生成 (Dynamic Proxy Generation) :

    • MapperFactoryBean实现了Spring的FactoryBean接口。当容器需要该Mapper时,getObject()方法被调用。
    • 使用JDK动态代理 (Proxy.newProxyInstance),以Mapper接口为代理接口生成一个代理对象。
    • 这个代理对象中绑定了MapperProxy工厂,它会创建实际执行SQL的代理实例。
  3. 方法调用执行 (Method Execution) :

    • 在Service层注入Mapper接口并调用方法(如userMapper.selectById(1))时,实际执行的是MapperProxy的invoke方法。
    • MapperProxy会根据方法名找到MyBatis中配置的对应SQL语句(XML或注解)。
    • 最终通过SqlSession执行SQL、映射结果对象(ResultMap)并返回。

二、 关键组件

  • @MapperScan / @Mapper: 标识Mapper接口位置,供扫描器识别。

  • MapperFactoryBean: 将Mapper接口转变为Spring Bean的关键中间件。

  • MapperProxyFactory : 产生MapperProxy实例。

  • MapperProxy : 实现InvocationHandler,是真正实现SQL映射的逻辑中心。

三、 整合原理图示

rust 复制代码
Service --> Mapper接口 (Proxy) 
             |
             v
MapperProxy (处理调用,匹配SQL)
             |
             v
SqlSession --> Executor --> JDBC --> 数据库

四、 @Mapper 与 @MapperScan 的区别

  • @Mapper: 需要在每一个Mapper接口上标注,比较繁琐。
  • @MapperScan: 在配置类上使用,批量扫描指定包下的所有接口,无需每个接口加注解。
相关推荐
金銀銅鐵3 小时前
[Java] 用 GUI 展示 EnumSet 增减元素时的内部变化(上)
java·后端·ai编程
念何架构之路4 小时前
go-grpc设计思想
开发语言·后端·golang
system_error_x5 小时前
SpringBoot 集成 Thymeleaf 简洁入门
java·spring boot·后端
步行cgn6 小时前
Spring MVC 视图机制的核心接口与类
java·开发语言·后端·spring·mvc
码事漫谈7 小时前
AI 读你的提示词,其实很没耐心
后端
用户8356290780518 小时前
如何使用 Python 格式化 Excel 单元格中的长文本
后端·python
我命由我123458 小时前
Python 开发 - Python 的 pathlib
java·开发语言·后端·python·学习·java-ee·学习方法
IT_陈寒8 小时前
Java性能优化完全指南
前端·人工智能·后端
电子IT笔记8 小时前
对接群晖NAS,上传和删除踩坑记录
前端·后端
Mk598788 小时前
P4:把 Agent 的记忆搬进 Redis —— AgentScope-Java 工程化实战
后端