专栏名称: 芋道源码
纯 Java 源码分享公众号,目前有「Dubbo」「SpringCloud」「Java 并发」「RocketMQ」「Sharding-JDBC」「MyCAT」「Elastic-Job」「SkyWalking」「Spring」等等
目录
相关文章推荐
芋道源码  ·  既生“/”,何生“\”? ·  2 天前  
芋道源码  ·  为什么官方不推荐使用 @Autowired? ·  2 天前  
芋道源码  ·  疯传Java界,堪称最强! ·  5 天前  
芋道源码  ·  什么情况,后端的薪资又爆了。。。 ·  5 天前  
51好读  ›  专栏  ›  芋道源码

妙用MyBatis-Plus,12个实战技巧解锁新知识

芋道源码  · 公众号  · Java  · 2024-12-21 17:37

正文

👉 这是一个或许对你有用的社群

🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入芋道快速开发平台知识星球。下面是星球提供的部分资料: 

👉这是一个或许对你有用的开源项目

国产 Star 破 10w+ 的开源项目,前端包括管理后台 + 微信小程序,后端支持单体和微服务架构。

功能涵盖 RBAC 权限、SaaS 多租户、数据权限、商城、支付、工作流、大屏报表、微信公众号、CRM 等等功能:

  • Boot 仓库:https://gitee.com/zhijiantianya/ruoyi-vue-pro
  • Cloud 仓库:https://gitee.com/zhijiantianya/yudao-cloud
  • 视频教程:https://doc.iocoder.cn
【国内首批】支持 JDK 21 + SpringBoot 3.2.2、JDK 8 + Spring Boot 2.7.18 双版本 

来源:juejin.cn/post/
7436567167728812044


前言

说起数据库ORM,我忽然想起了小时候外婆做的那锅鲜美的羊肉汤。平常人家做的羊肉汤无非是几块肉、几片姜,味道寡淡得很,喝了和喝白开水差不多。但外婆的汤,那是另一回事儿 —— 一锅汤,香气四溢,肉质软烂,汤头浓郁得能让人连碗都想舔干净。

写代码何尝不是如此?以前写Mybatis,就像是在煮一锅没有灵魂的羊肉汤:原料都在,但就是不够鲜美。代码繁琐,每写一个查询都像是在不断调味,却怎么也调不出那种令人惊艳的味道。直到遇见MyBatisPlus,一切都变了 —— 这就像是从普通的羊肉汤,突然升级到了外婆秘制的顶级羊肉汤!

MyBatisPlus就像一位精通厨艺的帮厨,它帮你处理了所有繁琐的准备工作。想要一个复杂的查询?不用自己一刀一刀地切肉、一勺一勺地调味,框架已经帮你准备好了。你只需要轻轻地指挥,代码就像汤汁一样顺滑流畅,性能更是鲜美可口。

在接下来的篇幅里,我将与你分享12个MyBatisPlus优化的"秘制配方"。相信看完这些,你写的每一行代码,都会像外婆的羊肉汤一样,让人回味无穷。

耐心看完,你一定有所收获。

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

  • 项目地址:https://github.com/YunaiV/ruoyi-vue-pro
  • 视频教程:https://doc.iocoder.cn/video/

避免使用isNull判断

// ❌ 不推荐
LambdaQueryWrapper wrapper1 = new LambdaQueryWrapper<>();
wrapper1.isNull(User::getStatus);

// ✅ 推荐:使用具体的默认值
LambdaQueryWrapper wrapper2 = new LambdaQueryWrapper<>();
wrapper2.eq(User::getStatus, UserStatusEnum.INACTIVE.getCode());

原因:

  • 使用具体的默认值可以提高代码的可读性和维护性
  • NULL值会使索引失效,导致MySQL无法使用索引进行查询优化
  • NULL值的比较需要特殊的处理逻辑,增加了CPU开销
  • NULL值会占用额外的存储空间,影响数据压缩效率

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

  • 项目地址:https://github.com/YunaiV/yudao-cloud
  • 视频教程:https://doc.iocoder.cn/video/

明确Select字段

// ❌ 不推荐
// 默认select 所有字段
List users1 = userMapper.selectList(null);  

// ✅ 推荐:指定需要的字段
LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>();
wrapper.select(User::getId, User::getName, User::getAge);
List users2 = userMapper.selectList(wrapper);

原因:

  • 避免大量无用字段的网络传输开销
  • 可以利用索引覆盖,避免回表查询
  • 减少数据库解析和序列化的负担
  • 降低内存占用,特别是在大量数据查询时

批量操作方法替代循环

// ❌ 不推荐
for (User user : userList) {
    userMapper.insert(user);
}

// ✅ 推荐
userService.saveBatch(userList, 100);  // 每批次处理100条数据

// ✅ 更优写法:自定义批次大小
userService.saveBatch(userList, BatchConstants.BATCH_SIZE);

原因:

  • 减少数据库连接的创建和销毁开销
  • 批量操作可以在一个事务中完成,提高数据一致性
  • 数据库可以优化批量操作的执行计划
  • 显著减少网络往返次数,提升吞吐量

Exists方法子查询

// ❌ 不推荐
wrapper.inSql("user_id""select user_id from order where amount > 1000");

// ✅ 推荐
wrapper.exists("select 1 from order where order.user_id = user.id and amount > 1000");

// ✅ 更优写法:使用LambdaQueryWrapper
wrapper.exists(orderService.lambdaQuery()
    .gt(Order::getAmount, 1000)
    .apply("order.user_id = user.id"));

原因:

  • EXISTS是基于索引的快速查询,可以使用到索引
  • EXISTS在找到第一个匹配项就会停止扫描
  • IN子查询需要加载所有数据到内存后再比较
  • 当外表数据量大时,EXISTS的性能优势更明显

使用orderBy代替last

// ❌ 不推荐:SQL注入风险
wrapper.last("ORDER BY " + sortField + " " + sortOrder);

// ❌ 不推荐:直接字符串拼接
wrapper.last("ORDER BY FIELD(status, 'active', 'pending', 'inactive')");

// ✅ 推荐:使用 Lambda 安全排序
wrapper.orderBy(truetrue, User::getStatus);

// ✅ 推荐:多字段排序示例
wrapper.orderByAsc(User::getStatus)
       .orderByDesc(User::getCreateTime);

原因:

  • 直接拼接SQL容易导致SQL注入攻击
  • 动态SQL可能破坏SQL语义完整性
  • 影响SQL语句的可维护性和可读性
  • last会绕过MyBatis-Plus的安全检查机制

使用LambdaQuery确保类型安全

// ❌ 不推荐:字段变更后可能遗漏
QueryWrapper wrapper1 = new QueryWrapper<>();
wrapper1.eq("name""张三").gt("age"18);

// ✅ 推荐
LambdaQueryWrapper wrapper2 = new LambdaQueryWrapper<>();
wrapper2.eq(User::getName, "张三")
        .gt(User::getAge, 18);

// ✅ 更优写法:使用链式调用
userService.lambdaQuery()
    .eq(User::getName, "张三")
    .gt(User::getAge, 18)
    .list();

原因:

  • 编译期类型检查,避免字段名拼写错误
  • IDE可以提供更好的代码补全支持
  • 重构时能自动更新字段引用
  • 提高代码的可维护性和可读性

用between代替ge和le

// ❌ 不推荐
wrapper.ge(User::getAge, 18)
       .le(User::getAge, 30);

// ✅ 推荐
wrapper.between(User::getAge, 1830);

// ✅ 更优写法:条件动态判断
wrapper.between(ageStart != null && ageEnd != null,
               User::getAge, ageStart, ageEnd);

原因:

  • 生成的SQL更简洁,减少解析开销
  • 数据库优化器可以更好地处理范围查询
  • 代码更易读,语义更清晰
  • 减少重复编写字段名的机会

排序字段注意索引

// ❌ 不推荐
// 假设lastLoginTime无索引
wrapper.orderByDesc(User::getLastLoginTime);  

// ✅ 推荐
// 主键排序
wrapper.orderByDesc(User::getId);  

// ✅ 更优写法:组合索引排序
wrapper.orderByDesc(User::getStatus)  // status建立了索引
       .orderByDesc(User::getId);     // 主键排序

原因:

  • 索引天然具有排序特性,可以避免额外的排序操作
  • 无索引排序会导致文件排序,极大影响性能
  • 当数据量大时,内存排序可能导致溢出
  • 利用索引排序可以实现流式读取

分页参数设置

// ❌ 不推荐
wrapper.last("limit 1000");  // 一次查询过多数据

// ✅ 推荐
Page page = new Page<>(110);
userService.page(page, wrapper);

// ✅ 更优写法:带条件的分页查询
Page result = userService.lambdaQuery()
    .eq(User::getStatus, "active")
    .page(new Page<>(110));

原因:

  • 控制单次查询的数据量,避免内存溢出
  • 提高首屏加载速度,优化用户体验
  • 减少网络传输压力
  • 数据库资源利用更合理

条件构造处理Null值

// ❌ 不推荐
if (StringUtils.isNotBlank(name)) {
    wrapper.eq("name", name);
}
if (age != null) {
    wrapper.eq("age", age);
}

// ✅ 推荐
wrapper.eq(StringUtils.isNotBlank(name), User::getName, name)
       .eq(Objects.nonNull(age), User::getAge, age);

// ✅ 更优写法:结合业务场景
wrapper.eq(StringUtils.isNotBlank(name), User::getName, name)
       .eq(Objects.nonNull(age), User::getAge, age)
       .eq(User::getDeleted, false)  // 默认查询未删除记录
       .orderByDesc(User::getCreateTime);  // 默认按创建时间倒序

原因:

  • 优雅处理空值,避免无效条件
  • 减少代码中的if-else判断
  • 提高代码可读性
  • 防止生成冗余的SQL条件

⚠️ 下面就要来一些高级货了

查询性能追踪

// ❌ 不推荐:简单计时,代码冗余
public List listUsers(QueryWrapper wrapper) {
    long startTime = System.currentTimeMillis();
    List users = userMapper.selectList(wrapper);
    long endTime = System.currentTimeMillis();
    log.info("查询耗时:{}ms", (endTime - startTime));
    return users;
}

// ✅ 推荐:使用 Try-with-resources 自动计时
public List listUsersWithPerfTrack(QueryWrapper wrapper) {
    try (PerfTracker.TimerContext ignored = PerfTracker.start()) {
        return userMapper.selectList(wrapper);
    }
}

// 性能追踪工具类
@Slf4j
public class PerfTracker {
    private final long startTime;
    private final String methodName;

    private PerfTracker(String methodName) {
        this.startTime = System.currentTimeMillis();
        this.methodName = methodName;
    }

    public static TimerContext start() {
        return new TimerContext(Thread.currentThread().getStackTrace()[2].getMethodName());
    }

    public static class TimerContext implements AutoCloseable {
        private final PerfTracker tracker;

        private TimerContext(String methodName) {
            this.tracker = new PerfTracker(methodName);
        }

        @Override
        public void close() {
            long executeTime = System.currentTimeMillis() - tracker.startTime;
            if (executeTime > 500) {
                log.warn("慢查询告警:方法 {} 耗时 {}ms", tracker.methodName, executeTime);
            }
        }
    }
}

原因:

  • 业务代码和性能监控代码完全分离
  • try-with-resources 即使发生异常,close() 方法也会被调用,确保一定会记录耗时
  • 不需要手动管理计时的开始和结束
  • 更优雅

枚举类型映射

// 定义枚举
public enum UserStatusEnum {
    NORMAL(1"正常"),
    DISABLED(0"禁用");

    @EnumValue  // MyBatis-Plus注解
    private final Integer code;
    private final String desc;
}

// ✅ 推荐:自动映射
public class User {
    private UserStatusEnum status;
}

// 查询示例
userMapper.selectList(
    new LambdaQueryWrapper()
        .eq(User::getStatus, UserStatusEnum.NORMAL)
);

原因:

  • 类型安全
  • 自动处理数据库和枚举转换
  • 避免魔法值
  • 代码可读性更强

自动处理逻辑删除

@TableLogic  // 逻辑删除注解
private Integer deleted;

// ✅ 推荐:自动过滤已删除数据
public List getActiveUsers() {
    return userMapper.selectList(null);  // 自动过滤deleted=1的记录
}

// 手动删除
userService.removeById(1L);  // 实际是更新deleted状态

原因:

  • 数据不丢失
  • 查询自动过滤已删除数据
  • 支持数据恢复
  • 减少手动编写删除逻辑

📷 注意:

  • XML中需要手动拼接 deleted = 1

乐观锁更新保护

public class Product {
    @Version  // 乐观锁版本号
    private Integer version;
}

// ✅ 推荐:更新时自动处理版本
public boolean reduceStock(Long productId, Integer count) {
    LambdaUpdateWrapper wrapper = new LambdaUpdateWrapper<>();
    wrapper.eq(Product::getId, productId)
           .ge(Product::getStock, count);
    
    Product product = new Product();
    product.setStock(product.getStock() - count);
    
    return productService.update(product, wrapper);
}

原因:

  • 防止并发冲突
  • 自动处理版本控制
  • 简化并发更新逻辑
  • 提高数据一致性

递增和递减:setIncrBy 和 setDecrBy

// ❌ 不推荐:使用 setSql
userService.lambdaUpdate()
    .setSql("integral = integral + 10")
    .update();

// ✅ 推荐:使用 setIncrBy
userService.lambdaUpdate()
    .eq(User::getId, 1L)
    .setIncrBy(User::getIntegral, 10)
    .update();

// ✅ 推荐:使用 setDecrBy
userService.lambdaUpdate()
    .eq(User::getId, 1L)
    .setDecrBy(User::getStock, 5)
    .update();

原因:

  • 类型安全
  • 避免手动拼接sql,防止sql注入
  • 代码可维护性更强,更清晰

总结

写代码如烹小鲜,讲究的是精细和用心。就像一碗好汤,不仅仅在于锅和火候,更在于厨师对食材的理解和尊重。MyBatisPlus的这12个优化技巧,何尝不是程序员对代码的一种尊重和雕琢?

还记得文章开头说的外婆的羊肉汤吗?优秀的代码,和一碗好汤,都需要用心。每一个细节,每一个调整,都是为了让最终的成果更加完美。MyBatisPlus就像是厨房里的得力助手,它帮你处理繁琐,让你专注于创造。

当你掌握了这些技巧,你的代码将不再是简单的指令堆砌,而是一首优雅的诗,一曲悦耳的交响乐。它们将像外婆的羊肉汤一样,散发着独特的魅力,让人回味无穷。

愿每一位开发者,都能用MyBatisPlus,煮出属于自己的"秘制汤羹"!

代码,就应该是这个样子 —— 简单而不失优雅,高效而不失温度。


欢迎加入我的知识星球,全面提升技术能力。

👉 加入方式,长按”或“扫描”下方二维码噢

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。

文章有帮助的话,在看,转发吧。

谢谢支持哟 (*^__^*)