Spring boot 4 搞懂MyBatis-Plus的用法

MyBatis-Plus 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生

官方地址：
git源码
文档

Spring boot 4如何集成

增加依赖

Add MyBatis-Plus dependency

<mybatisplus.version>3.5.15</mybatisplus.version><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-spring-boot4-starter</artifactId><version>${mybatisplus.version}</version></dependency><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-jsqlparser</artifactId><version>${mybatisplus.version}</version></dependency>

配置

@ConfigurationpublicclassMybatisPlusConfig{@BeanpublicMybatisPlusInterceptormybatisPlusInterceptor(){MybatisPlusInterceptormybatisPlusInterceptor=newMybatisPlusInterceptor();// 数据权限mybatisPlusInterceptor.addInnerInterceptor(newDataFilterInterceptor());// 分页插件mybatisPlusInterceptor.addInnerInterceptor(newPaginationInnerInterceptor());// 乐观锁mybatisPlusInterceptor.addInnerInterceptor(newOptimisticLockerInnerInterceptor());// 防止全表更新与删除mybatisPlusInterceptor.addInnerInterceptor(newBlockAttackInnerInterceptor());returnmybatisPlusInterceptor;}}

基础特性

1. “零SQL” CRUD
   • 核心点：业务模块的Mapper 接口继承BaseMapper<T>，即可拥有insert、selectById、updateById、deleteBatchIds等 17 个常用方法。
   • Service CRUD：除了 Mapper 层，MP 还提供了IService和ServiceImpl，封装了更多的业务逻辑方法（如saveBatch批量插入）。
   • 提供SqlHelper工具类实现批量写入或更新操作
2. 条件构造器（Wrapper）
   • 三板斧：QueryWrapper（用于查询，支持lambda避免字段名写错）、UpdateWrapper（用于更新，支持链式设置 set 值）。
   • Lambda 表达式：推荐使用LambdaQueryWrapper，利用方法引用（如User::getName）来指定字段，编译期检查，防止 SQL 拼写错误。
3. 常用注解
   • @TableName：指定表名（如果类名与表名不一致）。
   • @TableId：指定主键策略（如IdType.AUTO自增，IdType.ASSIGN_ID雪花算法）。
   • @TableField：填充字段（如创建时间、更新时间自动填充FieldFill.INSERT_UPDATE），或者逻辑删除字段@TableLogic

增强功能

1. 自动填充
   • 自动填充：实现MetaObjectHandler接口，重写insertFill和updateFill方法，统一处理create_time、update_time等字段。

• 逻辑删除：配置后，delete语句会自动转化为UPDATE语句（设置删除标记），查询时自动追加WHERE deleted = 0条件。 【在实体类中，对应数据库表的逻辑删除字段上添加@TableLogic注解】
  • 插入：逻辑删除字段的值不受限制。
  • 查找：自动添加条件，过滤掉标记为已删除的记录。
  • 更新：防止更新已删除的记录。
  • 删除：将删除操作转换为更新操作，标记记录为已删除
• 自定义ID生成器
  • IdentifierGenerator主要用于生成数据库表的主键ID
  • KeyGenerator是MyBatis框架中的一个接口，用于在执行SQL语句时生成键值，通常用于生成自增主键或者在执行INSERT语句后获取新生成的ID
  • MyBatis-Plus 内置支持多种数据库的主键生成策略，如：
    • H2KeyGenerator
    • OracleKeyGenerator
    • PostgreKeyGenerator
• 多数据源支持：详细使用参见https://github.com/baomidou/dynamic-datasource
  • Spring Boot 1.5.x ~ 2.x.x 使用dynamic-datasource-spring-boot-starter，支持 JDK 8 及以上版本
  • Spring Boot 3.x.x 使用dynamic-datasource-spring-boot3-starter，要求 JDK 17 及以上
  • Spring Boot 4.x.x 使用dynamic-datasource-spring-boot4-starter，要求 JDK 17 及以上

插件机制

常用插件

1. 分页插件（PaginationInnerInterceptor）
   • 原理：MP 的分页不是内存分页，而是物理分页。它通过 MyBatis 的拦截器（Interceptor）机制，在 SQL 执行前重写 SQL（如加上LIMIT）。
   • 使用：配置MybatisPlusInterceptor，注入PaginationInnerInterceptor。代码中使用Page<T>对象接收结果。
2. 乐观锁插件OptimisticLockerInnerInterceptor
   1. 读取记录时，获取当前的版本号（version）。
   2. 在更新记录时，将这个版本号一同传递。
   3. 执行更新操作时，设置version = newVersion的条件为version = oldVersion。
   4. 如果版本号不匹配，则更新失败。
3. 多租户插件TenantLineInnerInterceptor
   1. 是 MyBatis-Plus 提供的一个插件，用于实现多租户的数据隔离。通过这个插件，可以确保每个租户只能访问自己的数据，从而实现数据的安全隔离
   2. 默认插入 SQL 是需要判断租户条件，因此需要配合自动填充字段功能填充租户字段，否则租户字段不会自动保存到数据库
4. 非法SQL拦截插件IllegalSQLInnerInterceptor
   • 用于拦截和检查非法SQL语句。该插件旨在帮助开发者在SQL执行前发现并解决潜在的安全问题，如全表更新、删除操作，以及对索引的检查等
5. 防全表更新与删除插件BlockAttackInnerInterceptor
   1. 专门用于防止恶意的全表更新和删除操作。该插件通过拦截update和delete语句，确保这些操作不会无意中影响到整个数据表，从而保护数据的完整性和安全性

执行流程

MyBatis-Plus（MP）插件的执行流程，本质上是基于MyBatis 的插件（Plugin）机制实现的。MP 利用这一机制，在 MyBatis 的核心执行流程中“插入”自己的逻辑，从而实现分页、性能分析、SQL 注入防护等功能。

MybatisPlusInterceptor是“包工头”，它实现了 MyBatis 的接口并拦下所有活；而List<InnerInterceptor>是“工人”，实现具体的功能

如何自定义SQL

通过如下注解，可以实现自定义SQL

• @Select: 查询
• @Insert: 插入
• @Update: 更新
• @Delete: 删除

@MapperpublicinterfaceUserMapperextendsBaseMapper<User>{// 简单查询@Select("SELECT * FROM user WHERE email = #{email}")UserselectByEmail(@Param("email")Stringemail);// 复杂一点的条件查询@Select("SELECT * FROM user WHERE status = #{status} AND age > #{minAge}")List<User>selectByStatusAndAge(@Param("status")Integerstatus,@Param("minAge")IntegerminAge);}

mybatis知识

# {}和${}的区别

• #{}：是预编译处理（PreparedStatement）。MyBatis 会将它替换为?，能有效防止 SQL 注入
• ${}：是字符串替换。直接将变量拼接到 SQL 中，存在注入风险，通常用于传入数据库表名或排序字段（ORDER BY）

MyBatis 的一级缓存和二级缓存

• 一级缓存：作用域为SqlSession。在同一个会话中，相同的查询不再查数据库。默认开启。
• 二级缓存：作用域为Namespace（多个会话间共享）。需要手动开启，且实体类必须实现序列化接口。
• 失效场景：任何的INSERT,UPDATE,DELETE操作都会刷新缓存

实体类属性名和表中字段名不一致怎么办？

1. 在 SQL 语句中使用别名（AS）。
2. 使用ResultMap进行映射（最常用）。
3. 开启驼峰命名自动转换配置（mapUnderscoreToCamelCase）

Mybatis的缓存机制

一级缓存建议保持默认（开启），而二级缓存通常不建议开启（默认也是关闭的），尤其是在复杂的业务或分布式系统中

一级缓存

一级缓存的实现参见：BaseExecutor、PerpetualCache

• 一级缓存的生命周期由Executor（执行器）管理。在BaseExecutor（所有执行器的基类）中，定义了本地缓存对象
• SqlSession每次创建都会生成一个新的Executor，所以一级缓存是线程隔离的【参见DefaultSqlSessionFactory】

二级缓存

二级缓存的实现参见：CachingExecutor、SynchronizedCache
当开启二级缓存后，MyBatis 会使用CachingExecutor包装原来的Executor

装饰器模式：二级缓存的实现非常优雅，PerpetualCache是基础，通过SynchronizedCache（同步）、LoggingCache（日志）、ScheduledCache（定时）、SerializedCache（序列化）、LruCache（回收策略）等装饰器层层包装，组合出最终需要的功能

是否开启

一句话建议：用好一级缓存，忘掉二级缓存，用 Redis 来做全局缓存