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

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

news 2026/4/20 0:01:21

告别if嵌套噩梦：MyBatis动态SQL的choose/when/otherwise实战指南

在电商后台开发中，我们经常遇到这样的场景：需要根据不同的订单状态或用户等级查询不同的数据。传统的做法是使用一连串的if标签，结果XML文件变得臃肿不堪，维护起来像在走迷宫。今天，我要分享一个让代码重获新生的技巧——choose/when/otherwise标签组合。

1. 为什么需要choose/when/otherwise？

想象一下，你正在开发一个订单管理系统，需要根据不同的平台类型查询不同的订单表。用if标签实现会是这样的：

<select id="findOrders" resultType="Order"> SELECT * FROM <if test="platformType == 1"> orders_A </if> <if test="platformType == 2"> orders_B </if> <if test="platformType == 3"> orders_C </if> WHERE status = #{status} </select>

这种写法存在几个致命问题：

当所有条件都不满足时，SQL语句会变成SELECT * FROM WHERE status = ?，直接导致语法错误
条件判断逻辑分散，难以一目了然
无法设置默认查询表

而choose/when/otherwise组合完美解决了这些问题，它相当于Java中的switch-case-default结构。

2. choose标签的核心用法

让我们重构上面的例子：

<select id="findOrders" resultType="Order"> SELECT * FROM <choose> <when test="platformType == 1"> orders_A </when> <when test="platformType == 2"> orders_B </when> <when test="platformType == 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 </when>

3.2 多层级choose嵌套

对于更复杂的业务逻辑，可以嵌套使用choose：

<choose> <when test="userLevel == 'VIP'"> <choose> <when test="orderAmount > 1000"> SELECT * FROM vip_orders_large </when> <otherwise> SELECT * FROM vip_orders_normal </otherwise> </choose> </when> <otherwise> SELECT * FROM normal_orders </otherwise> </choose>

3.3 与where标签配合使用

choose常与where标签搭配，构建灵活的查询条件：

<select id="searchOrders" resultType="Order"> SELECT * FROM orders <where> <choose> <when test="status == 'PENDING'"> AND pay_status = 0 AND create_time > #{startTime} </when> <when test="status == '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> </select>

4. 性能优化与最佳实践

条件顺序优化：将最可能命中的条件放在前面，减少判断次数
避免过度嵌套：嵌套层级最好不要超过3层，否则会影响可读性
合理使用otherwise：确保所有可能的情况都被覆盖
参数预处理：在Java代码中对参数进行预处理，减少XML中的复杂判断

// 在Mapper接口中预处理参数 default List<Order> findOrdersByStatus(OrderQuery query) { if (query.getStatus() == null) { query.setStatus("DEFAULT"); } return findOrders(query); }