MyBatis-Plus基于MyBatis封装 BaseMapper的流程步骤
更新时间：2025年04月03日 08:39:04 作者：Asthenian
MyBatis-Plus作为 MyBatis 的增强框架,通过 BaseMapper 提供了通用的 CRUD 操作,极大地提升了开发效率,为了更透彻地理解其封装机制,本文将采用链路追踪的思维,从开发者调用接口开始,分析其如何基于 MyBatis 完成对 BaseMapper 的封装,需要的朋友可以参考下
引言
MyBatis-Plus（简称 MP）作为 MyBatis 的增强框架，通过 BaseMapper 提供了通用的 CRUD 操作，极大地提升了开发效率。为了更透彻地理解其封装机制，本文将采用链路追踪的思维，从开发者调用接口开始，逐步深入到 MyBatis-Plus 的核心实现，分析其如何基于 MyBatis 完成对 BaseMapper 的封装。
一、从调用开始：BaseMapper 的使用场景
假设我们有一个简单的实体类 User 和对应的 Mapper 接口：
@TableName("t_user")
public class User {
@TableId
private Long id;
private String name;
private Integer age;
// getter 和 setter 省略
}
public interface UserMapper extends BaseMapper<User> {
}
开发者只需这样调用：
UserMapper userMapper = sqlSession.getMapper(UserMapper.class); User user = userMapper.selectById(1L);
表面上看，selectById 是 BaseMapper 提供的方法，但其背后是如何实现的呢？让我们沿着调用链路逐步追踪。
二、链路追踪：从接口调用到代理执行
1. 获取 Mapper 代理对象
当调用 sqlSession.getMapper(UserMapper.class) 时，MyBatis 的 SqlSession 会委托给 Configuration 的 getMapper 方法：
// MyBatis: org.apache.ibatis.session.Configuration
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
return mapperRegistry.getMapper(type, sqlSession);
}
这里的 mapperRegistry 是 MyBatis 的 MapperRegistry 类，但在 MyBatis-Plus 中被替换为 MybatisMapperRegistry。链路进入 MyBatis-Plus 的自定义实现：
// MyBatis-Plus: com.baomidou.mybatisplus.core.MybatisMapperRegistry
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory<T>) knownMappers.get(type);
if (mapperProxyFactory == null) {
throw new BindingException("Type " + type + " is not known to the MapperRegistry.");
}
return mapperProxyFactory.newInstance(sqlSession);
}
- 关键点：MyBatis-Plus 重写了
MapperRegistry，并在启动时通过扫描将所有继承BaseMapper的接口注册到knownMappers中。 - 代理生成：
newInstance方法创建了一个MapperProxy对象，这是 JDK 动态代理的实现。
2. 方法调用拦截
当调用 userMapper.selectById(1L) 时，代理对象 MapperProxy 的 invoke 方法被触发：
// MyBatis-Plus: com.baomidou.mybatisplus.core.override.MybatisMapperProxy
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
if (Object.class.equals(method.getDeclaringClass())) {
return method.invoke(this, args);
}
MybatisMapperMethod mapperMethod = cachedMapperMethod(method);
return mapperMethod.execute(sqlSession, args);
}
- 链路分叉：
cachedMapperMethod会根据方法签名缓存并返回一个MybatisMapperMethod对象。 - 执行逻辑：
execute方法根据方法名和参数决定具体的执行路径。
对于 selectById，链路进入 MybatisMapperMethod.execute：
// MyBatis-Plus: com.baomidou.mybatisplus.core.override.MybatisMapperMethod
public Object execute(SqlSession sqlSession, Object[] args) {
if (SqlCommandType.SELECT == command.getType()) {
if (method.getReturnType().isAssignableFrom(List.class)) {
return sqlSession.selectList(command.getName(), args);
}
return sqlSession.selectOne(command.getName(), args[0]);
}
// 其他类型如 INSERT、UPDATE 等略
}
- 关键点：
command.getName()返回的是一个全局唯一的 SQL ID，例如com.baomidou.mybatisplus.core.mapper.BaseMapper.selectById。 - 执行 SQL：最终调用 MyBatis 的
selectOne方法执行查询。
三、SQL 注入：BaseMapper 方法的实现来源
问题来了：selectById 的 SQL 是从哪里来的？答案在于 MyBatis-Plus 的 SQL 注入机制。
1. 启动时的 SQL 注入
MyBatis-Plus 在 Spring 容器初始化时，通过 MapperScannerConfigurer 扫描 Mapper 接口，并调用 ISqlInjector 注入通用 SQL：
// MyBatis-Plus: com.baomidou.mybatisplus.core.injector.DefaultSqlInjector
public void inspectInject(MapperBuilderAssistant builderAssistant, Class<?> mapperClass) {
List<AbstractMethod> methodList = getMethodList(mapperClass);
for (AbstractMethod method : methodList) {
method.inject(builderAssistant, mapperClass);
}
}
- 方法列表：
getMethodList返回BaseMapper中定义的所有方法（如selectById、insert等）的实现类，例如SelectById。 - 注入过程：以
SelectById为例：
// MyBatis-Plus: com.baomidou.mybatisplus.core.injector.methods.SelectById
public void injectMappedStatement(Class<?> mapperClass, Class<?> modelClass, TableInfo tableInfo) {
String sql = String.format("<script>SELECT %s FROM %s WHERE %s = #{id}</script>",
sqlSelectColumns(), tableInfo.getTableName(), tableInfo.getKeyColumn());
SqlSource sqlSource = languageDriver.createSqlSource(configuration, sql, modelClass);
addSelectMappedStatement(mapperClass, "selectById", sqlSource, modelClass, tableInfo);
}
- SQL 生成：根据
TableInfo（通过反射解析实体类）动态生成SELECT * FROM t_user WHERE id = #{id}。 - 注册：将生成的
MappedStatement注册到 MyBatis 的Configuration中。
2. TableInfo 的作用
TableInfo 是 MyBatis-Plus 的核心元数据类，通过 TableInfoHelper 在启动时解析实体类：
@TableName("t_user")→ 表名t_user。@TableId→ 主键字段id。- 字段映射 → 自动推断
name、age等列名。
这些信息为 SQL 注入提供了基础数据。
四、链路总结：从调用到执行的全流程
- 开发者调用：
userMapper.selectById(1L)。 - 代理拦截：
MybatisMapperProxy.invoke→MybatisMapperMethod.execute。 - SQL 执行：
sqlSession.selectOne→ MyBatis 执行预注入的MappedStatement。 - 结果映射：MyBatis 将查询结果映射为
User对象返回。
背后支持：
- 启动时：扫描 Mapper → 注入通用 SQL → 注册
MappedStatement。 - 运行时：动态代理 → 方法路由 → SQL 执行。
五、与 MyBatis 的协作与增强
- 复用 MyBatis：动态代理、
SqlSession、结果映射等核心机制完全继承自 MyBatis。 - 增强点：
SQL 自动化：通过
ISqlInjector注入通用 SQL。元数据管理：
TableInfo实现实体与表的自动映射。条件构造：
Wrapper扩展了动态查询能力。
六、结论
MyBatis-Plus 对 BaseMapper 的封装，是在 MyBatis 动态代理和 SQL 执行框架上的巧妙扩展。通过启动时的 SQL 注入和运行时的代理拦截，它实现了通用 CRUD 的零配置使用。链路追踪显示，这种设计既保留了 MyBatis 的灵活性，又通过自动化大幅提升了开发效率，堪称对 MyBatis 的“完美补完”。
以上就是MyBatis-Plus基于MyBatis封装 BaseMapper的流程步骤的详细内容，更多关于MyBatis-Plus封装 BaseMapper的资料请关注脚本之家其它相关文章！
相关文章
MyBatis的动态代理机制是其核心特性之一,通过该机制,开发者可以专注于定义接口和 SQL 映射,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2026-03-03
这篇文章主要介绍了Spring占位符Placeholder的实现原理,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-03-03
设计模式是软件设计中的一种常见方法，通过定义一系列通用的解决方案，来解决常见的软件设计问题，其中，抽象工厂模式是一种非常常见的设计模式，文中有详细的代码示例供大家参考，感兴趣的同学可以借鉴阅读2023-05-05
MyBatis-Plus本身并不直接支持JOIN连表查询,可以通过自定义SQL或者使用MyBatis的原生XML配置来实现JOIN连表查询,本文就来介绍一下MyBatisPlus中Join联表查询的项目实践,感兴趣的可以了解一下2026-04-04
这篇文章主要介绍了如何基于Idea远程调试tomcat war包及jar包,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-08-08
这篇文章主要为大家详细介绍了Java界面编程实现界面跳转，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-06-06
这篇文章主要介绍了Java四舍五入时保留指定小数位数的五种方式，帮助大家更好的理解和使用Java，感兴趣的朋友可以了解下2020-09-09
这篇文章主要给大家介绍了关于Java swing创建一个窗口的简单步骤,Java Swing是Java平台下的GUI（Graphical User Interface,图形用户界面）工具包,提供了丰富的GUI组件,可以实现复杂的图形界面应用程序,需要的朋友可以参考下2024-06-06
这篇文章主要介绍了浅谈Tomcat三种运行模式，小编冒昧将两篇文章略微整合了一下，有不足的地方，欢迎指出。需要的朋友可以参考。2017-10-10
博主的毕设系统在做一个餐厅的点餐管理系统，在进行移动端页面开发的时候突发奇想做一个呼叫功能，因此就有了这篇文章2021-05-05
最新评论