Mybatis-Plus 是一款 MyBatis 的增强工具包，简化 CRUD 操作。启动加载 XML 配置时注入单表 SQL 操作 ，为简化开发工作、提高生产率而生。Mybatis-Plus 启动注入动态 SQL 脚本、性能更优，让你专注业务快速敏捷开发。  

演示例子：https://gitee.com/baomidou/mybatis-plus-samples

官方文档：https://baomidou.com/

升级日志

• fix: 修复Insert无字段时执行SQL报错.

• fix: 修复高版本JDK下lambda无法执行IDEA调试.

• fix: 修复LambdaQuery中select,groupBy,orderBy,orderByAsc,orderByDesc提示的警告,新增对应doXxx方法支持重写(不兼容改动,api方法做了final处理).

• fix: 修复inject-sql-session-on-mapper-scan无配置提示.

• fix: 修复@OrderBy搭配@TableId排序字段错误(不兼容改动,com.baomidou.mybatisplus.core.metadata.TableInfo.orderByFields调整了类型).

• fix: 修复Service中根据主键逻辑删除时类型不匹配导致的错误.

• fix: 修复分页插件Count与自定义ResultHandler冲突.

• fix: 修复字段填充处理器可能会出现重入问题

• feat: 新增自增主键字段是否允许插入控制,可使用方法注入覆盖Insert(boolean ignoreAutoIncrementColumn)或Insert(String name, boolean ignoreAutoIncrementColumn)控制自增主键是否支持写入行为.

• feat: ActiveRecord模式下deleteById(逻辑删除)方法支持自动填充功能.

• feat: 内置泛型提取,支持非Spring体系项目使用.

• feat: BaseMapper新增update(wrapper)更新方法.

• feat: BaseMapper新增流式查询方法对大数据查询支持.

• feat: 代码生成器元数据信息公开tableName与columnName字段访问.

• feat: 新增mybatis-plus-spring-boot3-starter与mybatis-plus-spring-boot3-starter-test支持SpringBoot3.

• feat: 支持插件缺省注入,当无MybatisPlusInterceptor注入时,支持com.baomidou.mybatisplus.extension.plugins.inner.InnerInterceptor自动注入.

• feat: 升级源码Jdk开发版本至Java21.

• feat: 升级gradle-wrapper至8.4-rc-1.

• feat: 升级kotlin-gradle-plugin至1.9.20-Beta.

• feat: 升级SpringBoot2.x版本至2.7.15.

• feat: 升级lombok至1.18.30.

• opt: mybatis-plus-extension中mybatis-spring依赖修改为可选依赖(不兼容改动,如果项目在非spring或非springBoot下使用到了请手动添加依赖).

• opt: spring-boot-starter减少无用的配置提示(不兼容改动,调整了com.baomidou.mybatisplus.autoconfigure.MybatisPlusProperties.configuration类型).

• opt: 字段填充处理器提取去除固定参数提取,支持更宽松的mapper方法参数提取填充处理,

• opt: 去除com.baomidou.mybatisplus.core.toolkit.ReflectionKit.setAccessible方法调用,防止高版本Jdk移除

• opt: 调整selectOne方法(配合流式处理,最多提取两行数据,日志不再打印总记录数).

• opt: 优化selectObjs方法返回值,减少类型强制转换.

• opt: 通用Service支持多SqlSessionFactory注入.

• opt: 优化TableInfo.newInstance创建实例方法.

• opt: 去除多余的@SuppressWarnings("serial")

特别注意！  新版本 Springboot 3.X 使用 mybatis-plus-spring-boot3-starter 依赖启动  2.X 依赖保持不变。

Spring Boot 3.X 依赖

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
  <version>3.5.4</version>
</dependency>

Spring Boot 2.X 依赖 

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
  <version>3.5.4</version>
</dependency>

• 新增自增主键字段是否允许插入控制,可使用方法注入覆盖Insert(boolean ignoreAutoIncrementColumn)或Insert(String name, boolean ignoreAutoIncrementColumn)控制自增主键是否支持写入行为.

• 内置泛型提取,支持非Spring体系项目使用.

• BaseMapper新增update(wrapper)更新方法.

• BaseMapper新增流式查询方法对大数据查询支持.

  void selectBatchIds(@Param(Constants.COLL) Collection<? extends Serializable> idList, ResultHandler<T> resultHandler);
  
  void selectByMap(Map<String, Object> columnMap, ResultHandler<T> resultHandler);
  
  void selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper, ResultHandler<T> resultHandler);
  
  void selectList(IPage<T> page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper, ResultHandler<T> resultHandler);
  
  void selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper, ResultHandler<Map<String, Object>> resultHandler);
  
  void selectMaps(IPage<? extends Map<String, Object>> page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper, ResultHandler<Map<String, Object>> resultHandler);
  
  void selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper, ResultHandler<E> resultHandler);
  
  //使用示例
  
  baseMapper.selectList(page, Wrappers.emptyWrapper(), resultContext -> System.out.println(resultContext.getResultObject()));
  
  

• 新增批量操作处理方法

  MybatisBatch.Method<H2User> mapperMethod = new MybatisBatch.Method<>(H2UserMapper.class);
  
  List<BatchResult> batchResults = MybatisBatchUtils.execute(sqlSessionFactory, h2UserList, mapperMethod.insert());
  
  

• 代码生成器元数据信息公开tableName与columnName字段访问.

• 新增mybatis-plus-spring-boot3-starter与mybatis-plus-spring-boot3-starter-test支持SpringBoot3.

• 支持插件缺省注入,当无MybatisPlusInterceptor注入时,支持com.baomidou.mybatisplus.extension.plugins.inner.InnerInterceptor自动注入.

• 升级源码Jdk开发版本至Java21.

• 升级gradle-wrapper至8.4-rc-1.

• 升级kotlin-gradle-plugin至1.9.20-Beta.

• 升级SpringBoot2.x版本至2.7.15.

• 升级lombok至1.18.30.

优化

• mybatis-plus-extension中mybatis-spring依赖修改为可选依赖

• spring-boot-starter减少无用的配置提示

• 字段填充处理器提取去除固定参数提取,支持更宽松的mapper方法参数提取填充处理

  void testMyMethod1(@Param("coll") List<User> userList);
  
  void testMyMethod2(@Param("list") List<User> userList);
  
  void testMyMethod3(@Param("collection") List<User> userList);
  
  void testMyMethod4(List<User> userList);
  
  // 新版本开始支持,还可以有多参数.
  
  void testMyMethod5(@Param("userList") List<User> userList);
  
  

• 去除com.baomidou.mybatisplus.core.toolkit.ReflectionKit.setAccessible方法调用,防止高版本Jdk移除

• 调整selectOne方法(配合流式处理,最多提取两行数据,日志不再打印总记录数).

• 优化selectObjs方法返回值,减少类型强制转换.

• ActiveRecord模式下deleteById(逻辑删除)方法支持自动填充功能.

修复

• 修复Insert无字段时执行SQL报错.

• 修复高版本JDK下lambda无法执行IDEA调试.

• 修复LambdaQuery中select,groupBy,orderBy,orderByAsc,orderByDesc提示的警告,新增对应doXxx方法支持重写.

• 修复inject-sql-session-on-mapper-scan无配置提示.

• 修复@OrderBy搭配@TableId排序字段错误.

• 修复Service中根据主键逻辑删除时类型不匹配导致的错误.

• 修复分页插件Count与自定义ResultHandler冲突.

• 修复字段填充处理器可能会出现重入问题