Spring Boot整合MyBatis:@Mapper、@MapperScan和mybatis.mapper-locations如何协同工作?(协同工作.整合.MyBatis.Spring.Boot...)

wufei123 发布于 2025-03-14 阅读(8)

spring boot整合mybatis:@mapper、@mapperscan和mybatis.mapper-locations如何协同工作?

Spring Boot集成MyBatis时,@Mapper、@MapperScan注解和mybatis.mapper-locations配置文件参数如何协同工作?本文将详细解释它们之间的区别,并说明为何缺少mybatis.mapper-locations配置会导致org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)错误。

Invalid bound statement (not found)错误表明MyBatis无法找到对应的SQL映射语句。虽然@Mapper(用于单个Mapper接口)、@MapperScan(用于扫描多个Mapper接口)和mybatis.mapper-locations都与Mapper接口定位相关,但它们的功能不同。

@Mapper注解将一个接口标记为MyBatis的Mapper接口,指示Spring创建该接口的动态代理对象。此代理对象执行接口方法并调用相应的SQL语句。需要注意的是,@Mapper只能用于单个Mapper接口。

@MapperScan注解扫描指定包下所有Mapper接口,并为其生成动态代理对象,避免在每个接口上都添加@Mapper注解。它简化了配置,一次性处理多个Mapper接口。

mybatis.mapper-locations=classpath:mapper/*.xml配置项指定了MyBatis映射文件(.xml文件)的路径。MyBatis正是通过这些.xml文件找到具体的SQL语句。@Mapper和@MapperScan注解仅告知Spring哪些接口是Mapper接口并生成代理,但它们并未告诉MyBatis在哪里查找SQL映射语句,而这些语句定义在.xml文件中。

因此,仅使用@Mapper或@MapperScan,MyBatis虽然能找到Mapper接口,却找不到对应的SQL语句,从而抛出Invalid bound statement (not found)错误。添加mybatis.mapper-locations配置后,MyBatis就能根据路径找到.xml文件,正确执行SQL语句。注解负责Mapper接口的扫描和代理生成,配置文件负责指定SQL映射文件位置,两者缺一不可。

以上就是Spring Boot整合MyBatis:@Mapper、@MapperScan和mybatis.mapper-locations如何协同工作?的详细内容,更多请关注知识资源分享宝库其它相关文章!

标签:  协同工作 整合 MyBatis 

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。