SpringBoot 如何集成 MyBatisPlus - SpringBoot 2.7.2實戰基礎

SpringBoot 2.7.2 學習系列，本節通過實戰內容講解如何集成 MyBatisPlus

本文在前文的基礎上集成 MyBatisPlus，並創建資料庫表，實現一個實體簡單的 CRUD 介面。 MyBatis Plus 在 MyBatis 做了增強，內置了通用的 Mapper，同時也有程式碼生成器，簡化單表的開發工作。

1 準備資料庫

1.1 IDEA 配置資料庫

可以在 IDEA 中配置資料庫，也可以使用 Navicat、DataGrip 等軟體連接資料庫。這裡簡單說說使用 IDEA 連接資料庫的步驟。

1）點擊右側上方的 Database，在彈出的 Database面板上，點擊左上角加號圖標，依次選擇 Data Source --> MySQL

image-20220726105526498

2）在彈出的窗口中填寫 host、port、User、Password，下載MySQL驅動後，點擊 Test Connection，測試連接成功後，點擊OK即可。

image-20220726105800976

1.2 創建資料庫

執行如下建庫語句：

create database `hero_springboot_demo`
    default character set utf8mb4 collate utf8mb4_general_ci;

1.3 創建表結構

執行如下建表語句：

create table computer
(
    id        bigint auto_increment,
    size      decimal(4, 1) comment '尺寸',
    operation varchar(32) comment '作業系統',
    year      varchar(4) comment '年份',
    primary key (id)
) comment '電腦';

1.4 初始化數據

insert into computer(size, operation, year)
values (16, 'MacOS', '2022'),
       (14, 'MacOS', '2022'),
       (15.6, 'MacOS', '2018'),
       (13.3, 'MacOS', '2018'),
       (15.6, 'MacOS', '2016'),
       (13.3, 'MacOS', '2016'),
       (14, 'Windows 10', '2022'),
       (13, 'Windows 10', '2020'),
       (11, 'Windows 10', '2018'),
       (14, 'Windows 8', '2022'),
       (13, 'Windows 8', '2020'),
       (11, 'Windows 8', '2018');

2 添加依賴

需要添加如下依賴：

  • mybatis-plus-boot-starter：Mybatis Plus 與 Spring Boot 整合所需；
  • mysql-connector-java： MySQL 驅動；
  • lombok：可選，簡化 Getter、Setter、構造注入等，簡化程式碼。

在 properties 中定義 mybatis-plus 版本號：

<!-- MyBatis Plus 版本 -->
<mybatis-plus.version>3.5.2</mybatis-plus.version>

添加依賴：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>${mybatis-plus.version}</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
</dependency>

3 程式碼生成器

MyBatis Plus 提供了程式碼生成器。在真實的開發中，通常會獨立一個工程來生成相關程式碼，在這裡的demo就直接通過單元測試的方式進行了。

3.1 添加程式碼生成器依賴

程式碼生成器的依賴為 mybatis-plus-generator，該依賴內部不含模板引擎，需要手動添加模板引擎的依賴，這裡使用 freemarker。由於採用單元測試的方式生成程式碼，還需添加 junit。這三個 dependecy scope 都採用 test 即可。

<properties>
...
    <mybatis-plus-generator.version>3.5.3</mybatis-plus-generator.version>
</properties>

dependecies 中：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>${mybatis-plus-generator.version}</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <scope>test</scope>
</dependency>

3.2 編寫單元測試

在 src/test/java 下新建類：com.yygnb.demo.MyBatisPlusGeneratorTest，使用官方提供的新版方式進行程式碼生成的編寫：

@Test
public void testGenerate() {
    String url = "jdbc:mysql://localhost:3306/hero_springboot_demo?useUnicode=true&characterEncoding=utf8&useSSL=true";
    String username = "root";
    String password = "Mysql.123";
    String author = "hero-yyg";
    String outputDir = "/Users/hero/temp-code";
    String parentPackage = "com.yygnb.demo";
    String moduleName = null;
    String outputFileXml = "/Users/hero/temp-code/xml";

    FastAutoGenerator.create(url, username, password)
            .globalConfig(builder -> {
                builder.author(author) // 設置作者
                        .outputDir(outputDir); // 指定輸出目錄
            })
            .packageConfig(builder -> {
                builder.parent(parentPackage) // 設置父包名
                        .moduleName(moduleName) // 設置父包模組名
                        .pathInfo(Collections.singletonMap(OutputFile.xml, outputFileXml)); // 設置mapperXml生成路徑
            })
            .strategyConfig(builder -> {
                builder.addInclude("computer"); // 設置需要生成的表名
//                            .addTablePrefix("t_", "c_"); // 設置過濾表前綴
            })
            .templateEngine(new FreemarkerTemplateEngine()) // 使用Freemarker引擎模板，默認的是Velocity引擎模板
            .execute();
}

注意修改方法開始的變數定義，包括 JDBC url、username、password、生成的程式碼的輸出目錄，生成的mapper 的輸出目錄。修改後執行單元測試，在指定的目錄 /Users/hero/temp-code下可以看到生成的 controller、service、entity、mapper、xml。

4 程式碼編寫

4.1 實體類

將生成的實體類 Computer 複製到 com.yygnb.demo.entity中，生成的程式碼包括很多 Getter/Setter 等，可使用 前面引入的 lombok進行修改：

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Computer implements Serializable {

    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    /**
     * 尺寸
     */
    private BigDecimal size;

    /**
     * 作業系統
     */
    private String operation;

    /**
     * 年份
     */
    private String year;
}

4.2 mapper 和 service

  1. 將生成的 mapper 拷貝到 src/main/java 中 com.yygnb.demo.mapper.ComputerMapper
  2. 將生成的 service 目錄整個拷貝到 com.yygnb.demo中
  3. 將生成的 xml/ComputerMapper.xml 複製到 src/main/resources/mapper 下

4.3 編寫controller

編寫介面 com.yygnb.demo.controller.ComputerController:

package com.yygnb.demo.controller;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.yygnb.demo.entity.Computer;
import com.yygnb.demo.service.IComputerService;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.*;

@RequiredArgsConstructor
@RestController
@RequestMapping("/computer")
public class ComputerController {

    private final IComputerService computerService;

    @GetMapping("/{id}")
    public Computer findById(@PathVariable Long id) {
        return this.computerService.getById(id);
    }

    @GetMapping("/find-page/{page}/{size}")
    public Page<Computer> findPage(@PathVariable Integer page, @PathVariable Integer size) {
        return this.computerService.page(new Page<>(page, size));
    }

    @PostMapping()
    public Computer save(@RequestBody Computer computer) {
        computer.setId(null);
        this.computerService.save(computer);
        return computer;
    }

    @PutMapping("/{id}")
    public Computer update(@PathVariable Long id, @RequestBody Computer computer) {
        computer.setId(id);
        this.computerService.updateById(computer);
        return computer;
    }

    @DeleteMapping("/{id}")
    public void delete(@PathVariable Long id) {
        this.computerService.removeById(id);
    }
}

上面包含了五個介面：

1. 根據id查詢（get）
2. 分頁查詢（get）
3. 新增（post）
4. 根據id修改（put）
5. 根據id刪除（delete）

4.4 配置分頁攔截器

由於上面使用到分頁查詢，需要配置 MyBatis Plus 中的 Interceptor。創建類： com.yygnb.demo.config.MyBatisPlusConfig:

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor(){
        MybatisPlusInterceptor interceptor=new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

5 配置 MyBatis Plus

5.1 application.yml

在application.yml 配置數據源和 MyBatis Plus：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/hero_springboot_demo?useUnicode=true&characterEncoding=utf8&useSSL=true
    username: root
    password: Mysql.123
# mybatis 日誌
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

5.2 DemoApplication

在啟動類 DemoApplication下配置 Mapper 掃描路徑：

@MapperScan("com.yygnb.demo.mapper")
@SpringBootApplication
public class DemoApplication {

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

6 測試運行

至此，整合MyBatisPlus就完成了，啟動服務，分別測試五個介面。由於還沒有整合介面文檔，可以先在 postman 或其他工具中測試。postman 使用的人較多，也比較簡單。這裡我就採用 IDEA 內置的 HTTP Client 進行測試。

點擊頂部 "Tools" --> "HTTP Client" --> "Create request in HTTP Client"，會打開「rest-api.http」，在該介面可以編寫請求。點擊右上角的 "Add request" 可添加新請求。 多個請求之間，需要使用 ### 分隔。點擊請求左側的綠色三角便可執行請求。

image-20220726163327494

POST //localhost:9099/computer
Content-Type: application/json

{
  "id": "",
  "size": "18",
  "operation": "Linux",
  "year": "2023"
}
###

PUT //localhost:9099/computer/13
Content-Type: application/json

{
  "id": "",
  "size": "0",
  "operation": "Linux",
  "year": "2013"
}
###

DELETE //localhost:9099/computer/13
###

GET //localhost:9099/computer/13
###

GET //localhost:9099/computer/find-page/2/10
###

雖然集成 MyBatis Plus 實現了增刪改查介面，但上面的程式碼還存在很多問題：

  1. 資料庫的版本管理
  2. 介面的參數校驗和全局異常處理
  3. 日誌
  4. 介面文檔
  5. 資料庫連接池資訊監控
  6. 多環境配置
  7. 服務運行狀態監控等

上述問題都會在後續的文章中逐步完善demo。

今日優雅哥（youyacoder）學習結束，期待關注留言分享~~

Tags:

VirMach 便宜 VPS