1.介绍

MyBatis-Plus (opens new window)（简称 MP）是一个 MyBatis (opens new window)的增强工具，在 MyBatis 的基础上只做==增强不做改变==，为简化开发、提高效率而生。--单表操作的都不需要自己在写sql语句。--

愿景

我们的愿景是成为 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 操作智能分析阻断，也可自定义拦截规则，预防误操作.

3.如何使用

快速开始 | MyBatis-PlusMyBatis-Plus 官方文档https://baomidou.com/pages/226c21/#%E6%B7%BB%E5%8A%A0%E4%BE%9D%E8%B5%96

（1）创建数据库和表

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, '[email protected]'),
(2, 'Jack', 20, '[email protected]'),
(3, 'Tom', 28, '[email protected]'),
(4, 'Sandy', 21, '[email protected]'),
(5, 'Billie', 24, '[email protected]');

（2）依赖

<!--mp的依赖-->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.1</version>
        </dependency>

(3)创建实体类

package com.qy151.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

import java.time.LocalDateTime;

/**
 * @unthor : YSH
 * @date : 18:36 2022/7/25
 */
@Data
public class User {

    @TableId(value = "id",type = IdType.ASSIGN_ID )
    private Long id;
    private String name;
    private Integer age;
    private String email;

    @TableField(fill = FieldFill.INSERT)
    @TableLogic //逻辑列
    private Integer isdeleted;



    @TableField(fill = FieldFill.INSERT)//自动填充添加的时间
    private LocalDateTime gmtCreated;//添加的时间


    @TableField(fill = FieldFill.INSERT)//自动填充修改的时间
    private LocalDateTime gmtUpdated;//修改的时间


    //该属性在数据库中存在吗
    @TableField(exist = false)
    private Dept dept;
}

(4)dao

package com.qy151.dao;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.qy151.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * @unthor : YSH
 * @date : 18:35 2022/7/25
 */
@Mapper
public interface UserMapper extends BaseMapper<User> {
  
}

（5）测试

@Autowired
    private UserMapper userMapper;
    @Test
    void contextLoads() {
        User user = userMapper.selectById(1);
        System.out.println(user);
    }

4.增加功能

//添加
    /**
     *  主键mp提供相应的生成策略:
     *     AUTO(0),递增策略，如果使用该策略必须要求数据表的列也是递增。
     *     NONE(1),
     *     INPUT(2),没有策略，必须人为的输入id值
     *     ASSIGN_ID(3), 随机生成一个Long类型的值。该值一定是唯一。而且每次生成都不会相同。算法：雪花算法。 适合分布式主键。
     *     ASSIGN_UUID(4); 随机产生一个String类型的值。该值也是唯一的。
     */
    @Test
    public void insert(){
        User user = new User();
        user.setName("小孙");
        user.setAge(29);
        user.setEmail("[email protected]");
        System.out.println("添加前:============"+user);
        int insert = userMapper.insert(user);
        System.out.println("添加后:============"+user);//mp会把生成的主键值复制给对象
        System.out.println(insert);

5.删除功能

/**
     * 实际开发中：我们的删除可能是逻辑删除。所谓的逻辑删除就是修改功能。把某个列修改以删除的状态值。
     * 只对自动注入的 sql 起效:
     * 插入: 不作限制---
     * 查找: 追加 where 条件过滤掉已删除数据,且使用 wrapper.entity 生成的 where 条件会忽略该字段
     * 更新: 追加 where 条件防止更新到已删除数据,且使用 wrapper.entity 生成的 where 条件会忽略该字段
     * 删除: 转变为更新
     * (1)增加一个逻辑字段: isdeleted 0表示未删除 1表示删除.
     * (2)实体类上的字段添加   @TableLogic.
     */

(1)在数据库user表中添加字段 isdeleted

(2)实体类添加属性并添加注解@TableLogic

(3)测试


    //根据主键id删除
    @Test
    public void delete(){
        int deleteById = userMapper.deleteById(1551528252057780225L);
        System.out.println(deleteById);
    }

6.修改

/**
     *   自动填充功能:
     *     在阿里规则中我们的每一张表必须具备的三个字段 id,create_time,update_time.
     *     这两个字段要不要自己添加。
     *
     *    (1)在需要自动填充属性上@TableField(fill=)
     *    (2)创建mp自动填充类
     */

（1）user表添加列gmt_created,gmt_updated

(2)user实体类添加属性

(3)自定义实现类 MyMetaObjectHandler

package com.qy151.system.config;

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;

import java.time.LocalDateTime;

@Slf4j
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    //当添加时自动填充的值
    @Override
    public void insertFill(MetaObject metaObject) {
        log.info("start insert fill ....");
        this.strictInsertFill(metaObject, "gmtCreated", () -> LocalDateTime.now(), LocalDateTime.class); // 起始版本 3.3.3(推荐)
        this.strictInsertFill(metaObject, "isdeleted", () -> 0, Integer.class); // 起始版本 3.3.3(推荐)
    }


    //当修改时自动填充的值
    @Override
    public void updateFill(MetaObject metaObject) {
        log.info("start update fill ....");
        this.strictUpdateFill(metaObject, "gmtUpdated", () -> LocalDateTime.now(), LocalDateTime.class); // 起始版本 3.3.3(推荐)
    }



}

(4)测试


    //根据主键id进行修改
    @Test
    public void updateById(){
        User user = new User();
        user.setName("张无忌");
        user.setId(1551528252057780225L);
        int updateById = userMapper.updateById(user);
        System.out.println(updateById);

    }

7.查询

7.1根据主键查询

 //根据id查询
    @Test
    public void test01(){
        User user = userMapper.selectById(1);
        System.out.println(user);
    }

7.2根据各种条件查询

//where 列名（gt 大于）/(小于 lt)/(ge 大于等于)/(between值) (and值)      值
        //Wrapper:封装了关于查询的各种条件方法。有三个子类最常用: QueryWrapper查询条件 UpdateWrapper修改条件 LambdaQueryWrapper查询使用lambda表达式条件
        //默认逻辑符为and

//根据各种条件查询
    @Test
    public void  findByCondition(){
      
        QueryWrapper<User> wrapper = new QueryWrapper<>();
        wrapper.between("age",15,25);
        wrapper.like("name","a");
        wrapper.select("name");//指定查询的列名
       /* System.out.println(wrapper.getSqlSelect());//输出查询的条件*/

        List<User> list = userMapper.selectList(wrapper);
        System.out.println(list);
    }

7.3根据条件查询一条记录

//查询一条记录
    @Test
    public void testSelectOne(){
        QueryWrapper<User> wrapper=new QueryWrapper<>();
        wrapper.eq("username","");
        wrapper.eq("password","");
        User user = userMapper.selectOne(wrapper);
    }

7.4分页查询

注意分页查询需要分页插件:

package com.qy151.system.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 {

    /**
     * 新的分页插件,一缓和二缓遵循mybatis的规则,需要设置 MybatisConfiguration#useDeprecatedExecutor = false 避免缓存出现问题(该属性会在旧插件移除后一同移除)
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }


}

测试:

 //分页查询
    @Test
    public void findPage(){
        Page<User> page = new Page<>(2,3);//当前页码为第一页,一页三条记录
        IPage<User> userIPage = userMapper.selectPage(page,null);//把查询的结果自动封装到Page对象中


        System.out.println("总页码:"+page.getPages());
        System.out.println("总条数:"+page.getTotal());
        System.out.println("当前页记录:"+page.getRecords());

    }

7.5连表分页查询

连表分页查询也需要分页插件

(1)实体类添加对象属性并添加注解@TableField(exist = false)，并在user表中添加连表列did

(2)创建实体类Dept

(3)UserMapper中的连表方法

(4)Mapper.xml中的sql语句

<?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.qy151.dao.UserMapper">

    <resultMap id="baseMaper" type="com.qy151.entity.User" autoMapping="true">
        <id property="id" column="id"/>
        <association property="dept" javaType="com.qy151.entity.Dept" autoMapping="true">
            <id column="did" property="did"/>
        </association>
    </resultMap>
    <select id="selectUserWithDept" resultMap="baseMaper">
        select * from user u join tbl_dept d on u.did=d.did  where isdeleted=0

        <if test="ew!=null">
            and ${ew.sqlSegment}
        </if>

    </select>
</mapper>

(5)测试

/连表查询
    @Test
    public void LianbiaoFind(){
        // @Param("ew") Wrapper<T> queryWrapper
        Page<User>  page=new Page<>(1,3);
        QueryWrapper<User> wrapper=new QueryWrapper<>();
        wrapper.eq("name","张三丰");
        IPage<User> users=userMapper.selectUserWithDept(page,wrapper);
        System.out.println("总页码:"+page.getPages());
        System.out.println("总条数:"+page.getTotal());
        System.out.println("当前页记录:"+page.getRecords());
    }

8.mp的代码生成器

8.1旧的版本

(1)导入依赖

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.4.1</version>
        </dependency>
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-engine-core</artifactId>
            <version>2.3</version>
        </dependency>
 
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.30</version>
        </dependency>

(2)创建类并配置代码生成器

package com.qy151;

import com.baomidou.mybatisplus.core.toolkit.StringPool;
import com.baomidou.mybatisplus.generator.AutoGenerator;
import com.baomidou.mybatisplus.generator.InjectionConfig;
import com.baomidou.mybatisplus.generator.config.*;
import com.baomidou.mybatisplus.generator.config.po.TableInfo;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;

import java.util.ArrayList;
import java.util.List;

/**
 * @unthor : YSH
 * @date : 22:32 2022/7/25
 */
// 演示例子，执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
public class CodeGenerator {

    /**
     * <p>
     * 读取控制台内容
     * </p>
     */
    public static void main(String[] args) {
        // 代码生成器
        AutoGenerator mpg = new AutoGenerator();

        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        gc.setOutputDir("./src/main/java");//生成的代码存放的位置
        gc.setAuthor("YSH");//作者
        gc.setOpen(false);//是否打开
        gc.setSwagger2(true); //实体属性  是否生成Swagger2 注解
        mpg.setGlobalConfig(gc);

        // 数据源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setUrl("jdbc:mysql://localhost:3306/mp?serverTimezone=Asia/Shanghai");
        // dsc.setSchemaName("public");
        dsc.setDriverName("com.mysql.cj.jdbc.Driver");
        dsc.setUsername("root");
        dsc.setPassword("root");
        mpg.setDataSource(dsc);

        // 包配置
        //生成的代码生成到那个包下
        PackageConfig pc = new PackageConfig();
        pc.setModuleName("system");//模块的名字
        pc.setParent("com.qy151");//父包的名称
        mpg.setPackageInfo(pc);

        // 自定义配置
        InjectionConfig cfg = new InjectionConfig() {
            @Override
            public void initMap() {
                // to do nothing
            }
        };

        // 如果模板引擎是 freemarker
        String templatePath = "/templates/mapper.xml.ftl";
        // 如果模板引擎是 velocity
        // String templatePath = "/templates/mapper.xml.vm";

        // 自定义输出配置
        List<FileOutConfig> focList = new ArrayList<>();
        // 自定义配置会被优先输出
        focList.add(new FileOutConfig(templatePath) {
            @Override
            public String outputFile(TableInfo tableInfo) {
                // 自定义输出文件名 ， 如果你 Entity 设置了前后缀、此处注意 xml 的名称会跟着发生变化！！
                return "./src/main/resources/mapper/" + pc.getModuleName()
                        + "/" + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
            }
        });
        /*
        cfg.setFileCreate(new IFileCreate() {
            @Override
            public boolean isCreate(ConfigBuilder configBuilder, FileType fileType, String filePath) {
                // 判断自定义文件夹是否需要创建
                checkDir("调用默认方法创建的目录，自定义目录用");
                if (fileType == FileType.MAPPER) {
                    // 已经生成 mapper 文件判断存在，不想重新生成返回 false
                    return !new File(filePath).exists();
                }
                // 允许生成模板文件
                return true;
            }
        });
        */
        cfg.setFileOutConfigList(focList);
        mpg.setCfg(cfg);

        // 配置模板
        TemplateConfig templateConfig = new TemplateConfig();

        // 配置自定义输出模板
        //指定自定义模板路径，注意不要带上.ftl/.vm, 会根据使用的模板引擎自动识别
        // templateConfig.setEntity("templates/entity2.java");
        // templateConfig.setService();
        // templateConfig.setController();

        templateConfig.setXml(null);
        mpg.setTemplate(templateConfig);

        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        //命名规范 驼峰命名
        strategy.setNaming(NamingStrategy.underline_to_camel);
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);
        strategy.setEntityLombokModel(true);
        strategy.setRestControllerStyle(true);
        // 公共父类
        // 写于父类中的公共字段
        strategy.setControllerMappingHyphenStyle(true);
        mpg.setStrategy(strategy);
        mpg.setTemplateEngine(new FreemarkerTemplateEngine());
        mpg.execute();
    }
}

8.2新的版本

注意:此版本仅适用 3.5.1 以上版本，对其它历史版本的不兼容

(1)添加依赖

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.31</version>
        </dependency>