mybatis-plus，sgg，杨bochao，p17完成

MyBatis-Plus (baomidou.com)

一 MyBatis-Plus简介

1. 增强工具。只做增强不做改。
   1. 可以直接在mybatis的基础上整合mybatis-plus。此时并不会影响mybatis的功能，即mybatis原来的功能都在，该怎么用还怎么用。锦上添花的是还能使用mybatis-plus提供的：通用的mapper、通用的service、在不编写任何sql语句的基础上快速完成单表的CRUD、批量操作、逻辑删除、分页、优秀插件的使用、多数据源的配置等待功能。
2. 框架结构
   1. 右半部分：mybatis-plus的组成部分，共同支持mybatis-plus的功能实现
      1. mybatis-plus-boot-starter：mybatis-plus本身的启动器
      2. annotation：注解部分
      3. extension：扩展部分
      4. core：核心部分
      5. generator：代码生成部分
   2. 左半部分：展示了mybatis-plus该如何来实现功能
      1. 第一步：Scan Entity：扫描实体类
         1. 在开发过程中，为什么不需要手写sql语句（mybatis需要）呢？因为mybaits-plus中sql语句都是动态生成的，所以第一步要扫描要操作的实体类（当前操作的表由实体类决定）。
      2. 第二步：Reflection extraction：反射抽取
         1. 经过实体类的扫描以后，通过反射抽取实体类中的属性。
      3. 第三步：Analysis Table Name Column
         1. 抽取出实体类中的属性以后，分析实体类和表之间的关系、分析实体类属性与表字段之间的关系。
      4. 第四步：SQL: Insert Update Delete Select：当前调用的CRUD方法
         1. 分析完成以后，根据当前我们调用的CRUD方法，生成相对应的sql语句。
            1. 调用的CRUD方法？因为mybatis-plus提供了通用的mapper、通用的service。
      5. 第五步：Injection Mybatis Container：sql语句注入到mybatis容器中，从而实现最终的功能。

二 基本功能

1 通用mapper

1. 概述
   1. 通用mapper中包含的CRUD方法，它们的返回值都是int类型的，指向的是受影响的行数。   
   2. List> selectMaps(@Param("ew") Wrapper queryWrapper);
      1. 单独使用mybatis的工程：mybatis中我们的查询方法可以返回实体类对象，也可以查询并返回一个List集合，也可以查询并返回一个map集合。
      2. 使用mybatis-plus的工程：同理。也可以。
2.  入门案例
   1. 第一步：mysql
      1. 第1步：创建数据库入表
         1. id，主键，bigint(20)。因为在通过mybatis-plus进行数据插入的时候，它默认用雪花算法来生成id，这样一来id的长度会比较长，所以这里使用的是bigint而非int。
   2. 第二步：idea
      1. 第1步：创建spring boot工程
      2. 第2步：pom.xml
         1. 第a步：lombok依赖。
      3. 第3步：idea插件安装
         1. 第a步：idea安装lombok插件。
      4. 第4步：application.yml
         1. 第a步：数据源类型：type: com.zaxxer.hikari.HikariDataSource（此类型：springboot中默认使用的数据源类型）
         2. 第b步：jdbc:mysql://localhost:3306/mysql?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
            1. characterEncoding：连接数据库、操作数据库时使用的编码格式。
            2. serverTimezone=GMT%2B8：中国时区的配置（mysql8独有配置）
            3. useSSL=false：mysql5和mysql8都要使用此参数
      5. 第5步：编码
         1. 第a步：实体类User.java：因为数据库中的表要和实体类做映射关系；
            1. private Long id：因为数据库表中id使用的是bigint类型，按照数据类型的范围来说，实体类这里最好使用Long类型进行映射（接收）。
            2. @Data ：这是lombok注解。虽然在当前实体类中看不到构造器（有参、无参）、get/set方法，但是经过maven 》complie把当前的工程编译以后，在target 》classes 》User.class会看到构造器、get/set方法、equal方法、tostring方法
            3. maven打包错误： Failed to execute goal org.apache.maven.pluginsmaven-resources-plugin3.2.0resources
               1. pom.xml中springboot版本：2.6.3
               2. pom.xml中jdk版本：8
         2. 第b步：添加mapper接口：UserMapper.java，并使用mybatis-plus提供的通用mapper
            1. 单独使用mybatis的工程：mapper接口中的方法和sql语句都是需要我们手动去写的。
            2. 使用mybatis-plus的工程：使用mybatis-plus提供的通用mapper、通用service功能，快速实现单表的CRUD。
            3. public interface UserMapper extends BaseMapper：BaseMapper中包含了很多很多mybatis-plus提供方法
               1. CRUD方法
         3. 第c步：启动类
            1. 单独使用mybatis的工程：设置mapper接口所在的包、映射文件所在的包。
            2. 使用mybatis-plus的工程：同样需要。

            3. //用于扫描mapper接口所在的包
               //或者所用于扫描指定包下的mapper接口
               @MapperScan("com.atguigu.mapper")

         4. 第d步：测试类
            1. 单独使用mybatis的工程：首先，需要在UserMapper中创建接口方法。然后，在对应的映射文件中编写对应的Sql语句。
            2. 使用mybatis-plus的工程：不用写接口方法，不用写sql语句。首先，继承mybatis-plus提供的模板（通用）XxxMapper。然后，调用相应的crud方法即可。
            3. 原理：因为在启动类中加入了@MapperScan("com.atguigu.mapper")
               ，从而实现把指定包下面的所有的mapper接口所动态生成的代理类交给ioc容器来管理，所以在测试类中可以对ioc容器中管理的组件进行自动装配了，这里我们自动装配UserMapper这个Bean。
            4. 报错：private UserMapper userMapper;中的userMapper有红色波浪线。首先上面分析的（原理）是没有任何问题的。因为@MapperScan("com.atguigu.mapper")扫描的包下都是接口，但在ioc容器中只能存在类所对应的bean，不能存在接口所对应的bean，所以如上面所说是将mapper接口所动态生成的代理类交给ioc容器来管理。而在idea中，它认为UserMapper是一个接口，在idea的编译后半段，idea认为这是无法进行自动装配的，所以有红色波浪线。但注意，在运行接口是没有任何问题的。
            5. 运行报错：(355条消息) 【Java异常】idea 报错：无效的目标发行版：17 的解决办法_No8g攻城狮的博客-CSDN博客_无效的源发行版17
            6. selectList(Wrapper wrapper)：Wrapper为条件构造器。也就是说当我们在查询数据时，如果我们有查询条件的话，我们就可以通过Wrapper来实现。如果没有条件的话，就写null。//selectList()根据MP内置的条件构造器查询一个list集合，null表示没有条件，即查询所有
            7. 报错：Unknown column 'id' in 'field list'：表没有这个字段
         5. 第e步：问题分析
            1. 问题1：解决private UserMapper userMapper;中的userMapper有红色波浪线的问题，方法：在UserMapper.java中加入@Repository注解。@Repository注解的作用是将当前类或者接口标识为一个持久层组件。
            2. 问题2：整个过程中我们没有告诉mybaits要查询哪个表？那它是怎么有知道的呢？因为BaseMapper中的泛型起了作用，User对应的就是user表。为什么会去查询id，name，email呢？因为泛型User中我们设置了属性id，name，email，所以有SELECT id,name,age,email FROM user。总结，mybatis操作的表和字段，是由实体类（泛型）中的类名和属性决定的。
            3. 问题3：mybatis-plus查询user表以后，就把表中对应字段的值，赋值给了我们实体类中相对应的属性。
      6. 第6步：添加日志功能，查询mybatis-plus帮我们生成的sql语句
         1. log-impl: org.apache.ibatis.logging.stdout.StdOutImpl：使用默认的（自带）的就行。
3. 增
   1. BaseMapper.insert(user)
      1. 获取自动递增的id=14240358972034957。为什么这个自动递增的主键这么长（实体类属性Long类型，表字段bigint类型）？这个并不是我们所使用的自动递增的主键。那这个主键到底是怎么样生成的呢？首先，在mybaits-plus中默认使用雪花算法来生成id值。
      2. 生成sql语句：INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
         1. User.java对应的是表名user
         2. User.java中的id、name、age、email属性对应的是表的字段
4. 删
   1. BaseMapper.deleteById(1475754982694199298L);        
      1. 这里如果没有加L的话报错，因为1475754982694199298果断已经超过了int的范围，所以我们在后面加上一个L字，表示它是一个Long类型的数据。
   2. BaseMapper.deleteByMap(map);
      1. //根据map集合中所设置的条件删除记录
         //DELETE FROM user WHERE name = ? AND age = ?
   3. BaseMapper.deleteBatchIds(idList);
      1. //通过多个id批量删除
         List<Long> idList = Arrays.asList(1L, 2L, 3L);，因为id是Long（对应数据库中的bigint）类型的。
         //DELETE FROM user WHERE id IN ( ? , ? , ? )
5. 改
   1. BaseMapper.updateById(user);
      1. //UPDATE user SET name=?, age=? WHERE id=?。如果某个属性没有赋值，那么这表中的这个字段不会被更新。
6. ​​​​​​​查
   1. BaseMapper.selectById(4L);
      1. //SELECT id,name,age,email FROM user WHERE id=?。返回id=xxx用户信息。
   2. ​​​​​​​BaseMapper.selectBatchIds(idList);​​​​​​​ ​​​​​​​
      1. ​​​​​​​​​​​​​​​​​​​​​​​​​​​​//根据多个id查询多个用户信息

         //SELECT id,name,age,email FROM user WHERE id IN ( ? , ? )
   3. BaseMapper.selectByMap(map);
      1. //通过map条件查询用户信息
         //SELECT id,name,age,email FROM user WHERE name = ? AND age = ?
   4. BaseMapper.selectList(null);
      1. //查询所有用户信息
         //SELECT id,name,age,email FROM user
7. 测试自定义功能、执行自定义sql
   1. 应用场景：BaseMapper中的基本方法无法满足我们的CRUD需求
      1. 场景1：mybaits-plus实现两个表的联合查询。
      2. 场景2：mybaits-plus执行自定义的sql语句。
   2. 原理：因为mybaits-plus是在mybatis的基础之上只做增强而不做改变，所以我们之前单独使用mybatis时怎么实现，现在我们就应该怎么实现。
   3. 功能"集合"：mybatis
   4. "神的"冰箱：mybatis
   5. 详细步骤
      1. 回忆，单独使用mybatis的工程：
         1. 第一步：创建Mapper接口。
         2. 第二步：创建映射文件，在里面编写sql语句。
      2. 第一步：在已经有的Mapper接口：UserMapper.java（extends BaseMapper），创建接口方法
         1. 第1步：声明接口方法：Map selectMapById(Long id)
         2. 完整的接口文件：

            @Repository
            public interface UserMapper extends BaseMapper {
                // 根据id查询用户信息，返回map集合
                Map selectMapById(Long id);
            }

      3. 第二步：创建映射文件
         1. 写在哪里？application.yml中通过mybatis-plus.mapper-location=xxx进行配置，这个属性mybatis-plus已经给我们配置了一个默认的位置：classpath*:/mapper/**/*.xml（类路径下的，mapper目录下的，任意子目录下的，任意.xml文件，都是会被看成映射文件）。
         2. 自定义位置？如mybatis-plus.mapper-location=xxx
         3. 如何编写？
            1. 第1步：XxxMapper.xml名称要和UserMapper.java接口名称中Xxx=User。
            2. 第2步：namespace的值是UserMapper.java的绝对路径。
            3. 第3步：标签
               1. 第a步：id="selectMapById（接口方法名称）"
               2. 第b步：resultType="map"。因为mybatis中有类型别名的说法，而这里的"map"就是mybatis（默认）自定义的HashMap集合的类型别名，所以我们这里直接写"map"即可。
               3. 第c步：编写sql语句。
               完整映射文件？

               select id,name ,age,email from user where id=#{id}
      4. 第三步：编写测试类

         @Test
         public void selectMapById(){
             Map map = userMapper.selectMapById(1L);
             System.out.println(map);
         }

   6. 总结：
      1. 从这个案例大家也能够看出来，mybatis-plus其实就是mybtis的一个增强工具，mybatis-plus并不会去改mybatis原有的功能。

2 通用service

1. 概述
   1. 可以使用mybatis-plus提供的通用Mapper中的方法对表进行CRUD操作，同理也可以使用mybatis-plus提供的通用service中的方法对表进行CRUD操作。
   2. 通用service与通用Mapper的区别与联系
      1. 联系（官网）：通用 Service CRUD 封装IService接口，进一步封装 CRUD ，而底层通过调用通用的Mapper实现CRUD。
      2. 区别（官网）：方法名前缀：查（get/list）删（remove）分页（page）。
      3. 总结（CSDN）：Mapper方式，可以实现简单的CRUD。Service方式，可以实现更加丰富的CRUD，但是必须依赖Mapper，也就是必须编写mapper接口。Service简直是BaseMapper的大扩充，不但包含了所有基本方法，还加入了很多批处理功能。
   3. IService的原理？同上
2. 使用
   1. 方案
      1. 方案1：直接使用ServiceImpl,T>。但不建议这样去用，因为以后所遇到的业务逻辑是非常复杂的，开发人员需要根据自己的需求来编写自已的业务逻辑代码，所以mybatis-plus提供的通用ServiceImpl一定是无法满足所有的业务逻辑的需求的。
      2. 方案2：参考UserMapper.java。可以自定义一个UserService，来继承通用ServiceImpl。这样即可以使用通用ServiceImpl提供的功能，也能够自定义自己的业务逻辑功能。
   2. 快速入门：自定义XxxServiceImpl
      1. 第一步：创建实体类User.java
      2. 第二步：创建自定义的Mapper：创建、注入、配置扫描

         public interface UserMapper extends BaseMapper {
         }

      3. 第三步：创建自定义Service接口：

         public interface UserService extends IService { }

      4. 第四步：创建自定义实现类：创建、注入

         /**
          * ServiceImpl实现了IService，提供了IService中基础功能的实现
          * 若ServiceImpl无法满足业务需求，则可以使用自定的UserService定义方法，并在实现类中实现
          */
         @Service
         public class UserServiceImpl extends ServiceImpl implements UserService {
         
         }

      5. 第五步：测试
         1. 测试1：long count = userService.count();，总记录数
         2. 测试2：userService.saveBatch(users);，批量添加（通用Mapper中就没有）

3 常用注解

1. @TableName
   1. 需求：User.java与t_user表映射
   2. 方案1：局部配置：@TableName
   3. 方案2：全局配置，application.yml，配置实体类对应的表的统一“前缀t_”：
                  # 配置MyBatis-Plus操作表的默认前缀
                  table-prefix: t_
2. @TableId
   1. 需求：表的主键必须取名为id，实体类的属性（主键）必须取名为id
   2. 方案：@TableId，实体类属性uid，表字段uid
   3. 属性1：value，实体类属性id，表字段uid
   4. 属性2：type，主键生成策略，mybatis-plus中主键id默认的生成策略是雪花算法
      1. 主键生成策略之雪花算法：：type="IdType.none" 或 type="IdType.ACCESS_ID"
      2. 主键生成策略之mysql中的字段自动递增：type="IdType.AUTO"
      3. 注意：不管在哪个主键生成策略下，如果在调用save方法时Entity设置（set）了主键id，那么mybatis-plus就不会用任何主键生成策略，而直接使用Entity设置（set）的主键值。
   5. 通过全局配置配置主键生成策略
      1. 需求：统一指定主键生成策略
      2. 方案：application.yml
                    # 配置MyBatis-Plus的主键策略
                    id-type: auto
   6. ​​​​​​​雪花算法
      1. ​​​​​​​应用场景：
         1. 场景1：非常适合使用在分布式架构的项目中
            1. ​​​​​​​因为：它能够保证不同表的主键的不重复性，以及相同表的主键的有序性。
3. @TableField
   1. 需求：
   2. 方案：
4. @TableLogic
   1. 业务：
   2. 需求：

4 条件构造（器）：构造需要满足的条件

5 通用枚举

三 插件

1 分页插件（内置）

2 乐观锁插件

四 mybatisX插件（idea快速开发插件）

五 多数据源

六 代码生成器（内置）

1 mybatis逆向工程

1. 自动生成
   1. 实体类
   2. mapper接口
   3. 映射文件

2 mybatis-plus代码生成器

1. 自动生成（各个组件）
   1. 控制层
   2. 业务层
   3. mapper接口
   4. 映射文件
   5. 实体类