@MapperScan注解原理解析 --> 1.3版本和2.0版本的区别

这篇博客主要探讨了@MapperScan注解在mybatis-spring 1.3和2.0版本中的差异。1.3版本中,通过@Import导入MapperScannerRegistrar,该类实现了ImportBeanDefinitionRegistrar,负责扫描mapper接口并注册beanDefinition。而2.X版本虽然也使用MapperScannerRegistrar,但进一步注册了MapperScannerConfigurer,它实现了BeanDefinitionRegistryPostProcessor,实际执行mapper接口的扫描和bean定义注册。总结来说,两个版本都在BeanDefinitionRegistry层面进行操作,但2.0版本引入了额外的扩展机制。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

@MapperScan注解是spring和mybatis整合的关键注解,这个注解的作用也简单,就是为了把当前mapper接口,放到spring容器中,但是这篇笔记想要记录的是,@MapperScan注解在1.3版本和2.0版本中的区别; 这个注解是放在mybatis-spring这个jar包中

1.3版本

在1.3版本中,通过@Import注解引入了一个bean:

MapperScannerRegistrar

在这里插入图片描述

这里可以看到,这个bean是ImportBeanDefinitionRegistrar的实现类,spring源码:@Import注解 在这篇博客中有介绍,这个接口的作用,简单来说,我们实现这个接口之后,可以拿到BeanDefinitionRegistry对象,可以自己去声明一个beanDefinition对象,放到beanDefinitionMap中,然后spring容器会帮我们完成初始化的操作
我们接着来看实现类中的实现方法

@Override
  public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {

    AnnotationAttributes annoAttrs = AnnotationAttributes.fromMap(importingClassMetadata.getAnnotationAttributes(MapperScan.class.getName()));
    ClassPathMapperSc
<think>好的,用户的问题是关于在MyBatis Plus中未使用@MapperScan注解导致的问题的解决方案。首先,我需要回忆一下MyBatisMyBatis Plus的基本配置。通常,在Spring Boot中整合MyBatis时,需要使用@MapperScan来扫描Mapper接口,这样Spring才能将它们注册为Bean。如果用户没有使用这个注解,可能会导致Mapper无法被注入,从而出现错误。 接下来,我应该考虑用户提到的MyBatis Plus的情况。MyBatis Plus是否提供了其他的自动配置方式?是的,MyBatis Plus有一个自动配置类,可能已经自动注册了Mapper接口,但需要确认是否满足某些条件,比如接口是否在指定的包下,或者是否使用了@Mapper注解。 然后,用户可能遇到的问题具体是什么?比如,当没有使用@MapperScan时,Service层中注入Mapper时会报错,提示找不到Bean。这时候需要检查Mapper接口是否被正确扫描。 解决方案可能包括几种方法:一是显式添加@MapperScan注解,指定Mapper接口所在的包;二是为每个Mapper接口添加@Mapper注解,这样即使不用@MapperScan,也能被扫描到;三是检查MyBatis Plus的配置,确认是否开启了自动扫描,可能需要配置mybatis-plus.mapper-locations属性。 另外,还需要考虑是否使用了正确的依赖。MyBatis Plus的starter包是否已经包含必要的自动配置?如果用户没有正确引入依赖,也可能导致扫描失败。此外,项目的包结构是否合理,Mapper接口是否位于Spring Boot的主启动类所在的包或其子包下,这也会影响自动扫描的效果。 最后,用户可能需要生成相关问题,比如如何配置多个包路径,或者@Mapper@MapperScan区别,以及MyBatis Plus的其他配置问题。需要确保回答清晰,步骤明确,并引用相关的参考资料,比如站内已有的关于MyBatis整合Spring Boot时Mapper作为Dao层注入的内容。</think>在MyBatis Plus中未使用`@MapperScan`注解导致Mapper接口无法注入的问题,可通过以下步骤解决: ### 1. 显式添加@MapperScan注解Spring Boot启动类上添加`@MapperScan`,并指定Mapper接口所在的包路径: ```java @SpringBootApplication @MapperScan("com.example.mapper") // 替换为实际Mapper接口包路径 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 这是最直接的解决方案,确保Spring能扫描到所有Mapper接口[^1]。 --- ### 2. 使用@Mapper注解标记接口 在每个Mapper接口上单独添加`@Mapper`注解: ```java @Mapper public interface UserMapper extends BaseMapper<User> { // 自定义方法 } ``` 此方法适用于少量Mapper接口的场景,但需要手动标注每个接口。 --- ### 3. 验证MyBatis Plus自动配置 MyBatis Plus的starter依赖`mybatis-plus-boot-starter`已包含自动配置逻辑: ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>最新版本</version> </dependency> ``` 确认以下配置: - Mapper接口位于Spring Boot主类所在包或其子包下 - 在`application.yml`中配置Mapper XML文件路径: ```yaml mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml ``` --- ### 4. 检查依赖包结构 - 确认没有冲突的MyBatis版本 - 确保Mapper接口不在`static`/`test`等非源码目录 - 检查IDEA的"Build Project"是否执行(避免未编译导致接口未扫描) --- ### 关键点对比 | 方法 | 优点 | 缺点 | |------|------|------| | `@MapperScan` | 集中管理扫描路径 | 需明确包路径 | | `@Mapper` | 细粒度控制 | 需逐个标注接口 | | 自动配置 | 零配置 | 依赖严格的包结构 |
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值