MyBatis-Plus简介

什么是MyBatis-Plus？

MyBatis-Plus（以下简称MP），为简化开发而生。

MP是一个MyBatis的增强工具，在MyBatis的基础上只做增强不做改变。

MP的特性

• 无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
• 损耗小：启动即会自动注入基本 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 操作智能分析阻断，也可自定义拦截规则，预防误操作

支持数据库

• mysql 、 mariadb 、 oracle 、 db2 、 h2 、 hsql 、 sqlite 、 postgresql 、 sqlserver
• 达梦数据库 、虚谷数据库 、人大金仓数据库

快速体验

1、建立数据库mybatis-plus，导入数据。

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)
);
?
DELETE FROM user;
?
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');

2、创建SpringBoot项目，导入对应的依赖。

<!--导入mp的依赖-->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.0.5</version>
</dependency>
?
<!--
    Spring2.x默认配置mysql8的驱动
    <mysql.version>8.0.19></mysql.version>
    8.0以上的驱动需要配置时区
-->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

3、编写项目。

• 配置数据库连接。

# DataSource Config
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mybatis-plus?useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8
    username: root
    password: 123456

• 编写实体类（这里使用了lombok插件）。

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

• 编写mapper接口继承BaseMapper即可。至此所有基本的CRUD都已经完成了。

//使用了MP之后，我们就不用编写CRUD了，只需要继承一个接口即可
//BaseMapper<T>,泛型T就是表示你要操作的类
@Repository
public interface UserMapper extends BaseMapper<User> {
?
    //这里几乎内置了所有的查询，除了十分特殊的查询之外
    //MP，对于复杂的SQL依旧要自己编写
}

4、在测试类中测试使用即可。

@SpringBootTest
class SpringbootMpApplicationTests {
    @Autowired
    private UserMapper userMapper;
    
    @Test
    void testMP(){
        //参数Wrapper是一个复杂的条件构造器
        //查询所有的用户
        List<User> users = userMapper.selectList(null);
        users.forEach(System.out::println);
        //70%以上的业务都可以在这里自动实现，抛开了底层dao层
        //这个时候你就可以专心的写Controller了
    }
}

BaseMapper

所有的CRUD操作，BaseMapper都已经帮我们封装好了，我们拿来即用就可以了。

BaseMapper中的所有接口方法如下：

    int insert(T var1);
?
    int deleteById(Serializable var1);
?
    int deleteByMap(@Param("cm") Map<String, Object> var1);
?
    int delete(@Param("ew") Wrapper<T> var1);
?
    int deleteBatchIds(@Param("coll") Collection<? extends Serializable> var1);
?
    int updateById(@Param("et") T var1);
?
    int update(@Param("et") T var1, @Param("ew") Wrapper<T> var2);
?
    T selectById(Serializable var1);
?
    List<T> selectBatchIds(@Param("coll") Collection<? extends Serializable> var1);
?
    List<T> selectByMap(@Param("cm") Map<String, Object> var1);
?
    T selectOne(@Param("ew") Wrapper<T> var1);
?
    Integer selectCount(@Param("ew") Wrapper<T> var1);
?
    List<T> selectList(@Param("ew") Wrapper<T> var1);
?
    List<Map<String, Object>> selectMaps(@Param("ew") Wrapper<T> var1);
?
    List<Object> selectObjs(@Param("ew") Wrapper<T> var1);
?
    IPage<T> selectPage(IPage<T> var1, @Param("ew") Wrapper<T> var2);
?
    IPage<Map<String, Object>> selectMapsPage(IPage<T> var1, @Param("ew") Wrapper<T> 

T就是我们要操作的数据对象。

另外我们还需要在配置文件中开启日志功能。

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

插入策略

往数据库中插入一条记录只需要直接调用mapper对象的insert方法进行插入即可。

@Test
void testInsert(){
    User user=new User();
    user.setName("coding");
    user.setAge(18);
    user.setEmail("24736743@qq.com");
    //插入对象
    int insert=userMapper.insert(user);
    //id自动回填了，这个对象直接使用
    //这个id是什么  1251036873686134785(雪花算法)
    System.out.println(user);
}

默认情况下，id会自动回填，查看控制台会发现系统自动帮我们生成了一串随机数字作为id填入SQL参数中。

主键生成策略

MP中主键默认生成策略是雪花算法（snowflake）。

snowflake是Twitter开源的分布式ID生成算法，结果是一个long型的ID。其核心思想是：使用41bit作为毫秒数，10bit作为机器的ID（5个bit是数据中心，5个bit的机器ID），12bit作为毫秒内的流水号（意味着每个节点在每毫秒可以产生4096个ID），最后还有一个符号位，永远是0。

关于id生成策略的更多内容，可以参考这篇博客：https://www.cnblogs.com/haoxinyue/p/5208136.html

在MP中，主要有以下几种主键生成策略，我们可以结合IdType这个枚举类的代码来分析：

• 自增（需保证数据库中的主键字段是自增的）
• 手动输入
• uuid
• 雪花算法 ......

public enum IdType {
    AUTO(0),// 自增
    NONE(1),//不使用策略
    INPUT(2),// 手动输入
    ID_WORKER(3),//唯一id生成器（默认）
    UUID(4),//uuid
    ID_WORKER_STR(5);//唯一id生成器（字符串类型）
}

更新策略

MP在更新对象时会自动帮我们匹配动态SQL。测试更新user表中的一条记录。

 @Test
void testUpdate(){
    //MP在更新对象时自动帮我们匹配动态sql
    User user=new User();
    user.setId(1L);
    user.setAge(100);
    //更新一个用户
    //updateById这里面传递的是一个user对象
    userMapper.updateById(user);
}

自动填充策略（扩展）

在阿里巴巴代码规范中，id、gmt_create、gmt_update是每张表中必备的三个字段。

因此，我们给user表增加两个字段：create_time和update_time，分别表示创建时间和修改时间，然后进行测试。这时我们发现这两个字段默认值被填充为NULL了。

自动更新策略分为两种级别：数据库级别和代码级别。

数据库级别（不建议使用）

1、设置create_time和update_time字段的默认值为CURRENT_TIMESTAMP即可。

2、进行记录更新测试，可以看到这条记录更新后create_time和update_time的值被设置为记录更新的时间。

datetime字段设置默认值会极大的降低数据库的执行效率，因此不建议使用这种自动更新策略。

代码级别（建议使用）

1、删除create_time和update_time字段的默认值。

2、编写代码。

• 编写实体类对应的注解。

//时间的操作（自动更新）
@TableField(fill = FieldFill.INSERT) //插入时更新
private Date createTime; 
@TableField(fill = FieldFill.INSERT_UPDATE) //插入或更新时更新
private Date updateTime;

• 编写元对象处理器。

//自定义元对象处理器
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    //插入的策略
    @Override
    public void insertFill(MetaObject metaObject) {
        //设置当前字段的值
        //以后只要是插入操作就会自动控制createTime、updateTime使用new Date()进行自动填充
        this.setFieldValByName("createTime",new Date(),metaObject);
        this.setFieldValByName("updateTime",new Date(),metaObject);
    }
?
    //更新策略
    @Override
    public void updateFill(MetaObject metaObject) {
        this.setFieldValByName("updateTime",new Date(),metaObject);
    }
}