MyBatis-Plus快速入门-(干货满满+超详细)

一、MyBatis VS JPA

JPA：
java持久层API，可以理解为一种规范，Hibernate就是其具体一个实现。（目前比较常用的是SpringDataJpa，它是Spring提供的一套简化开发的框架，按照约定好的方法命名规则，编写dao层接口，就可以在不编写实现情况下执行数据库操作，还提供了除CRUD以外的功能，例如分页、排序、复杂查询等等，SpringDataJpa可以理解为对JPA的再次封装，底层仍旧是Hibernate）

Mybatis优势：
1、SQL语句可以自由控制，更灵活、性能较高。
2、SQL与代码分离，易于阅读和维护。
3、提供XML标签，支持编写动态SQL语句。

JPA优势：
JPA移植性比较好（Hibernate方言）
提供了很多CRUD方法、开发效率高（不用编写sql语句）
对象化程度更高（面向对象开发思想）

Mybatis劣势：
简单CRUD操作需要编写SQL语句（单表仍需要编写Mapper接口方法和xml的sql）
XML中有大量sql需维护
mybatis自身功能有限

二、MyBatis-Plus简介

Mybatis-plus简介：Mybatis增强工具，只做增强，不作改变，简化开发，提高效率。

MP在mybatis启动的时候，它在mybatis的xml和注解注入之后，紧接着反射分析实体，然后注入到底层容器中。就是注入crud之类的。注入之前MP会进行判断，是否已经注入同样的方法，如果已经注入，就不在注入。它的注入时机在容器启动时，所以MP使用crud、本身是无性能损耗的。

官网地址：https://mybatis.plus/

1、Crab：Mybatisplus3.0教学版。（MP核心程序员作品）

2、Crab：WEB极速开发框架。（MP项目负责人作品）

github项目地址：https://github.com/baomidou/mybatis-plus

码云项目地址：https://gitee.com/baomidou/mybatis-plus

Mybatis-plus特点：

1、无侵入：Mybatis-Plus 在 Mybatis 的基础上进行扩展，只做增强不做改变，引入 Mybatis-Plus 不会对您现有的 Mybatis 构架产生任何影响，而且 MP 支持所有 Mybatis 原生的特性

2、依赖少：仅仅依赖 Mybatis 以及 Mybatis-Spring

3、损耗小：启动即会自动注入基本CRUD，性能基本无损耗，直接面向对象操作

4、通用CRUD操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求

5、多种主键策略：支持多达4种主键策略（内含分布式唯一ID生成器），可自由配置，完美解决主键问题

6、支持ActiveRecord：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可实现基本 CRUD 操作

7、支持代码生成：采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码，支持模板引擎，更有超多自定义配置等您来使用（P.S. 比 Mybatis 官方的 Generator 更加强大！）
支持自定义全局通用操作：支持全局通用方法注入( Write once, use anywhere )

8、内置分页插件：基于Mybatis物理分页，开发者无需关心具体操作，配置好插件之后，写分页等同于写基本List查询

9、内置性能分析插件：可输出Sql语句以及其执行时间，建议开发测试时启用该功能，能有效解决慢查询

10、内置全局拦截插件：提供全表 delete 、 update 操作智能分析阻断，预防误操作

三、MyBatis-Plus快速入门

1、lombok简介及安装

lombok作用：提高开发效率，通过注解形式使javabean生成get、set、有参数、无参数、toString等方法，无需手动实现。

倘若不使用lombok可以使用的注解有：
注解介绍：
下面只是介绍了几个常用的注解，更多的请参见： https://projectlombok.org/features/index.html

@Getter / @Setter

可以作用在类上和属性上，放在类上，会对所有的非静态(non-static)属性生成Getter/Setter方法，放在属性上，会对该属性生成Getter/Setter方法。并可以指定Getter/Setter方法的访问级别。

@EqualsAndHashCode

默认情况下，会使用所有非瞬态(non-transient)和非静态(non-static)字段来生成equals和hascode方法，也可以指定具体使用哪些属性。

@ToString

生成toString方法，默认情况下，会输出类名、所有属性，属性会按照顺序输出，以逗号分割。

@NoArgsConstructor, @RequiredArgsConstructor and @AllArgsConstructor

无参构造器、部分参数构造器、全参构造器，当我们需要重载多个构造器的时候，Lombok就无能为力了。

@Data

@ToString, @EqualsAndHashCode, 所有属性的@Getter, 所有non-final属性的@Setter和@RequiredArgsConstructor的组合，通常情况下，我们使用这个注解就足够了。

IDEA安装lombok插件：


然后在maven的pom.xml引入依赖:

  <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.16.10</version>
  </dependency>

2、入门小案例

步骤：
建库建表===>引入依赖===>配置===>编码===>测试

建一个mp名的数据库，在建一个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 (1087982257332887553, '猪头', 20, 'boss@baomidou.com', NULL, 
'2019-01-11 14:20:20'),            
(1088248166370832385,'小懒猪',20,'wtf@baomidou.com', 1087982257332887553,
'2019-02-05 11:12:22'),            
(1088250446457389058,'小白',18,'lyw@baomidou.com', 1088248166370832385,
'2019-02-14 08:31:16'),            
(1094590409767661570,'小黑',21,'zyq@baomidou.com', 1088248166370832385,
'2019-01-14 09:15:15'),            
(1094592041087729666,'小可耐',22,'lhm@baomidou.com', 1088248166370832385,
'2019-01-14 09:48:16');

然后建一个Spring Initializr工程：

pom.xml依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.1.4</version>
    </dependency>

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

    <!-- Mybatis-Plus启动器 -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.1.0</version>
    </dependency>

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

创一个application.yaml,进行配置:

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mp?useSSL=false&serverTimezone=GMT%2B8
    username: root
    password: 1214

编写实体类：
entity/User.java:

@Data
@EqualsAndHashCode(callSuper = false)
@TableName("user")
public class User {

    /**
     * 主键
     */
    private Long id;

    /**
     * 姓名
     */
    @TableField(value = "name", condition = SqlCondition.LIKE)
    private String name;

    /**
     * 年龄
     */
    @TableField(condition = "%s<#{%s}")
    private Integer age;

    /**
     * 邮箱
     */
    private String email;

    /**
     * 直属上级id
     */
    private Long managerId;

    /**
     * 创建时间
     */
    private Date createTime;

    /*
     * 备注（不与数据库字段对应） # transient 不参与序列化
     */
    @TableField(exist = false)
    private String remark;

}

编写dao接口：
UserMapper.java：

public interface UserMapper extends BaseMapper<User> {
}

在启动类中添加注解：@MapperScan(“com.mp.first_mp.dao”)，进行扫描

最后就是编写测试类：

@RunWith(SpringRunner.class)
@SpringBootTest
public class SimpleTest {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void select() {
        List<User> list = userMapper.selectList(null);
        Assert.assertEquals(5, list.size());
        list.forEach(System.out::println);
    }
}

查看效果：

运行是成功的，我们可以发现相对于使用MyBatis来说，MyBatis-plus不用编写xml文件编写那些繁琐的SQL语句，简单快速的MyBatis-plus的就到这里，若还有兴趣就继续看下去吧ヾ(◍°∇°◍)ﾉﾞ

四、基本使用

1、通用传统模式简介及通用mapper新增方法

相信对SSM比较熟系的小伙伴应该对SSM传统编程模式都比较熟系：

接口中写抽象方法===>XML或注解写SQL===>Service中调用接口===>Controller中调用

为了方便大家观察，在application.yaml多增加应该日志的输出：

logging:
  level:
    root: warn
    com.mp.first_mp.dao: trace
  pattern:
    console: '%p%m%n'

进行测试：

@Test
    public void insertTest() {
        User user = new User();
        user.setName("小灰");
        user.setAge(20);
        user.setEmail("1980757771@qq.com");
        user.setManagerId(1088248166370832385L);
        user.setCreateTime(new Date());
        int rows = userMapper.insert(user);
        System.out.println("影响记录数：" + rows);
    }

运行结果：

倘若大家观察得仔细可以发现主键id并没有设定自增，那为什么没有出现报错呢？？？

原来MP的默认主键策略是基于雪花算法的自增主键，在MP的源码中有雪花算法的实现代码。

额~~~可能有小伙伴不知道什么是雪花算法，大家可以看看这位博主写的文章：雪花算法的原理和实现Java

2、常用注解

mybatis-plus：

主键采用雪花算法生成值的前提是实体类的主键属性名称必须为id。

mybatis-plus：

数据表字段带有_的可以自动映射到驼峰式命名的属性上（t_user——》tUser）。

注解：

1.数据库名不同，在类上增加@TableName(“mp_user”)
2.主键ID的驼峰一般无法识别，在主键属性上增加@TableId
3.属性与字段名不相同,在属性上增加@TableField(“name”)

@TableName（“数据库表名”）：

使用场景实体类名称和数据表名不一致时，通过它指定表名，此时就可以使用mp的单表操作。

@TableId（“主键名”）：

使用场景实体类属性名称和数据表主键不是id时，通过它声明该属性为主键，就可以采用雪花算法生成主键值操作。

@TableField（“字段名”）：

使用场景实体类属性名称和数据表字段名不一致时，通过它指定数据表字段名称，就可以和实体类属性对应。

3、排除非表字段的三种方式

使用场景： 实体类中的某个属性不对应表中的任何字段，只是用于保存临时数据，或者临时组装的数据。

使用方式

1、 transient修饰实体类属性（修饰的属性不会被序列化）。

缺陷：有些需求需要序列化该字段。

2、 static修饰属性（前提手动实现get、set方法，Lombok对静态属性不会提供get、set方法）。

缺陷：每个对象的属性值一致。

3、 @TableField(exist=false)，这个注解用来表示数据表中不存在该字段，默认是true。

五、MyBatis-Plus查询方法

1、普通查询

普通查询：使用方式为实现BaseMapper接口对象调用该方法。

1、T selectById(Serializable id)：使用场景为通过主键查询，只要该主键类型实现了Serialzable接口即可。

@Test
public void selectById() {
    User user = userMapper.selectById(6);
    System.out.println(user);
}

2、List selectBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList)：使用场景为通过主键的集合去批量查询，前提主键的类型实现了Serializable接口。

@Test
public void selectBatchById() {
    List<Long> userListId = Arrays.asList(1L, 2L, 3L);
    List<User> userList = userMapper.selectBatchIds(userListId);
    userList.forEach(System.out::println);
}

3、List selectByMap(@Param(Constants.COLUMN_MAP) Map<String,Object> columnMap)：使用场景为传入一个Map集合，key为表字段，value为表字段值。

注意：Map的key为数据表的字段名，不是实体类属性名。

@Test
public void selectByMap() {
    Map<String, Object> userMap = new HashMap<>();
    userMap.put("age", 20);
    List<User> userList = userMapper.selectByMap(userMap);
    userList.forEach(System.out::println);
}

2、条件构造器查询

BaseMapper以条件构造器（Wrapper）为参数的查询方法

AbstractWrapper抽象类：提供了很多条件构造器。

List selectList(@Param(Constans.WRAPPER) Wrapper queryWrapper)：
使用场景：对于一些有特殊条件的查询，比如模糊查询、条件查询等。
使用方法：QueryWrapper为查询条件构造器，它是AbstractWrapper的一个子类。
生成条件构造器
方式一：QueryWrapper queryWrapper=new QueryWrapper();
方式二：QueryWrapper query=Wrappers.query();

注意： 条件构造器AbstractWrapper的条件构造器方法key都为数据表字段，value为实际值。例如：like（Column，value）、gt（Column，value）等。

模糊条件构造器：like，小于条件构造器：lt。

范围条件构造器：between，非空条件构造器：isNotNull。

模糊右通配符条件构造器：likeRight，或条件构造器：or。
大于等于条件构造器：ge，升序条件构造器：orderAsc。
降序条件构造器：orderDesc。

Mysql函数
date_format(日期，‘格式’)：将日期按照格式进行插入或者返回。
例如： date_format(now(),’%Y-%m-%d’)。

动态条件构造器：apply，范围条件构造器：insql。
注意： 如果{0}替换为实际值，可能会造成sql注入。

and括号条件构造器：and（）

注意： 怕有些小伙伴不了解这个是什么：wq -> wq.xxx这种类型的表达式，这个是java8引入的lambda表达式的语法，箭头左边是变量名，箭头右边是自己编写的代码逻辑，如果感兴趣你可以了解一下java的lambda表达式，当然打印方式也是lambda表达式

or括号条件构造器：or()

非and开头的条件构造器：nested（）

In条件构造器：In（column,Collection)

last条件构造器：last(sql）。注意：有sql注入风险。确保参数没有风险再使用。

3、select不列出全部字段

select不列出全部字段

select（String …columns)

如果返回的字段数量很多，此时采用如下的select，也可以放置在后面

select（Class entityClass,Predicate predicate)

第一个参数为实体类对象;
第二个参数相当于排除返回的字段.

4、condition作用

如果使用的是IDEA需要添加依赖pom.xml:

<dependency>
        <groupId>commons-lang</groupId>
        <artifactId>commons-lang</artifactId>
        <version>2.6</version>
    </dependency>

条件构造器（abstractWrapper）中 condition（构造的方法的boolean类型参数） 作用。

如下：like方法调用重载的方法，重载方法中第一个参数。

作用：该条件是否加入最后生成的sql中。
使用方法：如果为true就加入，如果false就不加入。
使用场景：类似于动态的sql拼接。

传统使用：

mp方式：

5、实体作为条件构造器构造方法的参数

创建条件构造器时传入实体对象

private SharedString sqlSelect = new SharedString();

public QueryWrapper() {
    this(null);
}

public QueryWrapper(T entity) {
    super.setEntity(entity);
    super.initNeed();
}

QueryWrapper一个参数的构造方法，如果传入一个部不为null的对象，默认会进行进行等值比较，也就是where后拼接条件。

注意：通过entity参数生成的等值和QueryWrapper的条件构造方法生成的没有任何关系。

举例验证：


注意：使用时要慎重，因为他们都会在sql中进行拼接。

使用场景：如果允许使用实体类去接受参数，那么就可以不用调用条件构造器，而是直接使用构造方法传入参数即可。

特殊操作：可以通过在实体类上添加注解，指定该属性使用那种操作，默认使用等值。

SqlCondition类：定义了一些常量，包括等值、不等于、like、左边like、右边like。

如果提供的常量无法满足需求，就可以自己在注解中编写常量表达式，例如小于。

6、AllEq用法

Alleq（Map<R,V> params）

使用方法：传入一个map集合对象，就会按照等值进行操作。key为字段名称，value为字段值。如果字段的值为null，那么sql就会拼接为is null这种形式。

如果传入的null，想要忽略掉，也就是不进行拼接，那么就传入第二个参数为false。

allEq的第二种方法，参数1为过滤函数，它是一个函数式接口。

上图就是判断name是不等于name，如果不等于就返回true，就会过滤掉，所以没有拼接name。也可以判断值。注意需要考虑类型的问题

7、其他使用条件构造器的方法

其他以条件构造器的方法

1、selectMap：List集合的泛型不再是实体，而是map集合。其中key表示字段名，value表示字段值。

使用场景1：当实体类属性非常多时，不易查看。如果返回的是一个实体类，那么即使我们设定了返回字段，那么它的值为null，但是属性仍然存在。如果返回的是Map类型，当指定了返回字段时，那么没返回的就不会存在。

使用场景2：当返回的不是一条一条记录时，也就是返回的字段不在实体类属性中，比如一些统计，像平均值，最大值，最小值这样的。

2、selectObject：List集合的泛型不再是实体，而是Object，只返回第一个字段的值。其他的会被舍弃。



使用场景：只返回一列时可以使用它。

3、selectCount：查询符合条件的总记录数的。

注意：使用它时，就不能指定返回的列了，因为它会在后面拼接COUNT(1)。

4、selectOne：查询符合条件的数据，只会返回一条数据。

注意： 查询的结果必须是一条或者查不到（多于1条就会报错）。

8、lambda条件构造器

lambda条件构造器（类似mp条件构造器，防误写）

lambda条件构造器使用场景：

不需要我们手动在构造条件时去书写字段名称。

lambda条件构造器使用方法：

lambda条件构造器的创建有3种方式

1、通过查询构造器QueryWrapper创建

2、通过new直接创建lambda条件构造器

3、通过构造器工具类Wrappers创建（此时需要泛型）

4、3.0.7新增的创建lambda条件构造器，通过LambdaQueryChainWrapper，并且需要一个Mapper接口作为参数（通过源码可以，它是对普通查询构造器的再次封装，源码中仍然是通过Mapper接口去调用）。

六、自定义SQL及分页查询

1、使用条件构造器的自定义sql

使用场景：当使用条件构造器去构造sql的方法不能满足需求时（前提：mybatisplus版本大于3.0.7）。

使用方法：

注意:${ew.customSqlsegment}可以使条件构造器构造的sql被执行。


mybatis-plus配置xml文件路径（springboot项目）：

不过由于IDEA系列编辑器，XML文件是不能放在 java 文件夹中的，IDEA默认不会编译源码文件夹中的 XML文件，所以可以通过在pom.xml中加入：

<build>
	<resources>
       <resource>
       <directory>src/main/java</directory>
          <includes>
              <include>**/*.xml</include>
          </includes>
       </resource>
    </resources>
</build>

即可在xml中进行编写SQL语句。

2、分页查询

分页查询

1、mybatis分页查询（mybatis的rowBounds实现的分页不是物理分页，可以理解为逻辑或者内存分页）

拓展：内存分页弊端，数据量大时占用过多内存，第一次查询速度慢。

2、mybatis-plus插件实现物理分页

a、配置mybatis-plus插件

BaseMapper提供了两个分页方法：

这两个方法主要区别如下图，返回的数据是实体类型，还是map类型。
IPage.java:

b、分页使用


分页map形式

使用分页时，不查询总记录数：第三个参数为true表示查询总记录数，否则就不查询。
Page.class:

当分页查询查询的是多表时使用分页：



倘若需要多表联查，可以在xml文件里编写多表联查的SQL，一样可以实现其功能ヾ(◍°∇°◍)ﾉﾞ
如：


在xml里编写需要的多表查询语句即可。

七、更新与删除

1、mybatis-plus更新

1、根据id更新

使用场景：根据实体类主键属性进行更新，其他属性有值就更新。

使用方法：如下


2、以条件构造器作为参数进行更新

使用场景：更新条件为其他时。

使用方法：如下


条件构造器传入实体时的使用（和QueryWrapper类似），它会将实体属性作为更新的条件。

3、条件构造器中set方法使用

如果更新少量字段可使用如下方式：

lambda方式更新：

通过构造器链进行直接更新：

2、mybatis-plus删除方法

1、根据id删除方法——deleteById(前提：实体类主键属性上有@TableId注解)

2、普通删除方法

3、以条件构造器为参数删除方法

八、AR模式、主键策略和基本配置

1、ActiveRecord模式

简介：活动记录，领域模型模式，直接通过实体操作数据库（java的一个实体类对应数据库的一张表，而一个实例对应表中一行记录）

MP中AR模式的实现（两个前提：实体类需要继承Model；mapper接口实现BaseMapper）


直接用实体即可操作数据库：

insertOrUpdate():
如果实体的主键不是null，那么就会先查询，如果有记录就更新，没有就插入。是null直接进行插入。

注意：如下图方法删除不存在的也返回true.


至于其他方法的使用介绍，可以查看Model.java源码٩(๑❛ᴗ❛๑)۶

2、主键策略

mp的主键策略定义在了IdTyoe的枚举类中：（下面是源码）

局部策略：
在主键字段配置@TableId(type=IdType.AUTO)

全局策略：
在application.yaml配置中添加：

注意： 局部策略优于全局策略

3、基本配置

可在查看官网地址：https://mybatis.plus/

九、通用的Service

详情可查看IService.java的源码。
下面是部分方法的使用：

1、基本方法

因为数据数大于1，所以默认返回第一条

2、批量操作操作

不指定

指定

3、链式调用方法

查询：


更新：


删除：

关于MyBatis-Plus的详细快速入门的学习就到这里，Thanks♪(･ω･)ﾉ