1. 背景
Mybatis-plus可以生成CRUD,减少开发中SQL编写量,但是某些情况下我们需要多表关联查询,这时候Mybatis可以手写SQL的优势就体现出来了,在实际开发中,项目里面一般都是Mybatis和Mybatis-Plus公用,但是公用有版本不兼容的问题。下面这篇文章主要介绍如何在项目中同时集成Mybatis和Mybatis-plus。
2. 前期准备
引入相关的jar包
<!-- mybatis依赖 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.2</version>
</dependency>
<!--引入autoconfigure-->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-autoconfigure</artifactId>
<version>2.1.4</version>
</dependency>
3. 不兼容问题
如果是单纯的引入完两个jar包,就开始使用这样是会抛出下面的异常
这个异常也是常见的,不少后端开发可能都遇到过,绑定异常,意思是识别不了对应的mapper.xml
有人说是版本不兼容问题,我把Mybatis(2.1.3)和Mybatis-plus(3.3.0)替换成他们说的版本依然无解。单单只是替换版本是解决不了的
如果你最初项目中是已经集成了Mybatis或者Mybatis-plus;先集成Mybatis的项目再集成Mybatis-plus,这个时候application.yml配置文件需要做出修改,即将原 mybatis 改成 mybatis-plus即可。
原Mybatis配置:
mybatis:
type-aliases-package: com.xxxx.shortchain.entity
mapper-locations: classpath*:mappers/**/*.xml
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
map-underscore-to-camel-case: true
改成Mybatis-plus配置:
mybatis-plus:
type-aliases-package: com.xxxx.shortchain.entity
mapper-locations: classpath*:/mappers/*.xml,classpath*:/mappers/**/*.xml
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
mapUnderscoreToCamelCase: true #自动转驼峰 true开启
根据自己xml的实际路径修改。
4. jar包冲突
在集成Mybatis和Mybatis-plus时,也可能会遇到jar包冲突的情况,这时候我们可以排除一些jar包来解决冲突。
4.1 Mybatis中
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.2</version>
<!--原Mybatis中需排除下面2个依赖-->
<exclusions>
<exclusion>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
</exclusion>
<exclusion>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
</exclusion>
</exclusions>
</dependency>
4.2 分页插件pageHelper中
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.2.3</version>
<!--需排除下面包-->
<exclusions>
<exclusion>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
</exclusion>
</exclusions>
</dependency>
至此,SpringBoot同时集成Mybatis和Mybatis-plus就已经完成了。可以正常启动项目进行测试了
DateTime dateTime = DateUtil.beginOfDay(new Date());
QueryWrapper<ShortChain> queryWrapper = new QueryWrapper<>();
LambdaQueryWrapper<ShortChain> lambda = queryWrapper.lambda();
lambda.ge(ShortChain::getExpireDate, dateTime).eq(ShortChain::getDeleted, 0);
List<ShortChain> shortChains = shortChainMapper.selectList(queryWrapper);
使用Mybatis-plus也能正常查询数据行