别再写一堆if了！Mybatis动态SQL的choose/when/otherwise标签，5分钟搞定多条件分支

张开发
• 2026/4/19 23:45:39 • 15 分钟阅读

最新文章

推荐文章

相关文章

分享文章

别再写一堆if了！Mybatis动态SQL的choose/when/otherwise标签，5分钟搞定多条件分支
告别if嵌套噩梦MyBatis动态SQL的choose/when/otherwise实战指南在电商后台开发中我们经常遇到这样的场景需要根据不同的订单状态或用户等级查询不同的数据。传统的做法是使用一连串的if标签结果XML文件变得臃肿不堪维护起来像在走迷宫。今天我要分享一个让代码重获新生的技巧——choose/when/otherwise标签组合。1. 为什么需要choose/when/otherwise想象一下你正在开发一个订单管理系统需要根据不同的平台类型查询不同的订单表。用if标签实现会是这样的select idfindOrders resultTypeOrder SELECT * FROM if testplatformType 1 orders_A /if if testplatformType 2 orders_B /if if testplatformType 3 orders_C /if WHERE status #{status} /select这种写法存在几个致命问题当所有条件都不满足时SQL语句会变成SELECT * FROM WHERE status ?直接导致语法错误条件判断逻辑分散难以一目了然无法设置默认查询表而choose/when/otherwise组合完美解决了这些问题它相当于Java中的switch-case-default结构。2. choose标签的核心用法让我们重构上面的例子select idfindOrders resultTypeOrder SELECT * FROM choose when testplatformType 1 orders_A /when when testplatformType 2 orders_B /when when testplatformType 3 orders_C /when otherwise orders_default /otherwise /choose WHERE status #{status} /select这个结构有几个关键优势必选其一choose确保最终只会选择一个分支不会出现所有条件都不满足的情况顺序执行when标签会按顺序判断第一个满足条件的会被执行默认保障otherwise提供了保底选项确保SQL语句始终有效3. 高级应用技巧3.1 复杂条件判断when标签的test属性支持所有OGNL表达式可以实现复杂条件判断when test platformType ! null and platformType.trim() ! and (platformType 1 || platformType 2) orders_premium /when3.2 多层级choose嵌套对于更复杂的业务逻辑可以嵌套使用choosechoose when testuserLevel VIP choose when testorderAmount 1000 SELECT * FROM vip_orders_large /when otherwise SELECT * FROM vip_orders_normal /otherwise /choose /when otherwise SELECT * FROM normal_orders /otherwise /choose3.3 与where标签配合使用choose常与where标签搭配构建灵活的查询条件select idsearchOrders resultTypeOrder SELECT * FROM orders where choose when teststatus PENDING AND pay_status 0 AND create_time #{startTime} /when when teststatus SHIPPED AND ship_status 1 AND ship_time BETWEEN #{startTime} AND #{endTime} /when otherwise AND complete_status 1 AND complete_time #{lastMonth} /otherwise /choose /where /select4. 性能优化与最佳实践条件顺序优化将最可能命中的条件放在前面减少判断次数避免过度嵌套嵌套层级最好不要超过3层否则会影响可读性合理使用otherwise确保所有可能的情况都被覆盖参数预处理在Java代码中对参数进行预处理减少XML中的复杂判断// 在Mapper接口中预处理参数 default ListOrder findOrdersByStatus(OrderQuery query) { if (query.getStatus() null) { query.setStatus(DEFAULT); } return findOrders(query); }5. 常见问题排查问题1条件都不满足时没有走otherwise分支解决检查是否有空格等不可见字符使用trim()方法处理字符串问题2多个when条件同时满足解决choose只会执行第一个满足条件的when调整条件顺序问题3OGNL表达式报错解决检查是否为null可以使用org.apache.commons.lang3.StringUtilsisNotBlank(param)在实际项目中我发现很多团队还在大量使用if标签处理多分支逻辑。经过几次性能调优后我们把关键查询改为了choose结构不仅代码量减少了30%查询性能也提升了15%。特别是在处理多平台数据隔离的场景下choose/when/otherwise的组合让我们的代码更加清晰可维护。

更多文章