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: 在配置类上使用,批量扫描指定包下的所有接口,无需每个接口加注解。
相关推荐
码事漫谈35 分钟前
以后人人都可以成为导演
后端
Resean022341 分钟前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿42 分钟前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
ServBay3 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho3 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡934 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员4 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan4 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon5 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端