MybatisPlus实战笔记
概述
Mybatis支持定制化SQL、存储过程以及高级映射，避免几乎所有的 JDBC 代码和手动设置参数以及获取结果集。可以使用简单的 XML 或注解来配置和映射原生信息，将接口和Java的POJO映射成数据库中的记录。
缺点：
SQL工作量很大，尤其是字段较多时。单表的增删改查操作可以通过mybatis generator工具来生成（或自己写模板工具生成），但项目开发的过程中总免不了要新添加新字段，得把新字段写到原来的所有增删改查的sql中。
mybatis的单表操作比较麻烦，因为筛选的条件可能会各种各样，所以不得不写很多动态sql来兼容查询条件。
MybatisPlus（简称MP）的出现，可以一定程度上优化上述问题，MP集Mybatis与Hibernate的优点。提供Hibernate的单表CRUD操作的方便同时，又保留Mybatis的特性。在Mybatis的基础上只做增强不做改变，为简化开发、提高效率而生。
特点：
- 无侵入：只做增强不做改变
- 损耗小：启动即自动注入基本CRUD，直接面向对象操作
- 强大的CRUD操作：内置通用Mapper、Service，通过少量配置即可实现单表大部分CRUD操作，还有条件构造器
- 支持多种数据库：
- 支持Lambda形式调用：
- 支持主键自动生成：4中主键策略（包括分布式唯一ID生成器-Sequence），可以自由配置，解决主键问题
- 支持XML热加载：
mapper.xml支持热加载，简单的CRUD操作无需重启，甚至支持无XML启动 - 支持ActiveRecord模式
- 内置代码生成器：
- 支持关键词自动转义：
- 支持自定义全局通用操作：
- 解除SQL与程序代码的耦合
- 提供映射标签
- 提高对象关系映射标签
- 通过xml标签，支持编写动态SQL
具体的：
架构
架构原理，可参考
功能
注解
@TableId, 用于主键，MP 支持4种主键策略 IdType
@TableName，用于表名
@TableField，字段，exist=true/false，是否对应数据表字段
@Version，乐观锁标记
@KeySequence，序列主键策略，主要
@TableLogic，用于逻辑删除的字段
全局配置 GlobalConfiguration
需要注入到MybatisSqlSessionFactoryBean里面，才能生效
dbColumnUnderline，MP2.3默认为true
idType配置后无需对所有的主键加注解
tablePrefix，仅适用于所有表名前缀相同的情况下
直接获取主键值，无需任何配置，基于BaseMapper
Mapper，顶级Mapper，继承该接口后，无需编写mapper.xml文件，即可获得CRUD功能，支持 id 泛型
insertAllColumn(); // 无需对全部字段进行setter，然后反应到DB层，落值为null
insert(); // 对全部字段有非空判断
updateById();
updateAllColumnById(); // 没有setter时会覆盖原有数据为null
T selectById(Serializable id);
T selectOne(@Param("ew") T entity);
List<T> selectBatchIds(List<? extends Serializable> idList);
List<T> selectByMap(@Param("cm") Map<String, Object> columnMap);
List<T> selectPage(RowBounds rowBounds, @Param("ew") Wrapper<T> wrapper);
RowBounds，分页查询条件，SQL语句没有limit关键字，不是真实的物理分页？！
Page，分页辅助类，
分页插件
Spring Boot配置方式：
@Bean
public PaginationInterceptor paginationInterceptor() {
return new PaginationInterceptor();
}
UserMapper.java：
List<User> getList(Pagination page, Integer status);
UserServiceImpl.java调用分页方法，需要page.setRecords回传给页面：
public Page<User> getList(Page<User> page, Integer status) {
return page.setRecords(userMapper.getList(page, status));
}
Mybatis PageHelper对比MP PaginationInterceptor
Mybatis PageHelper是独立于Mybatis的依赖包，需要引入多个maven依赖。而MP PaginationInterceptor是MP自带插件，是否启用插件取决于是否配置。底层原理都是使用拦截器实现。
公共字段自动填充
平时在建对象表时都会有最后修改时间last_update_time，最后修改人last_update_name这两个字段，对于这些大部分表都有的字段，每次在新增和修改的时候都要考虑到这几个字段有没有传进去，很麻烦。
MybatisPlus公共字段自动填充的功能可以解决此问题。一般满足下面条件的字段就可以使用此功能：
- 这个字段是大部分表都会有的。
- 这个字段的值是固定的，或则字段值是可以在后台动态获取的。
MybatisPlus 2.0.6版本支持更新数据公共字段自动填充，之前都是只支持新增数据的时候可以使用。
配置：
继承IMetaObjectHandler抽象类，实现两个方法，insertFill()用于新增数据时需要填充的字段，updateFill()用于更新数据时需要填充的字段：
import org.apache.ibatis.reflection.MetaObject;
import org.apache.shiro.SecurityUtils;
import org.springframework.stereotype.Component;
import com.baomidou.mybatisplus.mapper.MetaObjectHandler;
/** mybatisplus自定义填充公共字段, 即没有传的字段自动填充*/
@Component
public class MyMetaObjectHandler extends MetaObjectHandler {
// 新增填充
@Override
public void insertFill(MetaObject metaObject) {
Object lastUpdateNameId = metaObject.getValue("lastUpdateNameId");
Object lastUpdateTime = metaObject.getValue("lastUpdateTime");
// 获取当前登录用户
SysUser user = (SysUser)SecurityUtils.getSubject().getPrincipal();
if (null == lastUpdateNameId) {
metaObject.setValue("lastUpdateNameId", user.getId());
}
if (null == lastUpdateTime) {
metaObject.setValue("lastUpdateTime", new Date());
}
}
// 更新填充
@Override
public void updateFill(MetaObject metaObject) {
insertFill(metaObject);
}
}
getValue()方法的参数是POJO类里面的变量（驼峰的命名方式）。
在MybatisPlus的配置文件中公共字段生成类的bean：
// 全局配置
GlobalConfiguration globalConfig = new GlobalConfiguration();
// 配置公共字段自动填写
globalConfig.setMetaObjectHandler(new MyMetaObjectHandler());
也就是将刚刚写的公共字段填充的设置设置到MP全局配置的对象中。
填充的字段需要忽略验证，在表对象pojo类的对应属性上添加下面注解：
@TableField(value = "last_update_id", validate = FieldStrategy.NOT_EMPTY)
private String lastUpdateNameId;
@TableField(value = "last_update_time", validate = FieldStrategy.NOT_EMPTY)
private Date lastUpdateTime;
原因：因为调用更新和插入的方法时，会验证你所传的属性是否为空，来判断是否该更新和插入这个属性，这个就和公共字段自动填充相冲突，所以需要这个注解来标识此属性不需要验证。不然在插入的时候就会填充失败。
测试
// 公共字段自动填充
// 1.在mybatisplus的配置文件中公共字段生成类的bean
// 2.实现IMetaObjectHandler类
// 3.忽略对应字段的为空检测，在pojo类的属性上添加@TableField(value="last_update_name_id",validate=FieldStrategy.IGNORED)
@Test
public void publicTest(){
SysUser user = new SysUser();
sysUserService.insert(user);
sysUserService.selectById(user.getId());
SysUser user1 = new SysUser();
user1.setId(user.getId());
sysUserService.updateById(user1);
sysUserService.selectById(user.getId());
}
本来是打算创建人和创建时间，也使用这种方法处理的，最后发现，如果将这两个字段也忽略为空的判断，也就是加上validate=FieldStrategy.NOT_EMPTY，在更新数据的时候会将创建人和创建时间一起更新，不传的话就会更新为空。但是在正真用的上的需求上面使用的时候还不够完善。
逻辑删除
使用此插件后的效果：
- 在mp自带查询和更新方法的SQL后面，追加
<逻辑删除字段>= - 删除方法: deleteById()和其他delete方法，底层SQL为：
update tbl_xxx set <逻辑删除字段>=
配置如下：
- 修改集成全局注入器为 LogicSqlInjector
application.yml全局注入值：logicDeleteValue // 逻辑删除全局值 logicNotDeleteValue // 逻辑未删除全局值
自定义注入器的一种，
需要@TableLogic
问题：不能配置多个AutoSqlInjector注入器？
支持XML热加载
在使用MyBatis本地开发时，需要经常性地修改调整mapper.xml文件。IDEA虽然自带热更新（热加载）功能，但是对于mapper.xml文件却不奏效，也就是说在修改mapper.xml文件后，需要重启应用。
哪怕应用足够轻量级或者优化得足够好，启动也需要好几秒时间。此时有个mapper.xml文件热加载功能就可以提高开发效率。
经过调研，是可以实现的，参考：MyBatis系列之mapper.xml实现热加载HotSwap。
而MP自带mapper.xml文件热加载功能。
模糊查询
like
notlike
likeLeft
likeRight
代码生成
配置好generator.properties文件：
# 包前缀
package=com.github
# 模块名
moduleName=shop
# 作者名
author=johnny
email=
# 表前缀，如表tb_sys_user 生成类 sys_user
tablePrefix=m_,r_,s_
# 数据转换类型
tinyint=Boolean
smallint=Integer
mediumint=Integer
int=Integer
integer=Integer
bigint=Long
float=Float
double=Double
decimal=BigDecimal
bit=Boolean
char=String
varchar=String
tinytext=String
text=String
blob=String
mediumtext=String
longtext=String
date=Date
datetime=Date
timestamp=Date
定义好velocity模板文件（pom文件需要引入velocity依赖），从数据表PO实体类到Controller接口方法都支持自动生成：Model.java.vm、Mapper.java.vm、Mapper.xml.vm、Service.java.vm、ServiceImpl.java.vm、Controller.java.vm。
如：
package ${package}.${moduleName}.model;
import ${package}.common.model.SuperEntity;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
#if(${hasBigDecimal})
import java.math.BigDecimal;
#end
import java.util.Date;
/**
* ${comments}
*
* @author ${author}
*/
@Data
@TableName("${tableName}")
public class ${className} extends SuperEntity {
#foreach ($column in $columns)
#if($column.columnName != $pk.columnName && $column.columnName != "createTime" && $column.columnName !=
"updateTime")
private $column.attrType $column.attrname;
#end
#end
}
其他
执行分析，性能分析，乐观锁，XML热加载，自定义全局操作，逻辑删除，读写分离&多数据源，主键Sequence，多租户SQL解析器，通用枚举自动注入，IDEA快速开发；
条件构造器
EntityWrapper/Condition，都是基于Wrapper，Wrapper抽象类的方法：
.last()有SQL注入的风险
AR
Active Record，一种数据访问设计模式，它可以帮助你实现数据对象Object到关系数据库的映射。
Model，实现pkVal抽象方法，指定当前实体类的主键属性
EntityWrapper，支持泛型，builder模式，
不用注入aaaMapper，
AutoGenerator
Oracle 主键问题
使用@KeySequence解决，用在实体类上，
数据库层面：
create sequence seq_user start with 100 increment by 2;
-- 查询序列的下一个值
select seq_user.nextval from dual;
-- 查询序列的当前值
select seq_user.currval from dual;
2.问题
mybatis-plus怎么实现单表URUD操作？
mybatis-plus的底层实现原理是什么？
mybatis-plus与其他同类框架如mybatis helper有很什么优势？
如何集成mybatis-plus快速搭建一个spring boot项目。
参考
MyBatis-Plus源码分析