0

0

MyBatis的Mapper代理机制是怎样工作的_JDK动态代理生成接口实现类的原理

P粉602998670

P粉602998670

发布时间:2026-03-09 14:13:13

|

648人浏览过

|

来源于php中文网

原创

mybatis 的 getmapper() 返回的是 jdk 动态代理对象而非真实实现类,它实现接口但所有方法调用均被 mapperproxy.invoke() 拦截;因 jdk 代理仅支持接口,故必须使用接口而非抽象类或普通类。

mybatis的mapper代理机制是怎样工作的_jdk动态代理生成接口实现类的原理

MyBatis 的 getMapper() 真的返回了一个“实现类”吗?

不,它返回的是一个 JDK 动态代理对象——没有生成 .class 文件,也没有编译期的实现类。这个代理对象实现了你声明的 UserMapper 接口,但所有方法调用都会被拦截到 MapperProxy.invoke() 中统一处理。

常见错误现象:有人在调试时试图在 IDE 里点进 userMapper.queryAll() 查看“实现源码”,结果跳转失败或进入空方法——因为根本不存在真实实现,只有代理逻辑。

  • getMapper(Class<t> type)</t> 最终委托给 MapperRegistry,从 knownMappers(HashMap)中查出对应的 MapperProxyFactory
  • 工厂调用 newInstance(sqlSession),内部执行 Proxy.newProxyInstance(..., new MapperProxy(...))
  • 代理对象本身不持有 SQL,SQL 解析、参数绑定、结果映射全部发生在 invoke() 被触发时

为什么必须用接口,不能用抽象类或普通类?

JDK 动态代理只支持对 接口 生成代理,这是 Java 语言层面的硬性限制。MyBatis 没有、也不能绕过这点。

使用场景:如果你误写了一个抽象类 AbstractUserMapper 并尝试 sqlSession.getMapper(AbstractUserMapper.class),会直接抛出 BindingException,提示 “Type is not known to the MapperRegistry”。

  • MyBatis 启动时只扫描并注册 @Mapper 接口或 <mapper class="..."></mapper> 中的接口类
  • 抽象类/普通类不会被放入 knownMappersgetMapper() 查不到就报错
  • 即使你手动把抽象类塞进 knownMappers,JDK 代理创建也会在 Proxy.newProxyInstance() 阶段失败

MapperProxyMapperMethod 分工怎么理解?

MapperProxy 是“门卫”,只做拦截和分发;MapperMethod 是“业务员”,真正读 XML 或注解、解析 SQL、决定走 selectOne 还是 selectList

Midjourney
Midjourney

当前最火的AI绘图生成工具,可以根据文本提示生成华丽的视觉图片。

下载

容易踩的坑:以为缓存或日志逻辑该写在 MapperProxy 里——其实不该。它的 invoke() 方法极轻量,重逻辑(比如参数校验、慢 SQL 记录)应放在自定义插件或 Service 层。

  • MapperProxy 构造时就持有 SqlSessionmethodCache(ConcurrentMap
  • 首次调用某方法时,才根据 Method 对象构建 MapperMethod 并缓存;后续复用,避免重复解析 XML/注解
  • MapperMethod.execute() 内部根据 command.getType()(INSERT/SELECT 等)调用对应 SqlSession 方法,参数转换也在这里完成

不整合 Spring 时,getMapper() 的调用链你能跟到哪一层?

能清晰看到三层委托:你的代码 → DefaultSqlSession.getMapper()Configuration.getMapper()MapperRegistry.getMapper()。再往下就是 MapperProxyFactory.newInstance() 触发 JDK 代理创建。

性能影响:每次 getMapper() 都不新建代理对象,而是复用已创建的 MapperProxyFactory;但每个 SqlSession 实例都会拿到独立的代理对象(所以不同 session 的 mapper 不共享一级缓存)。

  • 代理对象生命周期 = SqlSession 生命周期;session 关闭后,其持有的 mapper 代理不可再用
  • 不要缓存 SqlSession 或它的 mapper 代理到静态变量或单例中,否则引发线程安全问题或连接泄漏
  • Spring 整合后,这些细节被隐藏,但底层仍是这套委托链——只是 SqlSessionSqlSessionTemplate 管理,代理对象由 MapperFactoryBean 创建

最常被忽略的一点:动态代理不是魔法,它依赖完整的元信息加载。如果 XML 文件没被正确 <mapper resource="..."></mapper> 引入,或注解 SQL 写错位置(比如放在 default 方法里),MapperMethod 构建就会失败,报错却可能出现在第一次调用时,而不是启动阶段。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1133

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

381

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2109

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

380

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1642

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

439

2024.04.29

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

59

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Node.js 教程
Node.js 教程

共57课时 | 13万人学习

Vue 教程
Vue 教程

共42课时 | 9.4万人学习

Git 教程
Git 教程

共21课时 | 4.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号