提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档
MyBatis和MyBatis Plus并存及问题解决
前言
Mybatis-plus:Mybatis增强工具,只做增强,不作改变,简化开发,大大提高了开发效率。
经常会碰到项目原先是采用MyBatis开发,每次增加一张表,要配置实体类、xml文件等,操作上略显复杂。因此,引入MyBatis Plus,对于新增加的表可以用MyBatis Plus来操作,而原有的表则保持不变,这样就出现了MyBatis和MyBatis Plus并存的情况。下面以具体的例子来描述再一个原有项目的基础上如何添加MyBatis Plus。
一、pom.xml文件修改
加入依赖:
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.4.1</version>
</dependency>
二、application.yml文件修改
原有的MyBatis片段:
mybatis:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.qqh.demo.mybatis.bean
只需要将mybatis修改为:mybatis-plus
mybatis-plus:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.qqh.demo.mybatis.bean
三、新增实体类
@Builder
@Data
@TableName("`user`")
public class User {
private Long id;
private String name;
private Integer age;
}
四、新增MyBatis Plus Mapper类
public interface UserMapper extends BaseMapper<User> {
}
五、新增UserMapperTest类
做完上述几步改造,已经算改造完成,这时候可以添加UserMapperTest测试类进行测试。新增加的测试类代码如下:
@RunWith(SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
@Autowired
private UserMapper userMapper;
/**
* 查询测试
*/
@Test
public void selectListTest() {
List<User> userList = userMapper.selectList(null);
Assert.assertEquals("user list size 不等于 5",5, userList.size());
}
@Test
public void insertTest() {
userMapper.insert(User.builder().name("qqh1").age(21).build());
userMapper.insert(User.builder().name("qqh2").age(22).build());
userMapper.insert(User.builder().name("qqh3").age(23).build());
userMapper.insert(User.builder().name("qqh4").age(24).build());
userMapper.insert(User.builder().name("qqh5").age(25).build());
}
@Test
public void updateTest() {
userMapper.updateById(User.builder().id(1751458136121847809L).name("xiaohong1-update").build());
}
@Test
public void deleteTest() {
userMapper.deleteById(User.builder().id(1751458136121847809L).build());
}
}
六、执行测试方法,碰到问题
执行测试方法:insertTest,启动时出现如下问题:
***************************
APPLICATION FAILED TO START
***************************
Description:
An attempt was made to call a method that does not exist. The attempt was made from the following location:
com.baomidou.mybatisplus.core.MybatisMapperAnnotationBuilder$AnnotationWrapper.<init>(MybatisMapperAnnotationBuilder.java:686)
The following method did not exist:
org.apache.ibatis.annotations.Select.databaseId()Ljava/lang/String;
The method's class, org.apache.ibatis.annotations.Select, is available from the following locations:
jar:file:/D:/mavenRepository/org/mybatis/mybatis/3.5.3/mybatis-3.5.3.jar!/org/apache/ibatis/annotations/Select.class
It was loaded from the following location:
file:/D:/mavenRepository/org/mybatis/mybatis/3.5.3/mybatis-3.5.3.jar
问题排查:
1.错误分析
根据上述错误信息,发现集中在mybatis-3.5.3.jar,怀疑是jar包版本冲突引起的。
2.依赖分析
对pom.xml中的依赖进行分析,如下图,发现mybatis-plus-boot-starter和mybatis-spring-boot-starter引用的mybatis包版本不一致。
2.解决
将mybatis-spring-boot-starter版本从2.1.1升级到2.3.1,使其使用的mybatis版本和mybatis-plus-boot-starter所使用的mybatis版本保持一致,再次运行测试方法insertTest,执行成功。查看数据库,如下图,数据已正确插入。
总结
MyBatis Plus确实可以大幅提高开发效率,上例中的UserMapper不需要写1行代码,即可实现增删改查。更多高级的应用感兴趣的同学可以进一步地去深入学习…