1. MyBatis Mapper 接口的自动装配机制解析
在 Spring 和 MyBatis 整合的项目中,我们经常会看到这样的代码:
java复制@Autowired
private UserMapper userMapper;
这里 UserMapper 是一个接口,并没有具体的实现类,但 Spring 却能成功将其注入。这背后的原理是什么?本文将深入剖析 MyBatis Mapper 接口如何能够像普通 Bean 一样被 @Autowired 注入。
1.1 MyBatis-Spring 整合的核心机制
MyBatis 与 Spring 的整合主要通过 mybatis-spring 这个桥接项目实现。其核心在于 MapperFactoryBean,这是一个 Spring 的 FactoryBean 实现,负责为每个 Mapper 接口创建代理对象。
关键点在于:
MapperFactoryBean实现了FactoryBean接口- 它通过 JDK 动态代理为 Mapper 接口创建代理实例
- 这些代理实例会被注册到 Spring 容器中
java复制public class MapperFactoryBean<T> extends SqlSessionDaoSupport implements FactoryBean<T> {
// 省略其他代码
@Override
public T getObject() throws Exception {
return getSqlSession().getMapper(this.mapperInterface);
}
@Override
public Class<T> getObjectType() {
return this.mapperInterface;
}
}
1.2 Mapper 接口的注册过程
Mapper 接口能够被 Spring 管理,主要经过以下几个步骤:
- 扫描阶段:通过
@MapperScan或<mybatis:scan>配置扫描指定包下的 Mapper 接口 - 注册阶段:为每个找到的 Mapper 接口注册一个
MapperFactoryBean - 代理阶段:当第一次请求该 Bean 时,
MapperFactoryBean会创建代理对象
java复制// 简化的注册过程
public void registerMapper(Class<T> mapperInterface) {
// 创建 MapperFactoryBean 定义
BeanDefinitionBuilder builder = BeanDefinitionBuilder
.genericBeanDefinition(MapperFactoryBean.class);
builder.addPropertyValue("mapperInterface", mapperInterface);
// 注册到 Spring 容器
registry.registerBeanDefinition(mapperInterface.getName(),
builder.getBeanDefinition());
}
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 动态代理的实现细节
2.1 MapperProxy 的核心作用
MyBatis 使用 MapperProxy 作为 InvocationHandler 实现,处理所有 Mapper 接口方法的调用:
java复制public class MapperProxy<T> implements InvocationHandler, Serializable {
private final SqlSession sqlSession;
private final Class<T> mapperInterface;
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
// 处理 Object 方法
if (Object.class.equals(method.getDeclaringClass())) {
return method.invoke(this, args);
}
// 转换为 MapperMethod 执行
final MapperMethod mapper
