Spring管理MyBatis Mapper接口的原理详解

Spring管理MyBatis Mapper接口的原理详解

一、核心机制

Spring通过‌动态代理 + FactoryBean + 注解扫描‌机制管理MyBatis Mapper接口。Mapper接口本身无实现类，Spring通过JDK动态代理生成代理对象，实现接口方法调用。

二、执行流程

1. ‌注解扫描‌
   @MapperScan注解触发MapperScannerRegistrar注册ClassPathMapperScanner扫描器，扫描指定包路径下的Mapper接口。

   @MapperScan("com.example.mapper")

2. ‌注册BeanDefinition‌
   扫描器将Mapper接口注册为MapperFactoryBean类型Bean，BeanClass属性被修改为MapperFactoryBean。

   // 生成的BeanDefinition BeanDefinition beanDef = new RootBeanDefinition(MapperFactoryBean.class); beanDef.getPropertyValues().add("mapperInterface", mapperInterface);

3. ‌创建代理对象‌
   MapperFactoryBean.getObject()方法中调用sqlSession.getMapper(MapperInterface.class)，MyBatis通过JDK动态代理生成实现类。

   // MapperFactoryBean核心逻辑 public Object getObject() { return getSqlSession().getMapper(this.mapperInterface); }

4. ‌方法调用转发‌
   代理对象方法调用被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); }

三、关键类和接口

四、配置方式

1. ‌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>

2. ‌注解配置‌
   使用@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(); } }

五、注意事项

1. ‌依赖注入‌
   Mapper接口通过@Autowired注入使用，Spring容器自动管理代理对象。

   @Autowired private UserMapper userMapper;

2. ‌事务管理‌
   Spring通过SqlSessionTemplate包装SqlSession，实现事务控制。

   @Transactional public void updateUser(User user) { userMapper.update(user); }

3. ‌日志配置‌
   MyBatis支持多种日志框架（如SLF4J、Log4j2），通过mybatis-config.xml配置。

   <settings> <setting name="logImpl" value="SLF4J"/> </settings>