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，可以減少令人窒息的配置

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.2.1.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
</properties>

<dependencies>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.2.0</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
</dependencies>

<build>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </pluginManagement>
</build>
<repositories>
    <repository>
        <id>spring-snapshots</id>
        <name>Spring Snapshots</name>
        <url>https://repo.spring.io/libs-snapshot-local</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>spring-milestones</id>
        <name>Spring Milestones</name>
        <url>https://repo.spring.io/libs-milestone-local</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>spring-releases</id>
        <name>Spring Releases</name>
        <url>https://repo.spring.io/libs-release-local</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

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<MoneyPo> {
}

• 注意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<MoneyPo> list =
                moneyMapper.selectList(new QueryWrapper<MoneyPo>().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<String, Object> queryMap = new HashMap<>(2);
        queryMap.put("name", po.getName());
        System.out.println("after delete: " + moneyMapper.selectByMap(queryMap));
    }
}

輸出結果

II. 其他

0. 項目

• 工程：https://github.com/liuyueyi/spring-boot-demo
• 實例: https://github.com/liuyueyi/spring-boot-demo/blob/master/spring-boot/105-mybatis-plus

1. 一灰灰 Blog

盡信書則不如，以上內容，純屬一家之言，因個人能力有限，難免有疏漏和錯誤之處，如發現 bug 或者有更好的建議，歡迎批評指正，不吝感激

下面一灰灰的個人博客，記錄所有學習和工作中的博文，歡迎大家前去逛逛

• 一灰灰 Blog 個人博客 https://blog.hhui.top
• 一灰灰 Blog-Spring 專題博客 http://spring.hhui.top