异常教程
mybatis choose（长文讲解）
💡一则或许对你有用的小广告
欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论
- 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于
Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;- 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;
截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观
在现代软件开发中，数据库操作是应用程序的核心功能之一。MyBatis 作为 Java 领域广泛使用的持久层框架，因其灵活的 SQL 写法和与对象的映射能力，成为许多开发者的首选工具。然而，随着业务逻辑的复杂化，如何动态生成 SQL 语句成为开发者需要解决的关键问题。本文将聚焦于 MyBatis Choose 标签，通过深入浅出的讲解和实际案例，帮助读者掌握这一功能，提升动态 SQL 编写能力。
一、动态 SQL 的核心挑战
在传统开发中，若需根据不同的业务条件生成 SQL 语句，通常需要编写多个查询方法，例如：
public List<User> findByName(String name);
public List<User> findByAge(int age);
public List<User> findByNameAndAge(String name, int age);
这种方法不仅代码冗余，还难以应对参数组合爆炸的问题。动态 SQL 的出现，正是为了解决这一痛点，而 MyBatis Choose 标签则是动态 SQL 的重要组成部分。
二、MyBatis Choose 标签基础语法
1. 标签结构与功能
Choose 标签的作用类似于 Java 中的 switch-case 语句，用于在多个条件中选择一个或多个分支执行。其语法结构如下：
<choose>
<when test="condition1">分支1的SQL片段</when>
<when test="condition2">分支2的SQL片段</when>
<otherwise>默认分支的SQL片段</otherwise>
</choose>
- when：定义条件判断，满足时执行对应的 SQL 片段。
- otherwise：可选标签，当所有 when 条件均不满足时触发。
比喻：可以想象 Choose 标签如同一个交通信号灯控制器，根据不同的条件（红灯、绿灯）选择车辆的通行方向，而 otherwise 则是当所有条件都不满足时的备用方案。
2. 第一个简单案例
假设我们需要根据用户输入的姓名或年龄查询用户信息：
<select id="findUser" resultType="User">
SELECT * FROM users
WHERE 1=1
<choose>
<when test="name != null">
AND name = #{name}
</when>
<when test="age != null">
AND age = #{age}
</when>
<otherwise>
-- 默认条件，如查询全部用户
</otherwise>
</choose>
</select>
此例中，若 name 和 age 均为 null，则触发 otherwise 分支，执行默认 SQL。
三、Choose 标签的进阶用法
1. 多条件组合与嵌套
Choose 标签可以与其他动态 SQL 标签（如 if、trim）结合使用，实现更复杂的逻辑。例如：
<select id="advancedSearch" resultType="Product">
SELECT * FROM products
<where>
<choose>
<when test="category != null">
category = #{category}
<if test="price != null">
AND price > #{price}
</if>
</when>
<otherwise>
-- 其他条件
</otherwise>
</choose>
</where>
</select>
此案例中，当 category 存在时，会进一步检查 price 是否存在，从而组合多个条件。
2. 条件优先级控制
通过调整 when 标签的顺序，可以控制条件的优先级。例如：
<choose>
<when test="isSuperUser">
-- 管理员权限的查询
</when>
<when test="roleId != null">
-- 普通角色权限的查询
</when>
<otherwise>
-- 默认权限的查询
</otherwise>
</choose>
此处，若 isSuperUser 为真，直接执行第一个分支，而无需再检查 roleId。
四、实际案例：用户注册信息查询
1. 场景描述
假设我们需要根据用户输入的 邮箱、手机号 或 用户名 查询用户是否存在。若多个条件同时存在，则以 邮箱 > 手机号 > 用户名 的优先级匹配。
2. 实现代码
<select id="checkUserExist" resultType="boolean">
SELECT EXISTS (
SELECT 1 FROM users
<where>
<choose>
<when test="email != null and email != ''">
email = #{email}
</when>
<when test="phone != null and phone != ''">
phone = #{phone}
</when>
<when test="username != null and username != ''">
username = #{username}
</when>
<otherwise>
-- 默认条件，如返回 false
</otherwise>
</choose>
</where>
)
</select>
说明：
- 通过 choose 标签优先匹配邮箱，若邮箱未提供则检查手机号，最后检查用户名。
- 使用 test 属性确保参数非空且非空字符串，避免 SQL 注入风险。
五、常见问题与解决方案
1. 条件未生效：参数传递问题
现象：条件始终不满足，导致分支未触发。
原因：参数名与实体类属性不一致，或未正确传递参数。
解决方案：
- 检查 Mapper 接口方法参数是否与 XML 中的参数变量名匹配。
- 使用 @Param 注解明确参数名称：
public interface UserMapper { boolean checkUserExist(@Param("email") String email, @Param("phone") String phone, @Param("username") String username); }
2. SQL 语法错误：分支嵌套不当
现象：生成的 SQL 语句缺少 AND 或 OR 连接符。
解决方案：
- 使用 trim 标签控制连接符：
<trim prefix="AND" prefixOverrides="AND "> <choose> <when test="...">条件1</when> <when test="...">条件2</when> </choose> </trim>
六、性能与最佳实践
1. 避免过度使用 Choose 标签
虽然 Choose 提供了灵活性，但过多的分支可能导致 SQL 语句复杂度增加，影响可读性和维护性。建议：
- 对高频查询场景优先使用独立 SQL。
- 复杂逻辑可通过 if 标签组合实现。
2. 日志与调试
启用 MyBatis 的 SQL 日志功能（如通过 log4j 配置），实时查看生成的 SQL 语句，确保动态条件正确触发。
结论
MyBatis Choose 标签是动态 SQL 的核心工具之一，它通过条件分支的灵活组合，显著减少了重复代码，提升了开发效率。本文通过基础语法、进阶用法、实际案例和常见问题的讲解，帮助读者掌握这一功能的使用场景和技巧。掌握 Choose 标签后，开发者可以更从容地应对复杂的查询需求，为构建高效、可维护的系统打下坚实基础。
提示：在项目中合理使用 Choose 标签时，建议结合单元测试验证不同条件分支的逻辑，确保 SQL 生成的准确性和系统稳定性。