mybatis plus 看这篇就够了，一发入魂

比眉伴天荒 2023-01-22 09:47 37阅读 0赞

### 文章目录 ###

*   *  一、快速入门
     *  二、核心功能
     *   *  （一）注解
         *  （二）CRUD 接口
         *   *   *  Mapper CRUD 接口
                 *  Service CRUD 接口
     *  三、条件构造器
     *   *  （一）使用示例
         *  （二）Condition
         *  （三）实体对象作为条件
         *  （四）allEq 方法
         *  （五）lambda 条件构造器
     *  四、更新操作
     *  五、删除操作
     *  六、自定义 SQL
     *   *  （一）原生 mybatis
         *  （二）mybatis-plus
     *  七、分页查询
     *  八、AR 模式
     *  九、主键策略
     *  十、配置
     *   *  （一）基本配置
         *  （二）进阶配置
     *  十一、代码生成器
     *  十二、高级功能
     *  十三、逻辑删除
     *  十四、自动填充
     *  十六、乐观锁插件
     *  十七、性能分析插件
     *  十八、多租户 SQL 解析器
     *  十九、动态表名 SQL 解析器
     *  二十、总结

**兔八哥领读：**

一篇写得非常详细的文章，增删改查，各种插件，让你测底熟悉mybatis plus。

--------------------

mybatis-plus 是一款 Mybatis 增强工具，用于简化开发，提高效率。下文使用缩写 **mp** 来简化表示 **mybatis-plus**，本文主要介绍 mp 搭配 SpringBoot 的使用。

注：本文使用的 mp 版本是当前最新的 3.4.2，早期版本的差异请自行查阅文档

官方网站：[baomidou.com/][baomidou.com]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70]

## 一、快速入门 ##

1.  创建一个 SpringBoot 项目
2.  导入依赖

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.3.4.RELEASE</version>
            <relativePath/> 
        </parent>
        <groupId>com.example</groupId>
        <artifactId>mybatis-plus</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>mybatis-plus</name>
        <properties>
            <java.version>1.8</java.version>
        </properties>
        <dependencies>
            <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>org.springframework.boot</groupId>
                <artifactId>spring-boot-configuration-processor</artifactId>
            </dependency>
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-boot-starter</artifactId>
                <version>3.4.2</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </dependency>
        </dependencies>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    </project>

1.  配置数据库

spring:
      datasource:
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://localhost:3306/yogurt?serverTimezone=Asia/Shanghai
        username: root
        password: root 
    mybatis-plus:
      configuration:
        log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

1.  创建一个实体类

package com.example.mp.po;
    import lombok.Data;
    import java.time.LocalDateTime;
    @Data
    public class User { 
    	private Long id;
    	private String name;
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

1.  创建一个 mapper 接口

package com.example.mp.mappers;
    
    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import com.example.mp.po.User;
    
    public interface UserMapper extends BaseMapper<User> {  }

1.  在 SpringBoot 启动类上配置 mapper 接口的扫描路径

package com.example.mp;
    import org.mybatis.spring.annotation.MapperScan;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    @SpringBootApplication
    @MapperScan("com.example.mp.mappers")
    public class MybatisPlusApplication { 
    	public static void main(String[] args) { 
    		SpringApplication.run(MybatisPlusApplication.class, args);
    	}
    }

1.  在数据库中创建表

DROP TABLE IF EXISTS user;
    CREATE TABLE user (
    id BIGINT(20) PRIMARY KEY NOT NULL COMMENT '主键',
    name VARCHAR(30) DEFAULT NULL COMMENT '姓名',
    age INT(11) DEFAULT NULL COMMENT '年龄',
    email VARCHAR(50) DEFAULT NULL COMMENT '邮箱',
    manager_id BIGINT(20) DEFAULT NULL COMMENT '直属上级id',
    create_time DATETIME DEFAULT NULL COMMENT '创建时间',
    CONSTRAINT manager_fk FOREIGN KEY(manager_id) REFERENCES user (id)
    ) ENGINE=INNODB CHARSET=UTF8;
    
    INSERT INTO user (id, name, age ,email, manager_id, create_time) VALUES
    (1, '大BOSS', 40, 'boss@baomidou.com', NULL, '2021-03-22 09:48:00'),
    (2, '李经理', 40, 'boss@baomidou.com', 1, '2021-01-22 09:48:00'),
    (3, '黄主管', 40, 'boss@baomidou.com', 2, '2021-01-22 09:48:00'),
    (4, '吴组长', 40, 'boss@baomidou.com', 2, '2021-02-22 09:48:00'),
    (5, '小菜', 40, 'boss@baomidou.com', 2, '2021-02-22 09:48:00')

1.  编写一个 SpringBoot 测试类

package com.example.mp;
    import com.example.mp.mappers.UserMapper;
    import com.example.mp.po.User;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    import java.util.List;
    import static org.junit.Assert.*;
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class SampleTest { 
    	@Autowired
    	private UserMapper mapper;
    	@Test
    	public void testSelect() { 
    		List<User> list = mapper.selectList(null);
    		assertEquals(5, list.size());
    		list.forEach(System.out::println);
    	}
    }

1.  准备工作完成

数据库情况如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 1]  
项目目录如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 2]  
运行测试类：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 3]  
可以看到，针对单表的基本 CRUD 操作，只需要创建好实体类，并创建一个继承自BaseMapper的接口即可，可谓非常简洁。并且，我们注意到，`User`类中的`managerId`，`createTime`属性，自动和数据库表中的`manager_id`，`create_time`对应了起来，这是因为 `mp` 自动做了数据库下划线命名，到 Java 类的驼峰命名之间的转化。

## 二、核心功能 ##

### （一）注解 ###

mp 一共提供了 8 个注解，这些注解是用在 Java 的实体类上面的。

`@TableName`

*  注解在类上，指定类和数据库表的映射关系。**实体类的类名（转成小写后）和数据库表名相同时**，可以不指定该注解。

`@TableId`

*  注解在实体类的某一字段上，**表示这个字段对应数据库表的主键**。当主键名为 id 时（表中列名为 id，实体类中字段名为 id），无需使用该注解显式指定主键，mp 会自动关联。若类的字段名和表的列名不一致，可用value属性指定表的列名。另，这个注解有个重要的属性type，用于指定主键策略，参见主键策略小节

`@TableField`

*  注解在某一字段上，指定 Java 实体类的字段和数据库表的列的映射关系。这个注解有如下几个应用场景。
 *  *排除非表字段*
    
    若 Java 实体类中某个字段，不对应表中的任何列，它只是用于保存一些额外的，或组装后的数据，则可以设置`exist`属性为`false`，这样在对实体对象进行插入时，会忽略这个字段。排除非表字段也可以通过其他方式完成，如使用`static`或`transient`关键字，但个人觉得不是很合理，不做赘述
 *  *字段验证策略*
    
    通过`insertStrategy`，`updateStrategy`，`whereStrategy`属性进行配置，可以控制在实体对象进行插入，更新，或作为 WHERE 条件时，对象中的字段要如何组装到 SQL 语句中。参见配置小节
 *  *字段填充策略*  
    通过`fill`属性指定，字段为空时会进行自动填充

`@Version`

*  乐观锁注解，参见乐观锁小节

`@EnumValue`

*  注解在枚举字段上

`@TableLogic`

*  逻辑删除，参见逻辑删除小节

`KeySequence`

*  序列主键策略（oracle）

`InterceptorIgnore`

*  插件过滤规则

### （二）CRUD 接口 ###

mp 封装了一些最基础的 CRUD 方法，只需要直接继承 mp 提供的接口，无需编写任何 SQL，即可食用。mp 提供了两套接口，分别是 Mapper CRUD 接口和 Service CRUD 接口。并且 mp 还提供了条件构造器`Wrapper`，可以方便地组装 SQL 语句中的 WHERE 条件，参见条件构造器小节

##### Mapper CRUD 接口 #####

只需定义好实体类，然后创建一个接口，继承 mp 提供的BaseMapper，即可食用。mp 会在 mybatis 启动时，自动解析实体类和表的映射关系，并注入带有通用 CRUD 方法的 mapper。BaseMapper里提供的方法，部分列举如下：

*  `insert(T entity)` 插入一条记录
 *  `deleteById(Serializable id)` 根据主键 id 删除一条记录
 *  `delete(Wrapper<T> wrapper)` 根据条件构造器 wrapper 进行删除
 *  `selectById(Serializable id)` 根据主键 id 进行查找
 *  `selectBatchIds(Collection idList)` 根据主键 id 进行批量查找
 *  `selectByMap(Map<String,Object> map)`根据 map 中指定的列名和列值进行**等值匹配查找**
 *  `selectMaps(Wrapper<T> wrapper)` 根据 wrapper 条件，查询记录，将查询结果封装为一个 Map，Map的 key 为结果的列，value 为值
 *  `selectList(Wrapper<T> wrapper)` 根据条件构造器`wrapper`进行查询
 *  `update(T entity, Wrapper<T> wrapper)` 根据条件构造器`wrapper`进行更新
 *  `updateById(T entity)`
 *  …

简单的食用示例如前文快速入门小节，下面讲解几个比较特别的方法

`selectMaps`

*  `BaseMapper`接口还提供了一个`selectMaps`方法，这个方法会将查询结果封装为一个 Map，Map 的 key 为结果的列，value 为值

该方法的使用场景如下：

*  *只查部分列*  
    当某个表的列特别多，而 SELECT 的时候只需要选取个别列，查询出的结果也没必要封装成 Java 实体类对象时（只查部分列时，封装成实体后，实体对象中的很多属性会是 null），则可以用`selectMaps`，获取到指定的列后，再自行进行处理即可

比如

@Test
    public void test1() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	wrapper.select("id","name","email").likeRight("name","黄");
    	List<Map<String, Object>> maps = mapper.selectMaps(wrapper);
    	maps.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 4]

*  *进行数据统计*

比如

@Test
    public void test2() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	wrapper.select("manager_id", "avg(age) avg_age", "min(age) min_age", "max(age) max_age")
    			.groupBy("manager_id").having("sum(age) < {0}", 500);
    	List<Map<String, Object>> maps = mapper.selectMaps(wrapper);
    	maps.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 5]  
`selectObjs`

*  只会返回第一个字段（第一列）的值，其他字段会被舍弃

比如

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	wrapper.select("id", "name").like("name", "黄");
    	List<Object> objects = mapper.selectObjs(wrapper);
    	objects.forEach(System.out::println);
    }

得到的结果，只封装了第一列的 id  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 6]  
`selectCount`

*  查询满足条件的总数，注意，使用这个方法，不能调用`QueryWrapper`的`select`方法设置要查询的列了。这个方法会自动添加`select count(1)`

比如

@Test
    public void test4() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	wrapper.like("name", "黄");
    
    	Integer count = mapper.selectCount(wrapper);
    	System.out.println(count);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 7]

##### Service CRUD 接口 #####

另外一套 CRUD 是 Service 层的，只需要编写一个接口，继承`IService`，并创建一个接口实现类，即可食用。（这个接口提供的 CRUD 方法，和 `Mapper`接口提供的功能大同小异，**比较明显的区别在于`IService`支持了更多的批量化操作**，如`saveBatch`，`saveOrUpdateBatch`等方法。

使用示例如下：

1.  首先，新建一个接口，继承`IService`

package com.example.mp.service;
    
    import com.baomidou.mybatisplus.extension.service.IService;
    import com.example.mp.po.User;
    
    public interface UserService extends IService<User> { }

1.  创建这个接口的实现类，并继承`ServiceImpl`，最后打上`@Service`注解，注册到 Spring 容器中，即可食用

package com.example.mp.service.impl;
    
    import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
    import com.example.mp.mappers.UserMapper;
    import com.example.mp.po.User;
    import com.example.mp.service.UserService;
    import org.springframework.stereotype.Service;
    
    @Service
    public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {  }

1.  测试代码

package com.example.mp;
    
    import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
    import com.baomidou.mybatisplus.core.toolkit.Wrappers;
    import com.example.mp.po.User;
    import com.example.mp.service.UserService;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class ServiceTest { 
    	@Autowired
    	private UserService userService;
    	@Test
    	public void testGetOne() { 
    		LambdaQueryWrapper<User> wrapper = Wrappers.<User>lambdaQuery();
    		wrapper.gt(User::getAge, 28);
    		User one = userService.getOne(wrapper, false); 
    		System.out.println(one);
    	}
    }

1.  结果

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 8]  
另，IService也支持链式调用，代码写起来非常简洁，查询示例如下：

@Test
    public void testChain() { 
    	List<User> list = userService.lambdaQuery()
    			.gt(User::getAge, 39)
    			.likeRight(User::getName, "黄")
    			.list();
    	list.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 9]  
**更新示例如下**

@Test
    public void testChain() { 
    	userService.lambdaUpdate()
    			.gt(User::getAge, 39)
    			.likeRight(User::getName, "王")
    			.set(User::getEmail, "w39@baomidou.com")
    			.update();
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 10]  
**删除示例如下**

@Test
    public void testChain() { 
    	userService.lambdaUpdate()
    			.like(User::getName, "王强")
    			.remove();
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 11]

## 三、条件构造器 ##

mp 让我觉得极其方便的一点在于其提供了强大的条件构造器`Wrapper`，可以非常方便的构造 `WHERE`条件。条件构造器主要涉及到 3 个类，`AbstractWrapper`。`QueryWrapper`，`UpdateWrapper`，它们的类关系如下  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 12]  
在 `AbstractWrapper` 中提供了非常多的方法用于构建 `WHERE` 条件，而 `QueryWrapper` 针对 `SELECT` 语句，提供了`select()`方法，可自定义需要查询的列，而 `UpdateWrapper` 针对 `UPDATE` 语句，提供了 `set()` 方法，用于构造 `set` 语句。条件构造器也支持 `lambda` 表达式，写起来非常舒爽。

下面对 `AbstractWrapper` 中用于构建 SQL 语句中的 `WHERE` 条件的方法进行部分列举

*  `eq`：equals，等于
 *  `allEq`：all equals，全等于
 *  `ne`：not equals，不等于
 *  `gt`：greater than ，大于 `>`
 *  `ge`：greater than or equals，大于等于`≥`
 *  `lt`：less than，小于`<`
 *  `le`：less than or equals，小于等于`≤`
 *  `between`：相当于 SQL 中的 BETWEEN
 *  `notBetween`
 *  `like`：模糊匹配。`like("name","黄")`，相当于 SQL 的`name like '%黄%'`
 *  `likeRight`：模糊匹配右半边。`likeRight("name","黄")`，相当于 SQL 的`name like '黄%'`
 *  `likeLeft`：模糊匹配左半边。`likeLeft("name","黄")`，相当于 SQL 的`name like '%黄'`
 *  `notLike`：`notLike("name","黄")`，相当于 SQL 的`name not like '%黄%'`
 *  `isNull`
 *  `isNotNull`
 *  `in`
 *  `and`：SQL 连接符 AND
 *  `or`：SQL 连接符 OR
 *  `apply`：用于拼接 SQL，该方法可用于数据库函数，并可以动态传参
 *  …

### （一）使用示例 ###

下面通过一些具体的案例来练习条件构造器的使用。（使用前文创建的user表）

QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.like("name", "佳").lt("age", 25);
    List<User> users = userMapper.selectList(wrapper);
    
    wrapper.likeRight("name","黄").between("age", 20, 40).isNotNull("email");
    
    wrapper.likeRight("name","黄").or().ge("age",40).orderByDesc("age").orderByAsc("id");
    
    wrapper.apply("date_format(create_time, '%Y-%m-%d') = {0}", "2021-03-22")  
    				.inSql("manager_id", "SELECT id FROM user WHERE name like '李%'");
    
    wrapper.apply("date_format(create_time, '%Y-%m-%d') = '2021-03-22'");
    
    wrapper.likeRight("name", "王").and(q -> q.lt("age", 40).or().isNotNull("email"));
    
    wrapper.likeRight("name", "王").or(
    				q -> q.lt("age",40)
    						.gt("age",20)
    						.isNotNull("email")
    		);
    
    wrapper.nested(q -> q.lt("age", 40).or().isNotNull("email"))
    				.likeRight("name", "王");
    
    wrapper.in("age", Arrays.asList(30,31,34,35));
    
    wrapper.inSql("age","30,31,34,35");
    
    wrapper.in("age", Arrays.asList(30,31,34,35)).last("LIMIT 1");
    
    wrapper.select("id", "name");
    
    wrapper.select(User.class, info -> { 
    			String columnName = info.getColumn();
    			return !"create_time".equals(columnName) && !"manager_id".equals(columnName);
    		});

### （二）Condition ###

条件构造器的诸多方法中，均可以指定一个`boolean`类型的参数`condition`，用来决定该条件是否加入最后生成的 WHERE 语句中，比如

String name = "黄"; 
    QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.like(StringUtils.hasText(name), "name", name);
    
    if (StringUtils.hasText(name)) { 
    	wrapper.like("name", name);
    }

### （三）实体对象作为条件 ###

调用构造函数创建一个`Wrapper`对象时，可以传入一个实体对象。后续使用这个Wrapper时，会以实体对象中的非空属性，构建 WHERE 条件（默认构建 **等值匹配** 的 WHERE 条件，这个行为可以通过实体类里各个字段上的`@TableField`注解中的`condition`属性进行改变）

示例如下

@Test
    public void test3() { 
    	User user = new User();
    	user.setName("黄主管");
    	user.setAge(28);
    	QueryWrapper<User> wrapper = new QueryWrapper<>(user);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

执行结果如下。可以看到，是根据实体对象中的非空属性，进行了 **等值匹配查询**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 13]  
若希望针对某些属性，改变 **等值匹配** 的行为，则可以在实体类中用`@TableField`注解进行配置，示例如下

package com.example.mp.po;
    import com.baomidou.mybatisplus.annotation.SqlCondition;
    import com.baomidou.mybatisplus.annotation.TableField;
    import lombok.Data;
    import java.time.LocalDateTime;
    @Data
    public class User { 
    	private Long id;
    	@TableField(condition = SqlCondition.LIKE)   
    	private String name;
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

运行下面的测试代码

@Test
    public void test3() { 
    	User user = new User();
    	user.setName("黄");
    	QueryWrapper<User> wrapper = new QueryWrapper<>(user);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

从下图得到的结果来看，对于实体对象中的`name`字段，采用了`like`进行拼接  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 14]

`@TableField`中配置的`condition`属性实则是一个字符串，`SqlCondition`类中预定义了一些字符串以供选择

package com.baomidou.mybatisplus.annotation;
    
    public class SqlCondition { 
        
        public static final String EQUAL = "%s=#{%s}";
        public static final String NOT_EQUAL = "%s<>#{%s}";
        public static final String LIKE = "%s LIKE CONCAT('%%',#{%s},'%%')";
        public static final String LIKE_LEFT = "%s LIKE CONCAT('%%',#{%s})";
        public static final String LIKE_RIGHT = "%s LIKE CONCAT(#{%s},'%%')";
    }

`SqlCondition`中提供的配置比较有限，当我们需要 `<` 或 `>` 等拼接方式，则需要自己定义。比如

package com.example.mp.po;
    import com.baomidou.mybatisplus.annotation.SqlCondition;
    import com.baomidou.mybatisplus.annotation.TableField;
    import lombok.Data;
    import java.time.LocalDateTime;
    @Data
    public class User { 
    	private Long id;
    	@TableField(condition = SqlCondition.LIKE)
    	private String name;
        @TableField(condition = "%s > #{%s}")   
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

测试如下

@Test
    public void test3() { 
    	User user = new User();
    	user.setName("黄");
        user.setAge(30);
    	QueryWrapper<User> wrapper = new QueryWrapper<>(user);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

从下图得到的结果，可以看出，`name`属性是用 `like` 拼接的，而 `age` 属性是用 `>` 拼接的  
![在这里插入图片描述][20210519151246580.png]

### （四）allEq 方法 ###

`allEq` 方法传入一个`map`，用来做等值匹配

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	Map<String, Object> param = new HashMap<>();
    	param.put("age", 40);
    	param.put("name", "黄飞飞");
    	wrapper.allEq(param);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][20210519151517374.png]

当 `allEq` 方法传入的 `Map` 中有 `value` 为`null`的元素时，默认会设置为`is null`

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	Map<String, Object> param = new HashMap<>();
    	param.put("age", 40);
    	param.put("name", null);
    	wrapper.allEq(param);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][20210519151540752.png]  
若想忽略 `map` 中 `value` 为 `null` 的元素，可以在调用 `allEq` 时，设置参数`boolean null2IsNull` 为 `false`

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	Map<String, Object> param = new HashMap<>();
    	param.put("age", 40);
    	param.put("name", null);
    	wrapper.allEq(param, false);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 15]  
若想要在执行 allEq 时，过滤掉 Map 中的某些元素，可以调用 allEq 的重载方法`allEq(BiPredicate<R, V> filter, Map<R, V> params)`

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	Map<String, Object> param = new HashMap<>();
    	param.put("age", 40);
    	param.put("name", "黄飞飞");
    	wrapper.allEq((k,v) -> !"name".equals(k), param); 
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 16]

### （五）lambda 条件构造器 ###

lambda 条件构造器，支持 lambda 表达式，可以不必像普通条件构造器一样，以字符串形式指定列名，它可以直接以实体类的 **方法引用** 来指定列。示例如下

@Test
    public void testLambda() { 
    	LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
    	wrapper.like(User::getName, "黄").lt(User::getAge, 30);
    	List<User> users = userMapper.selectList(wrapper);
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][20210519151908930.png]  
像普通的条件构造器，列名是用字符串的形式指定，无法在编译期进行列名合法性的检查，这就不如 lambda 条件构造器来的优雅。

另外，还有个 **链式 lambda 条件构造器** ，使用示例如下

@Test
    public void testLambda() { 
    	LambdaQueryChainWrapper<User> chainWrapper = new LambdaQueryChainWrapper<>(userMapper);
    	List<User> users = chainWrapper.like(User::getName, "黄").gt(User::getAge, 30).list();
    	users.forEach(System.out::println);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 17]

## 四、更新操作 ##

上面介绍的都是查询操作, 现在来讲更新和删除操作。

`BaseMapper`中提供了 2 个更新方法

*  `updateById(T entity)`  
    根据入参 `entity` 的 `id`（主键）进行更新，对于 `entity` 中非空的属性，会出现在 `UPDATE` 语句的 `SET` 后面，即 `entity` 中非空的属性，会被更新到数据库，示例如下

@RunWith(SpringRunner.class)
    @SpringBootTest
    public class UpdateTest { 
    	@Autowired
    	private UserMapper userMapper;
    	@Test
    	public void testUpdate() { 
    		User user = new User();
    		user.setId(2L);
    		user.setAge(18);
    		userMapper.updateById(user);
    	}
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 18]

*  `update(T entity, Wrapper<T> wrapper)`  
    根据实体 `entity` 和条件构造器 `wrapper` 进行更新，示例如下

@Test
    public void testUpdate2() { 
    	User user = new User();
    	user.setName("王三蛋");
    	LambdaUpdateWrapper<User> wrapper = new LambdaUpdateWrapper<>();
    	wrapper.between(User::getAge, 26,31).likeRight(User::getName,"吴");
    	userMapper.update(user, wrapper);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 19]

额外演示一下，把实体对象传入 `Wrapper` ，即用实体对象构造 `WHERE` 条件的案例

@Test
    public void testUpdate3() { 
    	User whereUser = new User();
    	whereUser.setAge(40);
    	whereUser.setName("王");
    
    	LambdaUpdateWrapper<User> wrapper = new LambdaUpdateWrapper<>(whereUser);
    	User user = new User();
    	user.setEmail("share@baomidou.com");
    	user.setManagerId(10L);
    
    	userMapper.update(user, wrapper);
    }

注意到我们的 User 类中，对 `name` 属性和 `age` 属性进行了如下的设置

@Data
    public class User { 
    	private Long id;
    	@TableField(condition = SqlCondition.LIKE)
    	private String name;
    	@TableField(condition = "%s > #{%s}")
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

执行结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 20]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 21]  
再额外演示一下，链式 lambda 条件构造器的使用

@Test
    public void testUpdate5() { 
    	LambdaUpdateChainWrapper<User> wrapper = new LambdaUpdateChainWrapper<>(userMapper);
    	wrapper.likeRight(User::getEmail, "share")
    			.like(User::getName, "飞飞")
    			.set(User::getEmail, "ff@baomidou.com")
    			.update();
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 22]  
**反思**

由于 `BaseMapper` 提供的 2 个更新方法都是传入一个实体对象去执行更新，这在需要更新的列比较多时还好，若想要更新的只有那么一列，或者两列，则创建一个实体对象就显得有点麻烦。针对这种情况，`UpdateWrapper` 提供有 `set` 方法，可以手动拼接 SQL 中的 SET 语句，此时可以不必传入实体对象，示例如下

@Test
    	public void testUpdate4() { 
    		LambdaUpdateWrapper<User> wrapper = new LambdaUpdateWrapper<>();
    		wrapper.likeRight(User::getEmail, "share").set(User::getManagerId, 9L);
    		userMapper.update(null, wrapper);
    	}

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 23]

## 五、删除操作 ##

`BaseMapper`一共提供了如下几个用于删除的方法

*  `deleteById` 根据主键 id 进行删除
 *  `deleteBatchIds` 根据主键 id 进行批量删除
 *  `deleteByMap` 根据 Map 进行删除（Map 中的 key 为列名，value 为值，根据列和值进行等值匹配）
 *  `delete(Wrapper<T> wrapper)` 根据条件构造器Wrapper进行删除

与前面查询和更新的操作大同小异，不做赘述

## 六、自定义 SQL ##

当 mp 提供的方法还不能满足需求时，则可以自定义 SQL。

### （一）原生 mybatis ###

示例如下

*  **注解方式**

package com.example.mp.mappers;
    
    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import com.example.mp.po.User;
    import org.apache.ibatis.annotations.Select;
    import java.util.List;
    
    public interface UserMapper extends BaseMapper<User> { 
    	@Select("select * from user")
    	List<User> selectRaw();
    }

*  **xml 方式**

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.example.mp.mappers.UserMapper">
    	<select resultType="com.example.mp.po.User">
            SELECT * FROM user
        </select>
    </mapper>

使用 xml 时，***若 xml 文件与 mapper 接口文件不在同一目录下***，则需要在 `application.yml` 中配置 `mapper.xml` 的存放路径

mybatis-plus:
      mapper-locations: /mappers/*

若有多个地方存放 mapper，则用数组形式进行配置

mybatis-plus:
      mapper-locations: 
      - /mappers/* - /com/example/mp/*

测试代码如下

@Test
    public void testCustomRawSql() { 
    	List<User> users = userMapper.selectRaw();
    	users.forEach(System.out::println);
    }

结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 24]

### （二）mybatis-plus ###

也可以使用 mp 提供的 Wrapper 条件构造器，来自定义 SQL

示例如下

*  **注解方式**

package com.example.mp.mappers;
    import com.baomidou.mybatisplus.core.conditions.Wrapper;
    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import com.baomidou.mybatisplus.core.toolkit.Constants;
    import com.example.mp.po.User;
    import org.apache.ibatis.annotations.Param;
    import org.apache.ibatis.annotations.Select;
    import java.util.List;
    
    public interface UserMapper extends BaseMapper<User> { 
    	@Select("select * from user ${ew.customSqlSegment}")
    	List<User> findAll(@Param(Constants.WRAPPER)Wrapper<User> wrapper);
    }

*  **xml 方式**

package com.example.mp.mappers;
    import com.baomidou.mybatisplus.core.conditions.Wrapper;
    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import com.example.mp.po.User;
    import java.util.List;
    
    public interface UserMapper extends BaseMapper<User> { 
    	List<User> findAll(Wrapper<User> wrapper);
    }

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.example.mp.mappers.UserMapper">
        <select resultType="com.example.mp.po.User">
            SELECT * FROM user ${ew.customSqlSegment}
        </select>
    </mapper>

## 七、分页查询 ##

`BaseMapper` 中提供了 2 个方法进行分页查询，分别是 `selectPage` 和 `selectMapsPage`，前者会将查询的结果封装成 Java 实体对象，后者会封装成 `Map<String,Object>` 。分页查询的使用示例如下

1、创建 mp 的分页拦截器，注册到 Spring 容器中

package com.example.mp.config;
    import com.baomidou.mybatisplus.annotation.DbType;
    import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
    import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    
    @Configuration
    public class MybatisPlusConfig { 
    	@Bean
    	public MybatisPlusInterceptor mybatisPlusInterceptor() { 
    		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    		interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
    		return interceptor;
    	}
    }

2、执行分页查询

@Test
    public void testPage() { 
    	LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
    	wrapper.ge(User::getAge, 28);
           
    	Page<User> page = new Page<>(3, 2);
           
    	Page<User> userPage = userMapper.selectPage(page, wrapper);
    	System.out.println("总记录数 = " + userPage.getTotal());
    	System.out.println("总页数 = " + userPage.getPages());
    	System.out.println("当前页码 = " + userPage.getCurrent());
           
    	List<User> records = userPage.getRecords();
    	records.forEach(System.out::println);
    }

3、结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 25]4、其他

*  注意到，分页查询总共发出了 2 次 SQL，一次查总记录数，一次查具体数据。**若希望不查总记录数，仅查分页结果**。可以通过 `Page` 的重载构造函数，指定 `isSearchCount` 为 `false` 即可

public Page(long current, long size, boolean isSearchCount)

*  在实际开发中，可能遇到多表联查的场景，此时`BaseMapper`中提供的单表分页查询的方法无法满足需求，需要自定义 SQL，示例如下（使用单表查询的 SQL 进行演示，实际进行多表联查时，修改 SQL 语句即可）

（a）在 mapper 接口中定义一个函数，接收一个 Page 对象为参数，并编写自定义 SQL

@Select("SELECT * FROM user ${ew.customSqlSegment}")
    Page<User> selectUserPage(Page<User> page, @Param(Constants.WRAPPER) Wrapper<User> wrapper);

（b） 执行查询

@Test
    public void testPage2() { 
    	LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
    	wrapper.ge(User::getAge, 28).likeRight(User::getName, "王");
    	Page<User> page = new Page<>(3,2);
    	Page<User> userPage = userMapper.selectUserPage(page, wrapper);
    	System.out.println("总记录数 = " + userPage.getTotal());
    	System.out.println("总页数 = " + userPage.getPages());
    	userPage.getRecords().forEach(System.out::println);
    }

（c）结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 26]

## 八、AR 模式 ##

`ActiveRecord` 模式，通过操作实体对象，直接操作数据库表。与 ORM 有点类似。

示例如下

1、让实体类User继承自Model

package com.example.mp.po;
    
    import com.baomidou.mybatisplus.annotation.SqlCondition;
    import com.baomidou.mybatisplus.annotation.TableField;
    import com.baomidou.mybatisplus.extension.activerecord.Model;
    import lombok.Data;
    import lombok.EqualsAndHashCode;
    import java.time.LocalDateTime;
    
    @EqualsAndHashCode(callSuper = false)
    @Data
    public class User extends Model<User> { 
    	private Long id;
    	@TableField(condition = SqlCondition.LIKE)
    	private String name;
    	@TableField(condition = "%s > #{%s}")
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

2、直接调用实体对象上的方法

@Test
    public void insertAr() { 
    	User user = new User();
    	user.setId(15L);
    	user.setName("我是AR猪");
    	user.setAge(1);
    	user.setEmail("ar@baomidou.com");
    	user.setManagerId(1L);
    	boolean success = user.insert(); 
    	System.out.println(success);
    }

3、结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 27]  
4、其他示例

@Test
    public void selectAr() { 
    	User user = new User();
        user.setId(15L);
    	User result = user.selectById();
    	System.out.println(result);
    }
    
    @Test
    public void updateAr() { 
    	User user = new User();
    	user.setId(15L);
    	user.setName("王全蛋");
    	user.updateById();
    }
    
    @Test
    public void deleteAr() { 
    	User user = new User();
    	user.setId(15L);
    	user.deleteById();
    }

## 九、主键策略 ##

在定义实体类时，用 `@TableId` 指定主键，而其`type`属性，可以指定主键策略。

mp 支持多种主键策略，默认的策略是基于雪花算法的自增 id。全部主键策略定义在了枚举类 `IdType` 中，`IdType` 有如下的取值

*  `AUTO`  
    数据库 ID 自增，**依赖于数据库**。在插入操作生成 SQL 语句时，不会插入主键这一列
 *  `NONE`  
    未设置主键类型。若在代码中没有手动设置主键，则会根据 **主键的全局策略** 自动生成（默认的主键全局策略是基于雪花算法的自增 ID）
 *  `INPUT`  
    需要手动设置主键，若不设置。插入操作生成 SQL 语句时，主键这一列的值会是 `null` 。oracle 的序列主键需要使用这种方式
 *  `ASSIGN_ID`  
    当没有手动设置主键，即实体类中的主键属性为空时，才会自动填充，使用雪花算法
 *  `ASSIGN_UUID`  
    当实体类的主键属性为空时，才会自动填充，使用 UUID
 *  …（还有几种是已过时的，就不再列举）

可以针对每个实体类，使用 `@TableId` 注解指定该实体类的主键策略，这可以理解为 **局部策略** 。若希望对所有的实体类，都采用同一种主键策略，挨个在每个实体类上进行配置，则太麻烦了，此时可以用主键的 **全局策略** 。只需要在 `application.yml` 进行配置即可。比如，配置了全局采用自增主键策略

mybatis-plus:
      global-config:
        db-config:
          id-type: auto

下面对不同主键策略的行为进行演示

*  **AUTO**  
    在 `User` 上对 `id` 属性加上注解，然后将 `MYSQL` 的 `user` 表修改其主键为自增。

@EqualsAndHashCode(callSuper = false)
    @Data
    public class User extends Model<User> { 
    	@TableId(type = IdType.AUTO)
    	private Long id;
    	@TableField(condition = SqlCondition.LIKE)
    	private String name;
    	@TableField(condition = "%s > #{%s}")
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    }

测试

@Test
    public void testAuto() { 
    	User user = new User();
    	user.setName("我是青蛙呱呱");
    	user.setAge(99);
    	user.setEmail("frog@baomidou.com");
    	user.setCreateTime(LocalDateTime.now());
    	userMapper.insert(user);
        System.out.println(user.getId());
    }

结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 28]  
可以看到，代码中没有设置主键 ID，发出的 SQL 语句中也没有设置主键 ID，并且插入结束后，主键 ID 会被写回到实体对象。

*  `NONE`

在 MYSQL 的 `user` 表中，去掉主键自增。然后修改 `User` 类（若不配置 `@TableId` 注解，默认主键策略也是NONE）

@TableId(type = IdType.NONE)
    private Long id;

插入时，若实体类的主键 ID 有值，则使用之；若主键 ID 为空，则使用主键全局策略，来生成一个 ID。

其余的策略类似，不赘述

**小结**

`AUTO`依赖于数据库的自增主键，插入时，实体对象无需设置主键，插入成功后，主键会被写回实体对象。

INPUT完全依赖于用户输入。实体对象中主键 ID 是什么，插入到数据库时就设置什么。若有值便设置值，若为 `null` 则设置 `null`

其余的几个策略，都是在实体对象中主键 ID 为空时，才会自动生成。

`NONE`会跟随全局策略，`ASSIGN_ID`采用雪花算法，`ASSIGN_UUID`采用 `UUID`

全局配置，在 `application.yml` 中进行即可；针对单个实体类的局部配置，使用 `@TableId` 即可。对于某个实体类，若它有局部主键策略，则采用之，否则，跟随全局策略。

## 十、配置 ##

mybatis plus 有许多可配置项，可在application.yml中进行配置，如上面的全局主键策略。下面列举部分配置项

### （一）基本配置 ###

*  `configLocation`：若有单独的 `mybatis` 配置，用这个注解指定 `mybatis` 的配置文件（mybatis 的全局配置文件）
 *  `mapperLocations`：`mybatis mapper` 所对应的 xml 文件的位置
 *  `typeAliasesPackage`：mybatis 的别名包扫描路径
 *  …

### （二）进阶配置 ###

*  `mapUnderscoreToCamelCase`：是否开启自动驼峰命名规则映射。（默认开启）
 *  `dbTpe`：数据库类型。一般不用配，会根据数据库连接 url 自动识别
 *  `fieldStrategy`：（已过时）字段验证策略。**该配置项在最新版的 mp 文档中已经找不到了** ，被细分成了`insertStrategy`，`updateStrategy`，`selectStrategy`。默认值是`NOT_NULL`，即对于实体对象中非空的字段，才会组装到最终的 SQL 语句中。

> 有如下几种可选配置
> 
> 这个配置项，可在`application.yml`中进行**全局配置**，也可以在某一实体类中，对某一字段用`@TableField`注解进行**局部配置**
> 
> --------------------
> 
> **这个字段验证策略有什么用呢？**
> 
> > 在 UPDATE 操作中能够体现出来，若用一个`User`对象执行 UPDATE 操作，我们希望只对`User`对象中非空的属性，更新到数据库中，其他属性不做更新，则`NOT_NULL`可以满足需求。而若`updateStrategy`配置为`IGNORED`，则不会进行非空判断，会将实体对象中的全部属性如实组装到 SQL 中，这样，执行 UPDATE 时，可能就将一些不想更新的字段，设置为了`NULL`。
> 
>  *  `IGNORED`：忽略校验。即，不做校验。实体对象中的全部字段，无论值是什么，都如实地被组装到 SQL 语句中（为`NULL`的字段在 SQL 语句中就组装为`NULL`）。
>  *  `NOT_NULL`：`非NULL` 校验。只会将 `非NULL` 的字段组装到 SQL 语句中
>  *  `NOT_EMPTY`：非空校验。当有字段是字符串类型时，只组装非空字符串；对其他类型的字段，等同于`NOT_NULL`
>  *  `NEVER`：不加入 SQL。所有字段不加入到 SQL 语句

*  `tablePrefix`：添加表名前缀

比如

mybatis-plus:
      global-config:
        db-config:
          table-prefix: xx_

然后将 MYSQL 中的表做一下修改。但 Java 实体类保持不变（仍然为User）。  
![在这里插入图片描述][20210519160150524.png_pic_center]  
测试

@Test
    public void test3() { 
    	QueryWrapper<User> wrapper = new QueryWrapper<>();
    	wrapper.like("name", "黄");
    	Integer count = userMapper.selectCount(wrapper);
    	System.out.println(count);
    }

可以看到拼接出来的 SQL，在表名前面添加了前缀  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 29]

> 完整的配置可以参考 mp 的官网 ==> [传送门][Link 1]

## 十一、代码生成器 ##

mp 提供一个生成器，可快速生成 Entity 实体类，Mapper 接口，Service，Controller 等全套代码。

示例如下

public class GeneratorTest { 
    	@Test
    	public void generate() { 
    		AutoGenerator generator = new AutoGenerator();
    
    		GlobalConfig config = new GlobalConfig();
    		String projectPath = System.getProperty("user.dir");
    		
    		config.setOutputDir(projectPath + "/src/main/java");
    		config.setAuthor("yogurt");
    		
    		config.setOpen(false);
    
    		generator.setGlobalConfig(config);
    
    		DataSourceConfig dataSourceConfig = new DataSourceConfig();
    		dataSourceConfig.setUrl("jdbc:mysql://localhost:3306/yogurt?serverTimezone=Asia/Shanghai");
    		dataSourceConfig.setDriverName("com.mysql.cj.jdbc.Driver");
    		dataSourceConfig.setUsername("root");
    		dataSourceConfig.setPassword("root");
    		
    		generator.setDataSource(dataSourceConfig);
    		
    		PackageConfig packageConfig = new PackageConfig();
    		packageConfig.setParent("com.example.mp.generator");
    		
    		generator.setPackageInfo(packageConfig);
    
    		StrategyConfig strategyConfig = new StrategyConfig();
    		
    		strategyConfig.setNaming(NamingStrategy.underline_to_camel);
    		strategyConfig.setColumnNaming(NamingStrategy.underline_to_camel);
    		
    		strategyConfig.setEntityLombokModel(true);
    		
    		strategyConfig.setRestControllerStyle(true);
    		generator.setStrategy(strategyConfig);
    		generator.setTemplateEngine(new FreemarkerTemplateEngine());
    		
    		generator.execute();
    	}
    }

运行后，可以看到生成了如下图所示的全套代码  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70_pic_center]

## 十二、高级功能 ##

高级功能的演示需要用到一张新的表`user2`

DROP TABLE IF EXISTS user2;
    CREATE TABLE user2 (
    id BIGINT(20) PRIMARY KEY NOT NULL COMMENT '主键id',
    name VARCHAR(30) DEFAULT NULL COMMENT '姓名',
    age INT(11) DEFAULT NULL COMMENT '年龄',
    email VARCHAR(50) DEFAULT NULL COMMENT '邮箱',
    manager_id BIGINT(20) DEFAULT NULL COMMENT '直属上级id',
    create_time DATETIME DEFAULT NULL COMMENT '创建时间',
    update_time DATETIME DEFAULT NULL COMMENT '修改时间',
    version INT(11) DEFAULT '1' COMMENT '版本',
    deleted INT(1) DEFAULT '0' COMMENT '逻辑删除标识,0-未删除,1-已删除',
    CONSTRAINT manager_fk FOREIGN KEY(manager_id) REFERENCES user2(id)
    ) ENGINE = INNODB CHARSET=UTF8;
    
    INSERT INTO user2(id, name, age, email, manager_id, create_time)
    VALUES
    (1, '老板', 40 ,'boss@baomidou.com' ,NULL, '2021-03-28 13:12:40'),
    (2, '王狗蛋', 40 ,'gd@baomidou.com' ,1, '2021-03-28 13:12:40'),
    (3, '王鸡蛋', 40 ,'jd@baomidou.com' ,2, '2021-03-28 13:12:40'),
    (4, '王鸭蛋', 40 ,'yd@baomidou.com' ,2, '2021-03-28 13:12:40'),
    (5, '王猪蛋', 40 ,'zd@baomidou.com' ,2, '2021-03-28 13:12:40'),
    (6, '王软蛋', 40 ,'rd@baomidou.com' ,2, '2021-03-28 13:12:40'),
    (7, '王铁蛋', 40 ,'td@baomidou.com' ,2, '2021-03-28 13:12:40')

并创建对应的实体类User2

package com.example.mp.po;
    import lombok.Data;
    import java.time.LocalDateTime;
    @Data
    public class User2 { 
    	private Long id;
    	private String name;
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    	private LocalDateTime updateTime;
    	private Integer version;
    	private Integer deleted;
    }

以及 Mapper 接口

package com.example.mp.mappers;
    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import com.example.mp.po.User2;
    public interface User2Mapper extends BaseMapper<User2> {  }

## 十三、逻辑删除 ##

首先，为什么要有逻辑删除呢？直接删掉不行吗？当然可以，但日后若想要恢复，或者需要查看这些数据，就做不到了。**逻辑删除是为了方便数据恢复，和保护数据本身价值的一种方案。**

日常中，我们在电脑中删除一个文件后，也仅仅是把该文件放入了回收站，日后若有需要还能进行查看或恢复。当我们确定不再需要某个文件，可以将其从回收站中彻底删除。这也是类似的道理。

mp 提供的逻辑删除实现起来非常简单

只需要在 `application.yml` 中进行逻辑删除的相关配置即可

mybatis-plus:
      global-config:
        db-config:
          logic-delete-field: deleted  
          logic-delete-value: 1 
          logic-not-delete-value: 0

测试代码

package com.example.mp;
    import com.example.mp.mappers.User2Mapper;
    import com.example.mp.po.User2;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    import java.util.List;
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class LogicDeleteTest { 
    	@Autowired
    	private User2Mapper mapper;
    	@Test
    	public void testLogicDel() { 
    		int i = mapper.deleteById(6);
    		System.out.println("rowAffected = " + i);
    	}
    }

结果  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 30]  
可以看到，发出的 SQL 不再是`DELETE`，而是`UPDATE`

此时我们再执行一次`SELECT`

@Test
    public void testSelect() { 
    	List<User2> users = mapper.selectList(null);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 31]  
可以看到，发出的 SQL 语句，会自动在 WHERE 后面拼接逻辑未删除的条件。查询出来的结果中，没有了 id 为 6 的王软蛋。

若想要 SELECT 的列，不包括逻辑删除的那一列，则可以在实体类中通过 `@TableField` 进行配置

@TableField(select = false)
    private Integer deleted;

可以看到下图的执行结果中，SELECT 中已经不包含 deleted 这一列了  
![在这里插入图片描述][20210519161333721.png]  
前面在 `application.yml`中做的配置，是全局的。通常来说，对于多个表，我们也会统一逻辑删除字段的名称，统一逻辑已删除和未删除的值，所以全局配置即可。当然，若要对某些表进行单独配置，在实体类的对应字段上使用 `@TableLogic`即可

@TableLogic(value = "0", delval = "1")
    private Integer deleted;

**小结**

开启 mp 的逻辑删除后，会对 SQL 产生如下的影响

*  `INSERT` 语句：没有影响
 *  `SELECT` 语句：追加 WHERE 条件，过滤掉已删除的数据
 *  `UPDATE`语句：追加 WHERE 条件，防止更新到已删除的数据
 *  `DELETE` 语句：转变为 UPDATE 语句

**注意，上述的影响，只针对 mp 自动注入的 SQL 生效** 如果是自己手动添加的自定义 SQL，则不会生效。比如

public interface User2Mapper extends BaseMapper<User2> { 
    	@Select("select * from user2")
    	List<User2> selectRaw();
    }

调用这个`selectRaw`，则 mp 的逻辑删除不会生效。

另，逻辑删除可在 `application.yml` 中进行全局配置，也可在实体类中用 `@TableLogic` 进行局部配置。

## 十四、自动填充 ##

表中常常会有 “新增时间”，“修改时间”，“操作人” 等字段。比较原始的方式，是每次插入或更新时，手动进行设置。mp 可以通过配置，对某些字段进行自动填充，食用示例如下

1.  在实体类中的某些字段上，通过`@TableField`设置自动填充

public class User2 { 
    	private Long id;
    	private String name;
    	private Integer age;
    	private String email;
    	private Long managerId;
    	@TableField(fill = FieldFill.INSERT) 
    	private LocalDateTime createTime;
    	@TableField(fill = FieldFill.UPDATE) 
    	private LocalDateTime updateTime;
    	private Integer version;
    	private Integer deleted;
    }

1.  实现自动填充处理器

package com.example.mp.component;
    import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
    import org.apache.ibatis.reflection.MetaObject;
    import org.springframework.stereotype.Component;
    import java.time.LocalDateTime;
    
    @Component 
    public class MyMetaObjectHandler implements MetaObjectHandler { 
    	@Override
    	public void insertFill(MetaObject metaObject) { 
    		strictFillStrategy(metaObject, "createTime", LocalDateTime::now);
    	}
    	@Override
    	public void updateFill(MetaObject metaObject) { 
    		strictFillStrategy(metaObject, "updateTime", LocalDateTime::now);
    	}
    }

1.  测试

@Test
    public void test() { 
    	User2 user = new User2();
    	user.setId(8L);
    	user.setName("王一蛋");
    	user.setAge(29);
    	user.setEmail("yd@baomidou.com");
    	user.setManagerId(2L);
    	mapper.insert(user);
    }

根据下图结果，可以看到对 `createTime` 进行了自动填充  
![在这里插入图片描述][20210519162024121.png]  
注意，自动填充仅在该字段为空时会生效，若该字段不为空，则直接使用已有的值。如下

@Test
    public void test() { 
    	User2 user = new User2();
    	user.setId(8L);
    	user.setName("王一蛋");
    	user.setAge(29);
    	user.setEmail("yd@baomidou.com");
    	user.setManagerId(2L);
    	user.setCreateTime(LocalDateTime.of(2000,1,1,8,0,0));
    	mapper.insert(user);
    }

![在这里插入图片描述][20210519162117307.png]  
更新时的自动填充，测试如下

@Test
    public void test() { 
    	User2 user = new User2();
    	user.setId(8L);
    	user.setName("王一蛋");
    	user.setAge(99);
    	mapper.updateById(user);
    }

![在这里插入图片描述][20210519162157207.png]

## 十六、乐观锁插件 ##

当出现并发操作时，需要确保各个用户对数据的操作不产生冲突，此时需要一种并发控制手段。悲观锁的方法是，在对数据库的一条记录进行修改时，先直接加锁（数据库的锁机制），锁定这条数据，然后再进行操作；而乐观锁，正如其名，它先假设不存在冲突情况，而在实际进行数据操作时，再检查是否冲突。乐观锁的一种通常实现是 **版本号**，在 MySQL 中也有名为 MVCC 的基于版本号的并发事务控制。

在读多写少的场景下，乐观锁比较适用，能够减少加锁操作导致的性能开销，提高系统吞吐量。

在写多读少的场景下，悲观锁比较使用，否则会因为乐观锁不断失败重试，反而导致性能下降。

乐观锁的实现如下：

1.  取出记录时，获取当前 version
2.  更新时，带上这个 version
3.  执行更新时， set version = newVersion where version = oldVersion
4.  如果 oldVersion 与数据库中的 version 不一致，就更新失败

这种思想和 CAS（Compare And Swap）非常相似。

**乐观锁的实现步骤如下**

1、配置乐观锁插件

package com.example.mp.config;
    
    import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    
    @Configuration
    public class MybatisPlusConfig { 
    	@Bean
    	public MybatisPlusInterceptor mybatisPlusInterceptor() { 
    		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    		interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
    		return interceptor;
    	}
    }

2、在实体类中表示版本的字段上添加注解@Version

@Data
    public class User2 { 
    	private Long id;
    	private String name;
    	private Integer age;
    	private String email;
    	private Long managerId;
    	private LocalDateTime createTime;
    	private LocalDateTime updateTime;
    	@Version
    	private Integer version;
    	private Integer deleted;
    }

测试代码

@Test
    public void testOpLocker() { 
    	int version = 1; 
    	User2 user = new User2();
    	user.setId(8L);
    	user.setEmail("version@baomidou.com");
    	user.setVersion(version);
    	int i = mapper.updateById(user);
    }

执行之前先看一下数据库的情况  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 32]  
根据下图执行结果，可以看到 SQL 语句中添加了 version 相关的操作  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 33]  
当 UPDATE 返回了 1，表示影响行数为 1，则更新成功。反之，由于 WHERE 后面的 version 与数据库中的不一致，匹配不到任何记录，则影响行数为 0，表示更新失败。更新成功后，新的 version 会被封装回实体对象中。

实体类中 version 字段，类型只支持 `int`，`long`，`Date`，`Timestamp`，`LocalDateTime`

注意，乐观锁插件仅支持 `updateById(id)` 与 `update(entity, wrapper)` 方法

**注意：如果使用wrapper，则wrapper不能复用！**

示例如下

@Test
    public void testOpLocker() { 
    	User2 user = new User2();
    	user.setId(8L);
    	user.setVersion(1);
    	user.setAge(2);
    
    	LambdaQueryWrapper<User2> wrapper = new LambdaQueryWrapper<>();
    	wrapper.eq(User2::getName, "王一蛋");
    	mapper.update(user, wrapper);
    	
    	user.setAge(3);
    	mapper.update(user, wrapper);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 34]  
可以看到在第二次复用 `wrapper` 时，拼接出的 SQL 中，后面 WHERE 语句中出现了 2 次 version，是有问题的。

## 十七、性能分析插件 ##

该插件会输出 SQL 语句的执行时间，以便做 SQL 语句的性能分析和调优。

注：3.2.0 版本之后，mp 自带的性能分析插件被官方移除了，而推荐食用第三方性能分析插件

使用步骤

1.  引入 `maven` 依赖

1.  修改 `application.yml`

spring:
      datasource:
        driver-class-name: com.p6spy.engine.spy.P6SpyDriver 
        url: jdbc:p6spy:mysql://localhost:3306/yogurt?serverTimezone=Asia/Shanghai 
        username: root
        password: root

1.  在`src/main/resources`资源目录下添加`spy.properties`

modulelist=com.baomidou.mybatisplus.extension.p6spy.MybatisPlusLogFactory,com.p6spy.engine.outage.P6OutageFactory
    logMessageFormat=com.baomidou.mybatisplus.extension.p6spy.P6SpyLogger
    appender=com.baomidou.mybatisplus.extension.p6spy.StdoutLogger
    deregisterdrivers=true
    useprefix=true
    excludecategories=info,debug,result,commit,resultset
    dateformat=yyyy-MM-dd HH:mm:ss
    outagedetection=true
    outagedetectioninterval=2
    executionThreshold=10

随便运行一个测试用例，可以看到该 SQL 的执行时长被记录了下来  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 35]

## 十八、多租户 SQL 解析器 ##

多租户的概念：多个用户共用一套系统，但他们的数据有需要相对的独立，保持一定的隔离性。

多租户的数据隔离一般有如下的方式：

*  **不同租户使用不同的数据库服务器**
    
     *  优点是：不同租户有不同的独立数据库，有助于扩展，以及对不同租户提供更好的个性化，出现故障时恢复数据较为简单。
     *  缺点是：增加了数据库数量，购置成本，维护成本更高
 *  **不同租户使用相同的数据库服务器，但使用不同的数据库（不同的 schema）**
    
     *  优点是购置和维护成本低了一些，缺点是数据恢复较为困难，因为不同租户的数据都放在了一起
 *  **不同租户使用相同的数据库服务器，使用相同的数据库，共享数据表，在表中增加租户 id 来做区分**
    
     *  优点是，购置和维护成本最低，支持用户最多，缺点是隔离性最低，安全性最低

使用示例如下：

添加多租户拦截器配置。添加配置后，在执行 CRUD 的时候，会自动在 SQL 语句最后拼接租户 id 的条件

package com.example.mp.config;
    
    import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
    import com.baomidou.mybatisplus.extension.plugins.handler.TenantLineHandler;
    import com.baomidou.mybatisplus.extension.plugins.inner.TenantLineInnerInterceptor;
    import net.sf.jsqlparser.expression.Expression;
    import net.sf.jsqlparser.expression.LongValue;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    
    @Configuration
    public class MybatisPlusConfig { 
    	@Bean
    	public MybatisPlusInterceptor mybatisPlusInterceptor() { 
    		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    		interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() { 
    			@Override
    			public Expression getTenantId() {    
    				return new LongValue(1);
    			}     
    			@Override
    			public String getTenantIdColumn() { 
    				return "manager_id";
    			}
    			@Override
    			public boolean ignoreTable(String tableName) { 
    				return !"user2".equals(tableName);
    			}
    		}));
    		return interceptor;
    	}
    }

测试代码

@Test
    public void testTenant() { 
    	LambdaQueryWrapper<User2> wrapper = new LambdaQueryWrapper<>();
    	wrapper.likeRight(User2::getName, "王")
    			.select(User2::getName, User2::getAge, User2::getEmail, User2::getManagerId);
    	user2Mapper.selectList(wrapper);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 36]

## 十九、动态表名 SQL 解析器 ##

当数据量特别大的时候，我们通常会采用分库分表。这时，可能就会有多张表，其表结构相同，但表名不同。例如`order_1`，`order_2`，`order_3`，查询时，我们可能需要动态设置要查的表名。mp 提供了动态表名 SQL 解析器，食用示例如下

先在 mysql 中拷贝一下`user2`表  
![在这里插入图片描述][20210519174013753.png_pic_center]  
配置动态表名拦截器

package com.example.mp.config;
    
    import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
    import com.baomidou.mybatisplus.extension.plugins.handler.TableNameHandler;
    import com.baomidou.mybatisplus.extension.plugins.inner.DynamicTableNameInnerInterceptor;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import java.util.HashMap;
    import java.util.Random;
    
    @Configuration
    public class MybatisPlusConfig { 
    
    	@Bean
    	public MybatisPlusInterceptor mybatisPlusInterceptor() { 
    		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    		DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
    		HashMap<String, TableNameHandler> map = new HashMap<>();
            
    		map.put("user2", (sql, tableName) -> { 
    			String _ = "_";
    			int random = new Random().nextInt(2) + 1;
    			return tableName + _ + random; 
    		});
    		dynamicTableNameInnerInterceptor.setTableNameHandlerMap(map);
    		interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor);
    		return interceptor;
    	}
    
    }

测试

@Test
    public void testDynamicTable() { 
    	user2Mapper.selectList(null);
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 37]

## 二十、总结 ##

*  条件构造器 `AbstractWrapper` 中提供了多个方法用于构造 SQL 语句中的 `WHERE` 条件，而其子类 `QueryWrapper` 额外提供了 `select`方法，可以只选取特定的列，子类 `UpdateWrapper` 额外提供了set方法，用于设置 SQL 中的 SET 语句。除了普通的 `Wrapper` ，还有基于 `lambda` 表达式的`Wrapper`，如`LambdaQueryWrapper`，`LambdaUpdateWrapper`，它们在构造 WHERE 条件时，直接以 **方法引用** 来指定 WHERE 条件中的列，比普通 `Wrapper` 通过字符串来指定要更加优雅。另，还有链式 `Wrapper` ，如 `LambdaQueryChainWrapper` ，它封装了 `BaseMapper` ，可以更方便地获取结果。
 *  条件构造器采用 **链式调用** 来拼接多个条件，条件之间默认以AND连接
 *  当 `AND` 或 `OR` 后面的条件需要被括号包裹时，将括号中的条件以 lambda 表达式形式，作为参数传入 `and()` 或 `or()`
    
     *  特别的，当 `()` 需要放在 WHERE 语句的最开头时，可以使用`nested()`方法
 *  条件表达式时当需要传入自定义的 SQL 语句，或者需要调用数据库函数时，可用 `apply()` 方法进行 SQL 拼接
 *  条件构造器中的各个方法可以通过一个boolean类型的变量condition，来根据需要灵活拼接 WHERE 条件（仅当 `condition` 为 `true` 时会拼接 SQL 语句）
 *  使用 lambda 条件构造器，可以通过 lambda 表达式，直接使用实体类中的属性进行条件构造，比普通的条件构造器更加优雅
 *  若 mp 提供的方法不够用，可以通过 **自定义 SQL** （原生 mybatis）的形式进行扩展开发
 *  使用 mp 进行分页查询时，需要创建一个分页拦截器（Interceptor），注册到 Spring 容器中，随后查询时，通过传入一个分页对象（Page 对象）进行查询即可。单表查询时，可以使用 `BaseMapper` 提供的 `selectPage` 或 `selectMapsPage` 方法。复杂场景下（如多表联查），使用自定义 SQL。
 *  AR 模式可以直接通过操作实体类来操作数据库。让实体类继承自 `Model` 即可

[baomidou.com]: https://baomidou.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70]: /images/20221020/dfed4a96387f4848af6758bb45a8165a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 1]: /images/20221020/b11ff55af7e0467683fefe5aed089b7d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 2]: /images/20221020/ab982dbcabf94034843f66b59c03e273.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 3]: /images/20221020/507d297ba5d1490fb439d47bef5a43ff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 4]: /images/20221020/2c544f35c05b4050b5582f15d9cdd471.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 5]: /images/20221020/bdc9f63e39544efbb92cc545bd768d4a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 6]: /images/20221020/0916fb9bb03040079410ebd7e226a6e1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 7]: /images/20221020/f1ed1770d6634b3fbf88c77e31099295.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 8]: /images/20221020/2df73c38897e4b738d7d32e1d62309f0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 9]: /images/20221020/3f97805f974f4859a5c6d5b7a4fbe97c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 10]: /images/20221020/bd6213b3835046459c09b405626f1c12.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 11]: /images/20221020/b29244a87e4e437fb4cda09351c3cfa1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 12]: /images/20221020/3742d91ec51e48a2ba19f7ba84d17dea.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 13]: /images/20221020/2539eb1bebf5492ab7c432c3a22381c1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 14]: /images/20221020/8de04e9cc061409bb28f2e1321c17431.png
[20210519151246580.png]: /images/20221020/cc1f9c79575d48f3b0a45e5026ca013e.png
[20210519151517374.png]: /images/20221020/5cab5fe9fed84166aa712a0a9f4176a0.png
[20210519151540752.png]: /images/20221020/768622756a9d41c29f7f7fadfe04c14f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 15]: /images/20221020/5a6a285e36c84c4181ac795a649b9b13.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 16]: /images/20221020/cca5007b063a4628a145aa7bce848b53.png
[20210519151908930.png]: /images/20221020/d479011df2ac4f03851cff0e730b3a46.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 17]: /images/20221020/11029b5e4328413b8427068d70a12093.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 18]: /images/20221020/78993645721d422b9c461c61c81343e4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 19]: /images/20221020/bffb0925b7294190869287e5c4da9d06.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 20]: /images/20221020/0a652e7944b84f839487c88e59345bf8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 21]: /images/20221020/bdf17ef45ca0457ca1dfc082571d92cb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 22]: /images/20221020/a2b002a681014d569becabb0f1503ce1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 23]: /images/20221020/5c076b7a09c2429880577a1b2137ec74.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 24]: /images/20221020/aa45c86963e8421ca097f576e7518b26.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 25]: /images/20221020/6aa90676243f48369caa0818fc59c9d4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 26]: /images/20221020/e88e6298f13f4493953a1bc24550df36.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 27]: /images/20221020/cf4ac73924f04fb7aa6c49aabb651482.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 28]: /images/20221020/5b4ce69c473c451c8ad579137cf0e4c9.png
[20210519160150524.png_pic_center]: /images/20221020/7f9413b10e964558944d3f5366a5b7d5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 29]: /images/20221020/5dbf808dbf74405889a95b579a644441.png
[Link 1]: https://baomidou.com/guide/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70_pic_center]: /images/20221020/31b120d567d54666baec7eb8b7d0eeeb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 30]: /images/20221020/e85e8de3a672419b8f0def12b271e84d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 31]: /images/20221020/813e6929f4e74914865f7880610c11af.png
[20210519161333721.png]: /images/20221020/a6686d9a3b364518a020414a007c6c9b.png
[20210519162024121.png]: /images/20221020/9609ab8abe3749239ac768d6abcde475.png
[20210519162117307.png]: /images/20221020/a97f47f24fac4efebf532b5e310c88af.png
[20210519162157207.png]: /images/20221020/7accaa6c1a3b4ed3976303d74f714db9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 32]: /images/20221020/80081c5309ac4c6caa693c2925ec6e1d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 33]: /images/20221020/77c0aca6faa14ca196a876ef54d6413d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 34]: /images/20221020/2fb8a45a51e444ae95735862287dce89.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 35]: /images/20221020/bf97f1443c0b4f33a6f8c31e9846d260.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 36]: /images/20221020/92368a99f076463abff76a015a907b08.png
[20210519174013753.png_pic_center]: /images/20221020/b300d2c1c3b24227b225b3a6001fbb72.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTgwODgxNDAyNQ_size_16_color_FFFFFF_t_70 37]: /images/20221020/a966ce1cacdf4c1e81864e5af2f9c4fc.png