Mybatis-Plus 系列：簡介和基本使用

一、簡介

官網：https://www.baomidou.com

MyBatis-Plus是一個 MyBatis 的增強工具，在 MyBatis 的基礎上只做增強不做改變，主要作用爲簡化開發、提高效率。

二、特性

• 無侵入：只做增強不做改變，引入它不會對現有工程產生影響，如絲般順滑
• 損耗小：啓動即會自動注入基本 CURD，性能基本無損耗，直接面向對象操作
• 強大的 CRUD 操作：內置通用 Mapper、通用 Service，僅僅通過少量配置即可實現單表大部分 CRUD 操作，更有強大的條件構造器，滿足各類使用需求
• 支持 Lambda 形式調用：通過 Lambda 表達式，方便的編寫各類查詢條件，無需再擔心字段寫錯
• 支持主鍵自動生成：支持多達 4 種主鍵策略（內含分佈式唯一 ID 生成器 - Sequence），可自由配置，完美解決主鍵問題
• 支持 ActiveRecord 模式：支持 ActiveRecord 形式調用，實體類只需繼承 Model 類即可進行強大的 CRUD 操作
• 支持自定義全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）
• 內置代碼生成器：採用代碼或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 層代碼，支持模板引擎，更有超多自定義配置等您來使用
• 內置分頁插件：基於 MyBatis 物理分頁，開發者無需關心具體操作，配置好插件之後，寫分頁等同於普通 List 查詢
• 分頁插件支持多種數據庫：支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多種數據庫
• 內置性能分析插件：可輸出 SQL 語句以及其執行時間，建議開發測試時啓用該功能，能快速揪出慢查詢
• 內置全局攔截插件：提供全表 delete 、 update 操作智能分析阻斷，也可自定義攔截規則，預防誤操作

三、基本使用

1、初始化數據庫

create database db_mybatisPlus character set utf8;
use db_mybatisPlus;
DROP TABLE IF EXISTS user;
CREATE TABLE user
(
id BIGINT(20) NOT NULL COMMENT '主鍵ID',
name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
age INT(11) NULL DEFAULT NULL COMMENT '年齡',
email VARCHAR(50) NULL DEFAULT NULL COMMENT '郵箱',
PRIMARY KEY (id)
);
INSERT INTO user (id, name, age, email) VALUES
(1, 'Jone', 18, '[email protected]'),
(2, 'Jack', 20, '[email protected]'),
(3, 'Tom', 28, '[email protected]'),
(4, 'Sandy', 21, '[email protected]'),
(5, 'Billie', 24, '[email protected]');

2、初始化工程

創建一個空的 Spring Boot 工程（工程將以 MySQL 作爲默認數據庫進行演示）

提示

可以使用 Spring Initializer 快速初始化一個 Spring Boot 工程

導入依賴

 <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>


        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.30</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus-boot-starter -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.3.2</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/com.alibaba/druid-spring-boot-starter -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.19</version>
        </dependency>

創建實體類

package com.mcode.javampdemo01.entity;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * ClassName: User
 * Package: com.mcode.javampdemo01.entity
 * Description:
 *
 * @Author robin
 * @Create 2023/9/25 22:54
 * @Version 1.0
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private  Long id;
    private String name;
    private Integer age;
    private String email;
}

集成 Mybatis-Plus

package com.mcode.javampdemo01.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.mcode.javampdemo01.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;

/**
 * ClassName: UserMapper
 * Package: com.mcode.javampdemo01.mapper
 * Description:
 *
 * @Author robin
 * @Create 2023/9/25 22:56
 * @Version 1.0
 */
@Mapper
public interface UserMapper extends BaseMapper<User> {
}

編寫 Service 接口

package com.mcode.javampdemo01.service;

import com.mcode.javampdemo01.entity.User;

import java.util.List;

/**
 * ClassName: UserService
 * Package: com.mcode.javampdemo01.service
 * Description:
 *
 * @Author robin
 * @Create 2023/9/25 22:58
 * @Version 1.0
 */
public interface UserService {
    List<User> selectList();
}

編寫 Service 實現

package com.mcode.javampdemo01.service.impl;

import com.mcode.javampdemo01.entity.User;
import com.mcode.javampdemo01.mapper.UserMapper;
import com.mcode.javampdemo01.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * ClassName: UserServiceImpl
 * Package: com.mcode.javampdemo01.service.impl
 * Description:
 *
 * @Author robin
 * @Create 2023/9/25 22:59
 * @Version 1.0
 */
@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public List<User> selectList() {
         return userMapper.selectList(null);
    }
}

編寫 Controller

package com.mcode.javampdemo01.controller;

import com.mcode.javampdemo01.entity.User;
import com.mcode.javampdemo01.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

/**
 * ClassName: UserController
 * Package: com.mcode.javampdemo01.controller
 * Description:
 *
 * @Author robin
 * @Create 2023/9/25 23:03
 * @Version 1.0
 */
@RestController
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/users")
    public List<User> selectList(){
        return  userService.selectList();
    }
}

編寫 application.yml

spring:
    datasource:
        driver-class-name: com.mysql.cj.jdbc.Driver
        username: root
        password: 123456
        # MyBatis 8 需要配置時區 serverTimezone=GMT%2B8
        url: jdbc:mysql://localhost:3306/db_mybatisplus?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8
        type: com.alibaba.druid.pool.DruidDataSource

測試結果

3、精簡 SpringBoot 相關日誌

去除 MybatisPlus 的 logo

mybatis-plus:
    global-config:
        banner: off

去除 SpringBoot 的 logo

spring:
    main:
        banner-mode: off

MybatisPlus 的執行日誌

mybatis-plus:
    configuration:
        log-impl: org.apache.ibatis.logging.stdout.StdOutImpl