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

已于 2022-08-28 07:56:43 修改
阅读量475 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： mybatis源码 文章标签： mybatis java spring
于 2022-08-28 07:53:13 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/CPLASF_/article/details/126278384
这篇博客主要探讨了@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
最低0.47元/天 解锁文章

200万优质内容无限畅学
谷粒商城 --＞「P01-P44」
Darling_qi的博客
04-28 5330
微服务+分布式+全栈+集群+部署+自动化运维+可视化CICD，对标阿里P6/P7
完整京淘项目的演练＜一＞小Demo
liymaVR的博客
12-30 1133
1.IDEA环境配置 字体控制大小 2.自动提示设置 3.设置方法提示 4.字符集的设置 5.自动编译 6.maven的配置 settings.xml里的文件设置 <?xml version="1.0" encoding="UTF-8"?> <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agr...
2019.10.24笔记——mybatis-spring新老版本的mapper扫描分析
ww0peo的博客
11-03 394
在invokeBeanFactoryPostProcessors方法中就使用了策略模式 mybatis在@Import中传递了ImportBeanDefinitionRegistrar的实现类，在回调方法中 在旧版中完成了dao的扫描，拿到了所有的mapper放到bean工厂中 在新版中只是往bean工厂中注册了一个MapperScannerConfigurer的bd 这个MapperScanne...
利用Spring提供的扩展点实现简单版本的@MapperScan
weixin_44019026的博客
05-19 315
首先这里说说我知道的spring提供的扩展点 1、实现BeanFactoryPostProcessor 干预BeanDefinition的信息 例如：设置作用域为prototype @Component public class MyBeanFactoryPostProcessor implements BeanFactoryPostProcessor { @Override public void postProcessBeanFactory(ConfigurableListableB
详解 @MapperScan 注解和 @Mapper 注解
jialiguo的专栏
08-22 7668
@Mapper 这个注解的定义如下： @Documented @Inherited @Retention(RUNTIME) @Target({ TYPE, METHOD, FIELD, PARAMETER }) public @interface Mapper { // Interface Mapper } @Mapper 一般我们用在接口上，代码如下： @Mapper ...
MapperScan.class 类文件具有错误的版本 61.0, 应为 52.0 请删除该文件或确保该文件位于正确的类路径子目录中。
weixin_44766478的博客
06-14 721
是因为单独指定了mybatis-spring的版本, 导致不兼容。把指定版本去掉, 使用plus自带的版本即可。
@mapperscan注解爆红，记录版本冲突报错
懵懵懂懂的小白
07-24 2664
后解决了这个问题，应该是和mybatisplus的pom文件冲突mybatis-plus-boot-starter版本是3.5.2的。今天导入环境，发现@mapperscan注解一直引入不进来，网上看很多都是让先导入下面这个依赖。然后还是无效，后分析原因是版本冲突问题，将依赖改成最新。
Spring零基础入门到精通 --- IOC基础容器
shuai_h的博客
03-25 1733
Spring零基础入门到精通
03-微服务
m0_61925586的博客
01-07 1673
什么时候需要拆分微服务？如果是创业型公司，最好先用单体架构快速迭代开发，验证市场运作模型，快速试错。当业务跑通以后，随着业务规模扩大、人员规模增加，再考虑拆分微服务。如果是大型企业，有充足的资源，可以在项目开始之初就搭建微服务架构。如何拆分？首先要做到高内聚、低耦合从拆分方式来说，有横向拆分和纵向拆分两种。纵向就是按照业务功能模块，横向则是拆分通用性业务，提高复用性服务拆分之后，不可避免的会出现跨微服务的业务，此时微服务之间就需要进行远程调用。微服务之间的远程调用被称为RPC，即远程过程调用。
mybatis-spring 2.0.0版本和mybatis-spring1.3.0版本区别
weixin_52060913的博客
04-02 782
注解方式：MyBatis-Spring 2.0.0增加了对一些常见注解的支持，比如@MapperScan、@Mapper、@InsertProvider等，而MyBatis-Spring 1.3.0的注解方式较为简单。总之，MyBatis-Spring 2.0.0相对于1.3.0来说更加先进、高效和易用。Spring版本需求：MyBatis-Spring 2.0.0需要Spring 5.x，而MyBatis-Spring 1.3.0适用于Spring 4.x 和Spring 3.x。
mybatis2-@MapperScan扫描接口
weixin_42145727的博客
10-10 1396
mybatis2-处理@Mapper注解
Mybatis的Mapper扫描机制：@MapperScan源码
zzzj的博客
09-03 8882
通过@Import注解导入了MapperScannerRegistrarMapperScannerRegistrar向容器中注入是一个BeanDefinitionRegistryPostProcessor，将会被Spring容器回调方法在方法中创建了，并且调用ClassPathMapperScanner的scan方法重写了父类ClassPathBeanDefinitionScanner的doScan方法，在扫描完Bean获取到BeanDefinition后，在方法对其进行了额外的处理。
@Mapper、@MapperScan、@Repository详解
qq_32861259的博客
05-07 2255
加了@MapperScan就相当于给包中的接口都加上了@Mapper，同时@Repository还有消除“注入”的错误提示的作用。它可以在编译之后自动生成相应的接口实现类，不用再写如下图所示的mapper映射文件；，然后包下面的所有接口在编译之后都会生成相应的实现类，实现批量添加@Mapper注解。如果需要让多个接口都变成实现类，用@Mapper一个个添加太麻烦，这时我们。用@Mapper直接在接口中写 ，编译时自动生成实现类，具体写法见下图。@Repository是spring提供的注解，放在。
关于@MapperScan注解的使用逻辑和MapperScannerConfiguration的个人深度理解
Carlos_ForYou的博客
09-11 2925
关于@Mapper注解和MapperScannerConfiguration的关系
@Repository ,@MapperScannerConfigurer与 @Mapper,@MapperScan
giraffebig的博客
10-12 732
相同点：@Mapper和@Repository都是作用在dao层接口，使得其生成代理对象bean，交给spring 容器管理对于mybatis来说，都可以不用写mapper.xml文件。
常用类属于哪些jar包
weixin_41887312的博客
06-20 2332
1.@requestmapping注解，属于org.springframework.web.bind.annotation包下。org.springframework.web jar包。2.@RestController注解，也属于org.springframework.web.bind.annotation包下，org.springframework.web jar包。都是spring mvc，...
Mybatis注解之@Mapper和@MapperScan的使用
书启鸿蒙知秋枫
11-20 4533
上面刚刚讲述了@Mapper注解可以把接口要变成实现类，如果项目有几个接口，你肯定会在对应的接口上写@Mapper注解，但是如果有一百个，上千个，你还会愿意去写吗，这个时候我们就可以使用@MapperScan注解来解决我们的问题。直接在Mapper接口类中加@Mapper注解，需要在每一个mapper接口类中都需要添加@Mapper注解，较为繁琐。指定要变成实现类的接口所在的包，然后在指定包下面的所有接口在SpringBoot启动编译完成之后生成相应的实现类。在Springboot启动类上面添加。
Mybatis解析-注解MapperScan详解
龚厂长的博客
10-08 7798
本文基于mybatis-spring 1.3.1和mybatis 3.4.4版本 注解MapperScan是mybatis的核心注解，它可以设置Mapper文件的扫描路径。本文将详细介绍该注解以及各个属性作用。 文章目录一、如何使用注解MapperScan二、MapperScan各个属性介绍三、MapperScannerRegistrar 一、如何使用注解MapperScan @MapperScan放在spring boot可以扫描到的位置即可，一个应用配置一个该注解，比如： @MapperScan(b.
关于MapperScan扫包问题
qq_42001004的博客
03-03 2322
java.lang.NoSuchMethodException: tk.mybatis.mapper.provider.base.BaseSelectProvider.<init>() 解决办法： 应该是导入： import tk.mybatis.spring.annotation.MapperScan这个包 还有其他情况是： jar包冲突： <depend...
我引用的mybatisplus 没有@MapperScan注解<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> </dependency>
最新发布
03-30
<think>好的，用户的问题是关于在MyBatis Plus中未使用@MapperScan注解导致的问题的解决方案。首先，我需要回忆一下MyBatis和MyBatis 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、付费专栏及课程。

余额充值