mybatis-plus里的com.baomidou.mybatisplus.core.override.MybatisMapperProxy 类的详细解析

news2025/7/17 5:43:03

以下是 com.baomidou.mybatisplus.core.override.MybatisMapperProxy 类的详细解析：
在这里插入图片描述

1. 类的作用

MybatisMapperProxy 是 MyBatis-Plus 框架中用于实现 Mapper 接口动态代理的核心类。它继承自 MyBatis 的 MapperProxy，并扩展了以下功能：

增强 MyBatis 原生功能：如自动填充、逻辑删除、分页查询等。
拦截 Mapper 方法调用：在方法执行前后插入自定义逻辑（如 SQL 优化、参数校验）。
动态 SQL 构建：支持自动生成基础 CRUD 的 SQL 语句（如 selectById、insert）。

2. 核心功能与实现

(1) 动态代理机制

继承关系：MybatisMapperProxy 继承自 MyBatis 的 MapperProxy，并重写了 invoke 方法。
代理对象生成：当调用 Mapper 接口时，MyBatis-Plus 会通过 MapperProxyFactory 创建 MybatisMapperProxy 的实例作为代理对象。
方法拦截：在 invoke 方法中，拦截 Mapper 接口的调用，执行增强逻辑后再调用原始 SQL。

(2) 关键方法

invoke 方法：

@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    // 1. 判断是否为 Object 的默认方法（如 toString），直接调用
    // 2. 判断是否为 MyBatis-Plus 增强方法（如 selectList Wrapper）
    // 3. 执行拦截器（Interceptor）链（如自动填充、逻辑删除）
    // 4. 调用原始 MapperProxy 的 invoke 方法执行 SQL
    return super.invoke(proxy, method, args);
}

增强逻辑：在调用原始 SQL 之前，会执行 MyBatis-Plus 的拦截器链（Interceptor），例如：
- 自动填充：通过 MetaObjectHandler 自动填充字段（如创建时间、更新时间）。
- 逻辑删除：通过 IS_DELETED 字段过滤已删除数据。
- 分页插件：动态拼接分页 SQL。

(3) 与 MyBatis-Plus 核心组件的关联

SqlSessionFactory：通过工厂生成 SQL 会话。
Interceptor：拦截器链（如分页插件、逻辑删除插件）在此处被调用。
MapperRegistry：注册 Mapper 接口，管理代理对象的创建。

3. 典型使用场景

(1) 基础 CRUD 自动化

当调用 BaseMapper 的方法（如 selectById、insert）时，MybatisMapperProxy 会自动生成对应的 SQL 语句。

示例：

User user = userMapper.selectById(1L); // 自动生成 SELECT * FROM user WHERE id = 1

(2) 拦截器扩展

通过自定义 Interceptor 实现扩展逻辑：

public class MyInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 拦截 SQL 执行前的逻辑（如日志、权限校验）
        return invocation.proceed(); // 继续执行后续逻辑
    }
}

(3) 逻辑删除

当查询时，自动添加 IS_DELETED = 0 条件：

List<User> users = userMapper.selectList(null); // 自动过滤已删除数据

4. 常见问题排查

(1) SQL 未生效

检查是否配置了 @TableName 注解或表名映射。
确保 BaseMapper 被正确继承。

(2) 拦截器未生效

检查拦截器是否被正确注册到 MyBatis-Plus 配置中：

@Configuration
public class MyBatisPlusConfig {
    @Bean
    public MybatisInterceptor mybatisPlusInterceptor() {
        MybatisInterceptor interceptor = new MybatisInterceptor();
        interceptor.addInterceptors(new MyInterceptor());
        return interceptor;
    }
}