MyBatis 动态 SQL 是 MyBatis 框架中的一个重要特性，它允许开发者根据条件动态地生成不同的 SQL 语句。通过使用动态 SQL，开发者可以根据传入的参数动态地构建 SQL 查询，这样就避免了写多个 SQL 语句，提升了代码的灵活性和可维护性。
1. 动态 SQL 的概念
动态 SQL 指的是 SQL 语句在运行时（而非编译时）根据传入的参数来动态决定 SQL 语句的内容。通过 MyBatis 提供的 <if>, <choose>, <foreach>, <where> 等标签，开发者可以根据不同的条件动态地生成 SQL 语句。
2. MyBatis 动态 SQL 的执行原理
MyBatis 在执行动态 SQL 时，主要的工作流程如下：
-
SQL 映射文件解析：
- MyBatis 的映射文件（如
mapper.xml）中定义了动态 SQL 语句，这些 SQL 语句通常包含一些动态元素（例如<if>、<choose>、<foreach>等）。 - 当执行某个映射方法时，MyBatis 会首先加载并解析对应的映射文件（
mapper.xml）中的 SQL 语句。此时，SQL 语句中的动态部分并不会立即生成，只有当方法被调用时，MyBatis 会根据传入的参数来生成最终的 SQL 语句。
- MyBatis 的映射文件（如
-
构建 SQL 语句：
- MyBatis 会将 SQL 语句中的动态部分替换为实际的 SQL 语句。例如：
<if>标签根据条件来决定是否包含某部分 SQL。<choose>标签类似于 Java 中的if-else，选择不同的 SQL 片段。<foreach>标签用于循环生成多个 SQL 片段，通常用于处理集合或数组。
- MyBatis 会通过解析
parameterType参数（例如，Map或 POJO 对象）来判断条件和动态内容。
- MyBatis 会将 SQL 语句中的动态部分替换为实际的 SQL 语句。例如：
-
SQL 语句生成：
- 动态部分通过 MyBatis 内部的
SQL构建器生成最终的 SQL 语句。MyBatis 会使用 Java 的OGNL（Object-Graph Navigation Language）表达式来获取参数的属性值，决定哪些 SQL 片段应该被包括在内。
- 动态部分通过 MyBatis 内部的
-
SQL 语句执行：
- 生成完整的 SQL 语句后，MyBatis 会交给数据库执行。
- 这个 SQL 语句会根据数据库的返回结果进行映射，最终返回给应用程序。
-
返回结果：
- 执行 SQL 后，MyBatis 会根据 SQL 查询结果和映射文件中的映射规则，将查询结果封装为 Java 对象并返回。
3. MyBatis 动态 SQL 的常用标签
MyBatis 提供了丰富的标签来实现动态 SQL，以下是几个常用的标签及其作用：
(1) <if>
-
作用：根据条件判断是否包括某部分 SQL 语句。
-
用法：当条件为
true时，包含该部分 SQL，否则跳过。<select id="findUser" resultType="User"> SELECT * FROM user WHERE 1 = 1 <if test="name != null"> AND name = #{name} </if> <if test="age != null"> AND age = #{age} </if> </select>这段代码中，只有在
name和age不为null时，对应的 SQL 部分才会被加入。
(2) <choose>, <when>, <otherwise>
-
作用：类似于 Java 中的
if-else语句，根据不同的条件选择 SQL 片段。<select id="findUser" resultType="User"> SELECT * FROM user WHERE 1 = 1 <choose> <when test="name != null"> AND name = #{name} </when> <when test="age != null"> AND age = #{age} </when> <otherwise> AND status = 'ACTIVE' </otherwise> </choose> </select>如果
name不为null，会选择第一个<when>语句，否则会选择第二个<when>语句，如果都不满足条件，则执行<otherwise>语句。
(3) <foreach>
-
作用：用于处理集合（如列表、数组）类型的参数，生成 SQL 语句中相应的重复部分。
<select id="findUsersByIds" resultType="User"> SELECT * FROM user WHERE id IN <foreach item="id" collection="list" open="(" close=")" separator=","> #{id} </foreach> </select>这个 SQL 会将传入的
list集合的每个元素都作为id值生成IN条件。
(4) <where>
-
作用：用于自动为 SQL 添加
WHERE关键字，并且处理 SQL 中的多余AND或OR。<select id="findUser" resultType="User"> <where> <if test="name != null">AND name = #{name}</if> <if test="age != null">AND age = #{age}</if> </where> </select>使用
<where>后，MyBatis 会自动处理AND或OR，避免 SQL 开头出现多余的AND或OR。
(5) <set>
-
作用：用于更新 SQL 语句中的
SET子句，自动处理逗号的添加与删除。<update id="updateUser"> UPDATE user <set> <if test="name != null">name = #{name},</if> <if test="age != null">age = #{age},</if> </set> WHERE id = #{id} </update>使用
<set>标签后，MyBatis 会自动处理SET子句中的逗号问题。
4. MyBatis 动态 SQL 的执行过程
- SQL 语句生成：通过动态 SQL 标签（
<if>,<foreach>,<choose>,<where>等）构建最终的 SQL 语句。 - 传入参数：在执行查询时，MyBatis 会传入相应的参数，执行动态 SQL 时根据参数判断条件。
- 执行 SQL：生成最终的 SQL 后，MyBatis 会将其交给底层的数据库执行。
- 结果映射：执行结果会返回并映射为 Java 对象。
5. 总结
MyBatis 的动态 SQL 提供了强大的功能，使得开发者能够灵活地生成复杂的 SQL 查询。通过使用 <if>, <foreach>, <choose>, <set> 等标签，MyBatis 可以根据参数动态生成 SQL 语句，避免了写多个 SQL 的繁琐工作。理解 MyBatis 动态 SQL 的执行原理可以帮助你编写更灵活且高效的数据库操作代码。
