MyBatis和MyBatis Plus并存及问题解决

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

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包版本不一致。

    

    2.解决

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

    

    总结

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