MyBatis-Plus速成指南：简化你的数据库操作流程

苏-言

已于 2025-02-04 16:08:50 修改

阅读量779

点赞数 26

CC 4.0 BY-SA版权

文章标签： mybatis 数据库

于 2025-02-04 15:56:23 首次发布

本文链接：https://blog.youkuaiyun.com/SOS_suyan/article/details/145440795

简介：
1. MyBatis-Plus 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
2. MyBatsi-Plus 提供了通用的 Mapper 和 Service，可以不编写任何 SQL 语句的前提下，快速的实现单表的增删改查(CURD)，批量逻辑删除，分页等操作。只要把 MyBatis-Plus 的特性优秀插件，以及多数据源的配置进行详细讲解
特性：
1. 无入侵：只做增强不做改变，引入它不会对现有工程产生影响
2. 损耗小：启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作
3. 强大的 CURD 操作，更有强大的条件构造器，满足各类使用需求
4. 支持 Lambda 形式调用：同过 Lambda 表达式，方便的编写各类条件查询，无需担心字段写错
5. 支持主键自动生成：支持多达 4 种主键策略(内含分布式唯一 ID 生成器 - Sequence)，可自由配置，完美解决主键问题
6. 支持自定义全局通用操作：支持全局方法注入(Write once、use anywhere)
7. 内置代码生成器：采用代码或者 Maven 插件可快速生成 Mapper、Model、Service、Controller 层代码，支持模板引擎
8. 内置分页插件：基于 MyBatis 物理分页，开发者无需关心具体操作，配置好插件后，写分页等同于 List 查询
9. 分页插件支持多种数据库：支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库
10. 内置性能分析插件：可输出 SQL 语句以及其执行时间，建议开发测试时启用该功能，能快速救出慢查询
11. 内置全局拦截插件：提供全表delete、update操作，只能分析阻断，也可自定义拦截规则，预防误操作
支持数据库：
1. MySQL、Oracle、DB2、H2、HSQL、SQLite、PostgreSQL、SQLServer、Phoenix、Gauss、ClickHouse、Sybase、OceanBase、Firebird、Cubrid、Foldilocks、csiidb
框架结构：
代码及文档地址：
1. 官方地址：http://mp.baomidou.com
2. 代码发布地址：
  1. GitHub：GitHub - baomidou/mybatis-plus: An powerful enhanced toolkit of MyBatis for simplify development
  2. Gitee：mybatis-plus: mybatis 增强工具包，简化 CRUD 操作。文档 http://baomidou.com低代码组件库 http://aizuda.com
3. 文档发布地址：https://baomidou.com/pages/24112f

入门案例：

创建数据库和表:

CREATE DATABASE `mybatis_plus` /*!40100 DEFAULT CHARACTERSET utf8mb4 */; 
use `mybatis_plus`;
CREATE TABLE `user` (
`id` bigint(20) NOT NULL COMMENT '主键ID',
`name` varchar(30) DEFAULT NULL COMMENT '姓名 ',
`age` int(11) DEFAULT NULL COMMENT '年龄 ',
`email` varchar(50) DEFAULT NULL COMMENT '邮箱 ',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
INSERT INTO user (id, name, age, email) VALUES
(1, 'Jone', 18, 'test1@baomidou.com'),
(2, 'Jack', 20, 'test2@baomidou.com'),
(3, 'Tom', 28, 'test3@baomidou.com'),
(4, 'Sandy', 21, 'test4@baomidou.com'),
(5, 'Billie', 24, 'test5@baomidou.com');

创建 SpringBoot 工程

初始化工程：

导入依赖：

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

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

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.1</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

IDEA 中安装 Lombok 插件：

编写代码：

application.yml
```
spring:
# 配置数据源信息
datasource:
  # 配置数据源类型
  type: com.zaxxer.hikari.HikariDataSource
  # 配置连接数据库信息
  driver-class-name: com.mysql.cj.jdbc.Driver
  url: jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
  username: root
  password: root
```
1. 注意：
  1. 驱动类：driver-class-name
    1. SpringBoot 2.0(内置 jdbc5驱动)，驱动类使用：driver-class-name:comment.mysql.jdbc.Driver
    2. SpringBoot 2.1及以上(内置 jdbc8 驱动)，驱动类使用：driver-class-name:comment.mysql.cj.jdbc.Driver
  2. 连接地址 URL：
    1. MySQL5.7 的版本 url：
      1. jdbc:mysql://localhost:3306/mybatis-plus?characterEncoding=utf-8&useSSl=false
    2. MySQL8.0 版本的URL：
      1. jdbc:mysql://localhost:3306/mybatis_plus?serverTimezone=GMTZ%2B8&characterEncoding=utf-8&useSSL=false
    3. 否则运行测试用例报如下错误：
```
a.java.sql.SQLException:The server timezone value'ÖÐ¹ú±ê×¼Ê±¼ä' is unrecognized or representsmore
```

启动类：

在 SpringBoot 启动类中添加 @MapperScan 注解，扫描 mapper 包

@SpringBootApplication
@MapperScan("com.qcby.mybatisplus.mapper")
public class MybatisplusApplication {
    public static void main(String[] args) {
        SpringApplication.run(MybatisplusApplication.class, args); 
    }
}

添加实体类：

@Data
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

添加 Mapper：
1. BaseMapper 时 MyBatis-Plus 提供的 mapper 模板，其中包含了基本的 CURD 方法，泛型为操作的实体类型
```
public interface UserMapper extends BaseMapper<User> {
}
```

测试：

@SpringBootTest
public class MyBatisPlusApplicationTests {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void contextLoads() {

        //selectList() 根据 MP 内置的条件构造器查询一个 list 集合，null 表示没有条件,即查询所有
        userMapper.selectList(null).forEach(System.out::println);
    }
}

添加日志：

在 application.yml 中配置日志输出

# 配置MyBatis日志
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

结果：
1. 注意：
  1. IDEA 在 userMapper 处报错，因为找不到注入的对象，因为类是动态创建的，但是程序可以正确的运行
  2. 为了避免报错，可以在 mapper 接口上添加 @Repository 注解

MyBatis-Plus速成指南：简化你的数据库操作流程

简介：

特性：

支持数据库：

框架结构：

代码及文档地址：

入门案例：