Spring管理MyBatis Mapper接口的原理详解
一、核心机制
Spring通过动态代理 + FactoryBean + 注解扫描机制管理MyBatis Mapper接口。Mapper接口本身无实现类，Spring通过JDK动态代理生成代理对象，实现接口方法调用。
二、执行流程
注解扫描
@MapperScan注解触发MapperScannerRegistrar注册ClassPathMapperScanner扫描器，扫描指定包路径下的Mapper接口。@MapperScan("com.example.mapper")注册BeanDefinition
扫描器将Mapper接口注册为MapperFactoryBean类型Bean，BeanClass属性被修改为MapperFactoryBean。// 生成的BeanDefinition BeanDefinition beanDef = new RootBeanDefinition(MapperFactoryBean.class); beanDef.getPropertyValues().add("mapperInterface", mapperInterface);创建代理对象
MapperFactoryBean.getObject()方法中调用sqlSession.getMapper(MapperInterface.class)，MyBatis通过JDK动态代理生成实现类。// MapperFactoryBean核心逻辑 public Object getObject() { return getSqlSession().getMapper(this.mapperInterface); }方法调用转发
代理对象方法调用被MapperProxy.invoke()拦截，通过SQL映射执行数据库操作。// MapperProxy核心逻辑 public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { if (method.getDeclaringClass() == Object.class) { return method.invoke(this, args); } return execute(method, args); }
三、关键类和接口
| 类名/接口 | 作用 |
|---|---|
@MapperScan | 扫描Mapper接口 |
MapperScannerRegistrar | 注册扫描器 |
ClassPathMapperScanner | 实际扫描类 |
MapperFactoryBean | FactoryBean，生成Mapper代理 |
SqlSession.getMapper() | 生成JDK动态代理 |
MapperProxy | 代理类实现逻辑 |
四、配置方式
XML配置
通过SqlSessionFactoryBean和MapperScannerConfigurer配置。<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.mapper"/> </bean>注解配置
使用@MapperScan注解简化配置。@Configuration @MapperScan("com.example.mapper") public class MyBatisConfig { @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) { SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); factoryBean.setDataSource(dataSource); return factoryBean.getObject(); } }
五、注意事项
依赖注入
Mapper接口通过@Autowired注入使用，Spring容器自动管理代理对象。@Autowired private UserMapper userMapper;事务管理
Spring通过SqlSessionTemplate包装SqlSession，实现事务控制。@Transactional public void updateUser(User user) { userMapper.update(user); }日志配置
MyBatis支持多种日志框架（如SLF4J、Log4j2），通过mybatis-config.xml配置。<settings> <setting name="logImpl" value="SLF4J"/> </settings>
