SpringBoot 系列教程 MybatisPlus 整合篇

191231-SpringBoot 系列教程 MybatisPlus 整合篇

前面介绍了 SpringBoot 整合 Mybatis 实现 db 的增删改查操作，分别给出了 xml 和注解两种实现 mapper 接口的方式；虽然注解方式干掉了 xml 文件，但是使用起来并不优雅，本文将介绍 mybats-plus 的使用 case，简化常规的 CRUD 操作

I. 环境

本文使用 SpringBoot 版本为 2.2.1.RELEASE， mybatis-plus 版本为3.2.0，数据库为 mysql 5+

1. 项目搭建

推荐使用官方的教程来创建一个 SpringBoot 项目；如果直接创建一个 maven 工程的话，将下面配置内容，拷贝到你的pom.xml中

主要引入的是mybatis-spring-boot-starter，可以减少令人窒息的配置


    org.springframework.boot
    spring-boot-starter-parent
    2.2.1.RELEASE
     



    UTF-8
    UTF-8
    1.8



    
        com.baomidou
        mybatis-plus-boot-starter
        3.2.0
    
    
        mysql
        mysql-connector-java
    



    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    


    
        spring-snapshots
        Spring Snapshots
        https://repo.spring.io/libs-snapshot-local
        
            true
        
    
    
        spring-milestones
        Spring Milestones
        https://repo.spring.io/libs-milestone-local
        
            false
        
    
    
        spring-releases
        Spring Releases
        https://repo.spring.io/libs-release-local
        
            false

2. 配置信息

在 application.yml 配置文件中，加一下 db 的相关配置

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/story?useUnicode=true&characterEncoding=UTF-8&useSSL=false
    username: root
    password:

接下来准备一个测试表(依然借用之前 db 操作系列博文中的表结构)，用于后续的 CURD；表结果信息如下

DROP TABLE IF EXISTS `money`;

CREATE TABLE `money` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(20) NOT NULL DEFAULT '' COMMENT '用户名',
  `money` int(26) NOT NULL DEFAULT '0' COMMENT '有多少钱',
  `is_deleted` tinyint(1) NOT NULL DEFAULT '0',
  `create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `name` (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

II. 实例整合

mybatis-plus 与 mybatis 的使用姿势有一些区别，下面为不借助generator直接手撸代码的 case

1. PO

创建表对应的 PO 对象: MoneyPo

@Data
public class MoneyPo {
    private Integer id;

    private String name;

    private Long money;

    private Integer isDeleted;

    private Timestamp createAt;

    private Timestamp updateAt;
}

2. DAO 接口

表的操作接口，与 mybatis 不同的是这个接口继承BaseMapper之后，就自带了单表的 CURD 操作接口了，基本上不需要定义额外的接口，就可以实现 db 交互

public interface MoneyMapper extends BaseMapper {
}

注意BaseMapper的参数为表对应的 PO 对象

3. 测试

上面完成之后，整合过程基本上就完了，没错，就这么简单，接下来我们进入测试环节

首先是启动类，我们加上了@MapperScan注解，这样在 DAO 接口上就不需要添加@Mapper注解了

@SpringBootApplication
@MapperScan("com.git.hui.boot.mybatisplus.mapper")
public class Application {

    public Application(MoneyRepository repository) {
        repository.testMapper();
    }

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

关于测试 case，下面会演示 CRUD 四种基本的操作 case，因为本文重点不是介绍 mybatis-plus 的用法，对于下面代码有疑问的可以查看官方文档: https://mp.baomidou.com/guide/

@Component
public class MoneyRepository {
    @Autowired
    private MoneyMapper moneyMapper;

    private Random random = new Random();

    public void testDemo() {
        MoneyPo po = new MoneyPo();
        po.setName("mybatis plus user");
        po.setMoney((long) random.nextInt(12343));
        po.setIsDeleted(0);

        // 添加一条数据
        moneyMapper.insert(po);

        // 查询
        List list =
                moneyMapper.selectList(new QueryWrapper().lambda().eq(MoneyPo::getName, po.getName()));
        System.out.println("after insert: " + list);

        // 修改
        po.setMoney(po.getMoney() + 300);
        moneyMapper.updateById(po);
        System.out.println("after update: " + moneyMapper.selectById(po.getId()));

        // 删除
        moneyMapper.deleteById(po.getId());

        // 查询
        Map queryMap = new HashMap<>(2);
        queryMap.put("name", po.getName());
        System.out.println("after delete: " + moneyMapper.selectByMap(queryMap));
    }
}

输出结果

II. 其他

0. 项目

1. 一灰灰 Blog

尽信书则不如，以上内容，纯属一家之言，因个人能力有限，难免有疏漏和错误之处，如发现 bug 或者有更好的建议，欢迎批评指正，不吝感激

下面一灰灰的个人博客，记录所有学习和工作中的博文，欢迎大家前去逛逛

一灰灰 Blog 个人博客 https://blog.hhui.top
一灰灰 Blog-Spring 专题博客 http://spring.hhui.top