相关推荐recommended
MyBatis和MyBatis Plus并存及问题解决
作者:mmseoamin日期:2024-04-29

提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档

MyBatis和MyBatis Plus并存及问题解决

  • 前言
  • 一、pom.xml文件修改
  • 二、application.yml文件修改
  • 三、新增实体类
  • 四、新增MyBatis Plus Mapper类
  • 五、新增UserMapperTest类
  • 六、执行测试方法,碰到问题
    • 1.错误分析
    • 2.依赖分析
    • 2.解决
    • 总结

      前言

      Mybatis-plus:Mybatis增强工具,只做增强,不作改变,简化开发,大大提高了开发效率。

      经常会碰到项目原先是采用MyBatis开发,每次增加一张表,要配置实体类、xml文件等,操作上略显复杂。因此,引入MyBatis Plus,对于新增加的表可以用MyBatis Plus来操作,而原有的表则保持不变,这样就出现了MyBatis和MyBatis Plus并存的情况。下面以具体的例子来描述再一个原有项目的基础上如何添加MyBatis Plus。

      一、pom.xml文件修改

      加入依赖:

              
                  com.baomidou
                  mybatis-plus-boot-starter
                  3.5.4.1
              
      

      二、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 {
      }
      

      五、新增UserMapperTest类

      做完上述几步改造,已经算改造完成,这时候可以添加UserMapperTest测试类进行测试。新增加的测试类代码如下:

      @RunWith(SpringRunner.class)
      @SpringBootTest
      public class UserMapperTest {
          @Autowired
          private UserMapper userMapper;
          /**
           * 查询测试
           */
          @Test
          public void selectListTest() {
              List 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.(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包版本不一致。

      MyBatis和MyBatis Plus并存及问题解决,在这里插入图片描述,第1张

      2.解决

      将mybatis-spring-boot-starter版本从2.1.1升级到2.3.1,使其使用的mybatis版本和mybatis-plus-boot-starter所使用的mybatis版本保持一致,再次运行测试方法insertTest,执行成功。查看数据库,如下图,数据已正确插入。

      MyBatis和MyBatis Plus并存及问题解决,在这里插入图片描述,第2张

      总结

      MyBatis Plus确实可以大幅提高开发效率,上例中的UserMapper不需要写1行代码,即可实现增删改查。更多高级的应用感兴趣的同学可以进一步地去深入学习…