Mybatis-Plus使用教程

---------------------------------MyBatis-Plus---------------------------------
文章末尾有源码
简介：
Mybatis-Plus(简称MP)，是一个MyBatis的增强工具包,只做增强不做改变,为简化开发工作、提高生成
率而生。
我们的愿景是成为Mybatis最好的搭档，就像魂斗罗中的 1P、2P，基友搭配，效率翻倍。

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

2.1、创建测试表

-- 创建库
create database `mp`;
-- 使用库
use `mp`;
-- 创建表
create table tbl_emplovee(
	`id` int(11) primary key auto_increment comment '主键',
	`last_name` varchar(50) default null comment '姓',
	`email` varchar(50) default null comment '邮箱',
	`gender` char(1) default null comment '性别',
	`age` int default null comment '年龄'
);	
-- 插入数据
insert into mp.tbl_emplovee(last_name,email,gender,age) values 
('Tom','tom@can.com',1,22),
('Jerry','jerry@can.com',0,25),
('Black','black@can.com',1,30),
('White','white@can.com',0,35);

环境搭建
1.新建maven项目
2.POM配置maven依赖

我这里用了一个父工程的POM

<?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 http://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.2.5.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.can</groupId>
    <artifactId>springboot-Mybatis-Plus</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>springboot-MybatisPlus-01</module>
    </modules>

    <dependencies>
        <!-- lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.12</version>
        </dependency>
        <!-- junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

    </dependencies>
</project>

子工程maven

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>springboot-Mybatis-Plus</artifactId>
        <groupId>com.can</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>springboot-MybatisPlus-01</artifactId>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <!-- MybatisPlus
         PM如果会自动维护 mybatis和mybatis-spring 所以不用在添加这两个依赖 -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.3.1</version>
        </dependency>
        <!-- druid数据源 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.21</version>
        </dependency>

        <!-- springboot官方的 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- mysql驱动 -->
        <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>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

注意点：Mybatis及Mybatis-spring依赖请勿加入项目配置，以免引起版本冲突！！！Mybatis-Plus会自动维护!

配置文件applicaton.properties

#加载驱动
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#数据库连接路径
spring.datasource.url=jdbc:mysql://localhost:3306/mp?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
#账号
spring.datasource.username=root
#密码
spring.datasource.password=root
#切换数据源类型
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
#配置日志(显式Mybatis执行的SQL语句)
logging.level.com.can.dao. = DEBUG

实体类

package com.can.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * javaBean
 */

@Data
@AllArgsConstructor
@NoArgsConstructor
//这里用引用类型是因为 引用类型可以为null，而基本类型都会有默认值这样框架不好判断.
public class Employee {

    private Long id;
    private String lastName;
    private String email;
    private Integer gender;
    private Integer age;
}

MybatisPlus对简单的单表增删改操作可以更简单。
通过Mapper接口继承BaseMapper即可使用MybatisPlus提供的通用增删改查方法。
代码如下

package com.can.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.can.pojo.Employee;

public interface EmployeeMapper extends BaseMapper<Employee> {

}

这里用@Autowired注入会报错,我也不知道为什么
@Resource与@Autowired的区别?
1.@Autowired按byType自动注入。

2.@Resource默认按byName自动注入。

但是@Resource有两个属性是比较重要的，分是name和type；

如果使用name属性，则使用byName的自动注入策略，而使用type属性时则使用byType自动注入策略;

3.@Autowired是spring自己定义的注解，@Resource是J2EE的，由JSR-250规范定义。

由于实体类的命名和数据库表中的名称不一致，所以要在实体类中添加一个注解:
@TableName(“tbl_employee”)
在启动类加上扫描接口的注解 @MapperScan(“com.can.dao”)

然后我们测试一个MybatisPlus的通用方法

1.测试查询

package com.can;

import com.can.dao.EmployeeMapper;
import com.can.pojo.Employee;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

import javax.annotation.Resource;
import java.util.List;

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

    @Resource
    EmployeeMapper employeeMapper;

    @Test
    public void contextLoads(){
        List<Employee> employeeList = employeeMapper.selectList(null);
        for (Employee employee : employeeList) {
            System.out.println(employee);
        }
    }
}

这里参数给的Null，就不会有条件了
查询结果为

2020-03-08 03:41:11.818  INFO 18340 --- [           main] com.alibaba.druid.pool.DruidDataSource   : {dataSource-1} inited
2020-03-08 03:41:11.988 DEBUG 18340 --- [           main] com.can.dao.EmployeeMapper.selectList    : ==>  Preparing: SELECT id,last_name,email,gender,age FROM tbl_employee 
2020-03-08 03:41:12.018 DEBUG 18340 --- [           main] com.can.dao.EmployeeMapper.selectList    : ==> Parameters: 
2020-03-08 03:41:12.049 DEBUG 18340 --- [           main] com.can.dao.EmployeeMapper.selectList    : <==      Total: 4
Employee(id=1, lastName=Tom, email=tom@can.com, gender=1, age=22)
Employee(id=2, lastName=Jerry, email=jerry@can.com, gender=0, age=25)
Employee(id=3, lastName=Black, email=black@can.com, gender=1, age=30)
Employee(id=4, lastName=White, email=white@can.com, gender=0, age=35)

2.测试新增

接下来测试新增方法
由于数据库id是自增，且实体类lastname与数据库last_name名称不一致所以要修改一下实体类
#mybatis默认开启驼峰命名法 false则为关闭
mybatis-plus.configuration.map-underscore-to-camel-case=false

package com.can.pojo;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * javaBean
 */