一、MyBatis-Plus简介

1、简介

2、特性

二、入门案例

1、创建数据库及表

a>创建表

b>添加数据

2、创建Spring Boot工程

a>初始化工程

b>引入依赖

3、编写代码

a>配置application.yml

b>启动类

c>添加实体

d>添加mapper

e>测试

f>添加日志

三、基本CRUD

1、BaseMapper

2、插入

3、删除

a>通过id删除记录

b>通过id批量删除记录

c>通过map条件删除记录

4、修改

5、查询

a>根据id查询用户信息

b>根据多个id查询多个用户信息

c>通过map条件查询用户信息

d>查询所有数据

6、通用Service

a>IService

b>创建Service接口和实现类

c>测试查询记录数

d>测试批量插入

四、常用注解

1、@TableName

a>问题

b>通过@TableName解决问题

c>通过全局配置解决问题

2、@TableId

a>问题

b>通过@TableId解决问题

c>@TableId的value属性

d>@TableId的type属性

3、@TableField

a>情况1

b>情况2

自动填充字段创建时间和修改时间

4、@TableLogic

a>逻辑删除

b>实现逻辑删除

五、条件构造器和常用接口

1、wapper介绍

2、QueryWrapper

a>例1：组装查询条件

b>例2：组装排序条件

c>例3：组装删除条件

d>例4：条件的优先级

e>例5：组装select子句

f>例6：实现子查询

3、UpdateWrapper

4、condition

思路一：

思路二：

5、LambdaQueryWrapper

6、LambdaUpdateWrapper

六、插件

1、分页插件

a>添加配置类

b>测试

2、乐观锁

a>模拟修改冲突

b>乐观锁实现流程

c>Mybatis-Plus实现乐观锁

七、通用枚举

a>数据库表添加字段sex

b>创建通用枚举类型

c>配置扫描通用枚举

d>测试

八、代码生成器

1、引入依赖

2、快速生成

九、多数据源

1、创建数据库及表

2、引入依赖

3、配置多数据源

4、创建用户service

5、创建商品service

6、测试

一、MyBatis-Plus简介

1、简介
MyBatis-Plus（简称 MP）是一个 MyBatis的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

愿景
我们的愿景是成为 MyBatis 最好的搭档，就像魂斗罗中的 1P、2P，基友搭配，效率翻倍。

2、特性
无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
损耗小：启动即会自动注入基本 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、创建数据库及表

a>创建表

CREATE TABLE `user`  (
  `id` bigint(20) NOT NULL,
  `name` varchar(30) DEFAULT NULL,
  `age` int(11) NULL DEFAULT NULL ,
  `email` varchar(50) DEFAULT NULL,
  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
  `update_time` timestamp(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
  `create_time` timestamp(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6) ,
  PRIMARY KEY (`id`) 
) ENGINE = InnoDB DEFAULT CHARSET=utf8;

b>添加数据

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、创建Spring Boot工程

a>初始化工程
使用 Spring Initializr 快速初始化一个 Spring Boot 工程

b>引入依赖

    
        
            org.springframework.boot
            spring-boot-starter
        

        
            org.springframework.boot
            spring-boot-starter-test
            test
        

        
            com.baomidou
            mybatis-plus-boot-starter
            3.4.1
        

        
            org.projectlombok
            lombok
            true
        
        
            mysql
            mysql-connector-java
            runtime

3、编写代码

a>配置application.yml

spring:
  datasource:
    # 配置数据源信息
    type: com.zaxxer.hikari.HikariDataSource
    # 配置连接数据库信息
    driver-class-name: com.mysql.jdbc.Driver
    username: root
    password: 12345
    url: jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false

注意：

1、驱动类driver-class-name

spring boot 2.0（内置jdbc5驱动），驱动类使用：

driver-class-name: com.mysql.jdbc.Driver
spring boot 2.1及以上（内置jdbc8驱动），驱动类使用：
driver-class-name: com.mysql.cj.jdbc.Driver
否则运行测试用例的时候会有 WARN 信息

2、连接地址url
MySQL5.7版本的url：
jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
MySQL8.0版本的url：
jdbc:mysql://localhost:3306/mybatis_plus?
serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
否则运行测试用例报告如下错误：
java.sql.SQLException: The server time zone value 'ÖÐ¹ú±ê×¼Ê±¼ä' is unrecognized or
represents more

b>启动类

Spring Boot启动类中添加@MapperScan注解，扫描mapper包

@SpringBootApplication
@MapperScan("com.atguigu.mybatisplus.mapper")
public class MybatisPlusApplication {

    public static void main(String[] args) {
        SpringApplication.run(MybatisPlusApplication.class, args);
    }

}

c>添加实体

若实体类中的属性使用的是驼峰命名风格，而表中的字段使用的是下划线命名风格
例如实体类属性isDeleted，表中字isdeleted，此时MyBatis-Plus会自动将下划线命名风格转化为驼峰命名风格

@Data //lombok注解
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
    private int isDeleted;
    private Date createTime;
    private Date updateTime;
}

d>添加mapper

BaseMapper是MyBatis-Plus提供的模板mapper，其中包含了基本的CRUD方法，泛型为操作的
实体类型

@Mapper
public interface UserMapper extends BaseMapper {
}

e>测试

@SpringBootTest
public class MyBatisPlusTest {
    @Autowired
    private UserMapper userMapper;

    @Test
    public void a(){
        List users = userMapper.selectList(null);
        System.out.println(users);
    }
}

结果：

注意：

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

f>添加日志

在application.yml中配置日志输出

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

三、基本CRUD

1、BaseMapper

MyBatis-Plus中的基本CRUD在内置的BaseMapper中都已得到了实现，我们可以直接使用，接口如下：

public interface BaseMapper extends Mapper {

    
    int insert(T entity);

    
    int deleteById(Serializable id);

    
    int deleteByMap(@Param(Constants.COLUMN_MAP) Map columnMap);

    
    int delete(@Param(Constants.WRAPPER) Wrapper queryWrapper);

    
    int deleteBatchIds(@Param(Constants.COLLECTION) Collection idList);

    
    int updateById(@Param(Constants.ENTITY) T entity);

    
    int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper updateWrapper);

    
    T selectById(Serializable id);

    
    List selectBatchIds(@Param(Constants.COLLECTION) Collection idList);

    
    List selectByMap(@Param(Constants.COLUMN_MAP) Map columnMap);

    
    T selectOne(@Param(Constants.WRAPPER) Wrapper queryWrapper);

    
    Integer selectCount(@Param(Constants.WRAPPER) Wrapper queryWrapper);

    
    List selectList(@Param(Constants.WRAPPER) Wrapper queryWrapper);

    
    List> selectMaps(@Param(Constants.WRAPPER) Wrapper queryWrapper);

    
    List

值	描述
IdType.ASSIGN_ID（默认）	基于雪花算法的策略生成数据id，与数据库id是否设置自增无关
IdType.AUTO	使用数据库的自增策略，注意，该类型请确保数据库设置了id自增，否则无效

MyBatisPlus详细使用（一套带走）

一、MyBatis-Plus简介

1、简介 MyBatis-Plus（简称 MP）是一个 MyBatis的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。 愿景 我们的愿景是成为 MyBatis 最好的搭档，就像魂斗罗中的 1P、2P，基友搭配，效率翻倍。

二、入门案例

1、创建数据库及表

b>添加数据 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、创建Spring Boot工程

a>初始化工程 使用 Spring Initializr 快速初始化一个 Spring Boot 工程

b>引入依赖 org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-test test com.baomidou mybatis-plus-boot-starter 3.4.1 org.projectlombok lombok true mysql mysql-connector-java runtime

3、编写代码

b>启动类 Spring Boot启动类中添加@MapperScan注解，扫描mapper包 @SpringBootApplication @MapperScan("com.atguigu.mybatisplus.mapper") public class MybatisPlusApplication { public static void main(String[] args) { SpringApplication.run(MybatisPlusApplication.class, args); } }

d>添加mapper BaseMapper是MyBatis-Plus提供的模板mapper，其中包含了基本的CRUD方法，泛型为操作的 实体类型 @Mapper public interface UserMapper extends BaseMapper { }

f>添加日志 在application.yml中配置日志输出 # 配置MyBatis日志 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

三、基本CRUD

3、删除

a>通过id删除记录 @Test public void testDeleteById(){ //通过id删除用户信息 //DELETE FROM user WHERe id=? int result = userMapper.deleteById(1475754982694199298L); System.out.println("受影响行数："+result); }

b>通过id批量删除记录 @Test public void testDeleteBatchIds(){ //通过多个id批量删除 //DELETE FROM user WHERe id IN ( ? , ? , ? ) List idList = Arrays.asList(1L, 2L, 3L); int result = userMapper.deleteBatchIds(idList); System.out.println("受影响行数："+result); }

4、修改 @Test public void testUpdateById(){ User user = new User(4L, "admin", 22, null); //UPDATE user SET name=?, age=? WHERe id=? int result = userMapper.updateById(user); System.out.println("受影响行数："+result); }

5、查询

a>根据id查询用户信息 @Test public void testSelectById(){ //根据id查询用户信息 //SELECT id,name,age,email FROM user WHERe id=? User user = userMapper.selectById(4L); System.out.println(user); }

a>IService MyBatis-Plus中有一个接口 IService和其实现类 ServiceImpl，封装了常见的业务层逻辑 详情查看源码IService和ServiceImpl

c>测试查询记录数 @Autowired private UserService userService; @Test public void testGetCount(){ long count = userService.count(); System.out.println("总记录数：" + count); }

四、常用注解

b>通过@TableName解决问题

b>通过@TableId解决问题 在实体类中uid属性上通过@TableId将其标识为主键，即可成功执行SQL语句

3、@TableField 经过以上的测试，我们可以发现，MyBatis-Plus在执行SQL语句时，要保证实体类中的属性名和 表中的字段名一致。 如果实体类中的属性名和字段名不一致的情况，会出现什么问题呢？

a>情况1 若实体类中的属性使用的是驼峰命名风格，而表中的字段使用的是下划线命名风格 例如实体类属性userName，表中字段user_name 此时MyBatis-Plus会自动将下划线命名风格转化为驼峰命名风格 相当于在MyBatis中配置

b>情况2 若实体类中的属性和表中的字段不满足情况1 例如实体类属性name，表中字段username 此时需要在实体类属性上使用@TableField("username")设置属性所对应的字段名

4、@TableLogic

五、条件构造器和常用接口

2、QueryWrapper

六、插件

1、分页插件 MyBatis Plus自带分页插件，只要简单的配置即可实现分页功能

2、乐观锁

b>乐观锁实现流程 取出记录时，获取当前version SELECT id,`name`,price,`version` FROM product WHERe id=1 更新时，version + 1，如果where语句中的version版本不对，则更新失败 UPDATE product SET price=price+50, `version`=`version` + 1 WHERe id=1 AND `version`=1

七、通用枚举 表中的有些字段值是固定的，例如性别（男或女），此时我们可以使用MyBatis-Plus的通用枚举 来实现

a>数据库表添加字段sex

b>创建通用枚举类型 @Getter public enum SexEnum { MALE(1, "男"), FEMALE(2, "女"); @EnumValue private Integer sex; private String sexName; SexEnum(Integer sex, String sexName) { this.sex = sex; this.sexName = sexName; } }

c>配置扫描通用枚举 mybatis-plus: # 配置扫描通用枚举 type-enums-package: com.atguigu.mybatisplus.enums

d>测试 设置性别信息为枚举项，会将@EnumValue注解所标识的属性值存储到数据库 @Test public void testSexEnum(){ User user = new User(); user.setName("john"); user.setAge(20); user.setSex(SexEnum.MALE); userMapper.insert(user); }

八、代码生成器 AutoGenerator 是 MyBatis-Plus 的代码生成器，通过 AutoGenerator 可以快速生成 Entity、 Mapper、Mapper XML、Service、Controller 等各个模块的代码，极大的提升了开发效率。

1、引入依赖 com.baomidou mybatis-plus-generator 3.4.1 org.freemarker freemarker 2.3.31

2、引入依赖 com.baomidou dynamic-datasource-spring-boot-starter 3.5.0

4、创建用户service public interface UserService extends IService { } @DS("master") //指定所操作的数据源 @Service public class UserServiceImpl extends ServiceImpl implements UserService { }

5、创建商品service public interface ProductService extends IService { } @DS("slave_1") @Service public class ProductServiceImpl extends ServiceImpl implements ProductService { }

Java相关栏目本月热门文章

1、简介
MyBatis-Plus（简称 MP）是一个 MyBatis的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

愿景
我们的愿景是成为 MyBatis 最好的搭档，就像魂斗罗中的 1P、2P，基友搭配，效率翻倍。

b>添加数据
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');

a>初始化工程
使用 Spring Initializr 快速初始化一个 Spring Boot 工程

b>引入依赖
org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-test test com.baomidou mybatis-plus-boot-starter 3.4.1 org.projectlombok lombok true mysql mysql-connector-java runtime

b>启动类
Spring Boot启动类中添加@MapperScan注解，扫描mapper包

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

d>添加mapper
BaseMapper是MyBatis-Plus提供的模板mapper，其中包含了基本的CRUD方法，泛型为操作的
实体类型

@Mapper public interface UserMapper extends BaseMapper { }

f>添加日志
在application.yml中配置日志输出

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

a>通过id删除记录
@Test public void testDeleteById(){ //通过id删除用户信息 //DELETE FROM user WHERe id=? int result = userMapper.deleteById(1475754982694199298L); System.out.println("受影响行数："+result); }

b>通过id批量删除记录
@Test public void testDeleteBatchIds(){ //通过多个id批量删除 //DELETE FROM user WHERe id IN ( ? , ? , ? ) List idList = Arrays.asList(1L, 2L, 3L); int result = userMapper.deleteBatchIds(idList); System.out.println("受影响行数："+result); }

4、修改
@Test public void testUpdateById(){ User user = new User(4L, "admin", 22, null); //UPDATE user SET name=?, age=? WHERe id=? int result = userMapper.updateById(user); System.out.println("受影响行数："+result); }

a>根据id查询用户信息
@Test public void testSelectById(){ //根据id查询用户信息 //SELECT id,name,age,email FROM user WHERe id=? User user = userMapper.selectById(4L); System.out.println(user); }

a>IService
MyBatis-Plus中有一个接口 IService和其实现类 ServiceImpl，封装了常见的业务层逻辑
详情查看源码IService和ServiceImpl

c>测试查询记录数
@Autowired private UserService userService; @Test public void testGetCount(){ long count = userService.count(); System.out.println("总记录数：" + count); }

b>通过@TableId解决问题
在实体类中uid属性上通过@TableId将其标识为主键，即可成功执行SQL语句

3、@TableField
经过以上的测试，我们可以发现，MyBatis-Plus在执行SQL语句时，要保证实体类中的属性名和
表中的字段名一致。

如果实体类中的属性名和字段名不一致的情况，会出现什么问题呢？

a>情况1
若实体类中的属性使用的是驼峰命名风格，而表中的字段使用的是下划线命名风格
例如实体类属性userName，表中字段user_name
此时MyBatis-Plus会自动将下划线命名风格转化为驼峰命名风格
相当于在MyBatis中配置

b>情况2
若实体类中的属性和表中的字段不满足情况1
例如实体类属性name，表中字段username
此时需要在实体类属性上使用@TableField("username")设置属性所对应的字段名

1、分页插件
MyBatis Plus自带分页插件，只要简单的配置即可实现分页功能

b>乐观锁实现流程
取出记录时，获取当前version

SELECT id,`name`,price,`version` FROM product WHERe id=1

更新时，version + 1，如果where语句中的version版本不对，则更新失败

UPDATE product SET price=price+50, `version`=`version` + 1 WHERe id=1 AND `version`=1

七、通用枚举
表中的有些字段值是固定的，例如性别（男或女），此时我们可以使用MyBatis-Plus的通用枚举
来实现

b>创建通用枚举类型
@Getter public enum SexEnum { MALE(1, "男"), FEMALE(2, "女"); @EnumValue private Integer sex; private String sexName; SexEnum(Integer sex, String sexName) { this.sex = sex; this.sexName = sexName; } }

c>配置扫描通用枚举
mybatis-plus: # 配置扫描通用枚举 type-enums-package: com.atguigu.mybatisplus.enums

d>测试
设置性别信息为枚举项，会将@EnumValue注解所标识的属性值存储到数据库

@Test public void testSexEnum(){ User user = new User(); user.setName("john"); user.setAge(20); user.setSex(SexEnum.MALE); userMapper.insert(user); }

八、代码生成器
AutoGenerator 是 MyBatis-Plus 的代码生成器，通过 AutoGenerator 可以快速生成 Entity、
Mapper、Mapper XML、Service、Controller 等各个模块的代码，极大的提升了开发效率。

1、引入依赖
com.baomidou mybatis-plus-generator 3.4.1 org.freemarker freemarker 2.3.31

2、引入依赖
com.baomidou dynamic-datasource-spring-boot-starter 3.5.0

4、创建用户service
public interface UserService extends IService { }

@DS("master") //指定所操作的数据源 @Service public class UserServiceImpl extends ServiceImpl implements UserService { }

5、创建商品service
public interface ProductService extends IService { }

@DS("slave_1") @Service public class ProductServiceImpl extends ServiceImpl implements ProductService { }