当前位置： 首页 > news >正文

MybatisPlus实战笔记

news 2025/8/1 18:42:42

概述

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  {// 新增填充@Overridepublic 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());}}// 更新填充@Overridepublic 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，在更新数据的时候会将创建人和创建时间一起更新，不传的话就会更新为空。但是在正真用的上的需求上面使用的时候还不够完善。

逻辑删除

使用此插件后的效果：

  1. 在mp自带查询和更新方法的SQL后面，追加<逻辑删除字段>=<LogicNotDeleteValue默认值>
  2. 删除方法: deleteById()和其他delete方法，底层SQL为：update tbl_xxx set <逻辑删除字段>=<logicDeleteValue默认值>

配置如下：

  1. 修改集成全局注入器为 LogicSqlInjector
  2. 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源码分析

http://www.lryc.cn/news/109864.html

相关文章：

  • Android Studio 报错：Failed to create Jar file xxxxx.jar
  • Django实现音乐网站 ⑸
  • 基于VUE3+Layui从头搭建通用后台管理系统（前端篇）七：工作台界面实现
  • 前端vue uni-app自定义精美海报生成组件
  • 高通滤波器，低通滤波器
  • 机器学习深度学习——卷积的多输入多输出通道
  • HTML5中Canvas学习笔记：Canvas
  • Windows安装子系统Linux
  • C 语言的 pow() 函数
  • socket 基础
  • JMeter（二十五）、一些概念的理解---90%响应时间、事务、并发
  • 直播课 | 大橡科技研发总监丁端尘博士“类器官芯片技术在新药研发中的应用”
  • Python中的PDF文本提取：使用fitz和wxPython库（带进度条）
  • mysql 将字段值+1或自增
  • 组合总和——力扣39
  • PostgreSQL Patroni_exporter 监控 patroni高可用工具
  • C语言多级指针
  • IDEA项目实践——创建Java项目以及创建Maven项目案例、使用数据库连接池创建项目简介
  • ArraySetter
  • Python如何解决Amazon亚马逊“图文验证码”识别(6)
  • plsql连接oracle出现TTC错误
  • 4-golang爬虫下载的代码
  • Eureka增加账号密码认证登录
  • Practice5|58. 最后一个单词的长度、66. 加一
  • Practice4|14. 最长公共前缀、2. 两数相加
  • 第28天-Kubernetes架构，集群部署，Ingress，项目部署，Dashboard
  • 剑指OfferII-58.左旋转字符串
  • C语言每日一题：14《数据结构》复制带随机指针的链表
  • MySql008——检索数据：过滤数据（WHERE子句的使用）
  • vue2-v-show和v-if有什么区别，使用场景分别是什么？