MyBatis系统学习（三）——动态SQL-CFANZ编程社区

MyBatis 是一款优秀的持久层框架，它通过 XML 或注解方式将 SQL 语句与 Java 对象映射起来。动态 SQL 是 MyBatis 中非常强大的功能之一，能够根据不同的条件动态生成 SQL 语句。动态 SQL 通过各种标签来灵活生成 SQL，从而避免了在代码中拼接 SQL 的复杂性和冗余性。接下来，我们会详细讲解 MyBatis 中动态 SQL 的相关知识点，涵盖动态 SQL 的元素、条件查询、更新操作及复杂查询操作。

一、MyBatis 动态 SQL 标签

动态 SQL 主要通过 MyBatis 提供的一些 XML 元素来实现，这些元素会根据传递的参数、条件等动态拼装 SQL。主要的动态 SQL 元素有：

<if> 标签

用于判断条件，只有当条件成立时，才会生成相应的 SQL 片段。
语法：
```
<if test="条件">
   SQL 语句
</if>
```

示例：

<select id="findUser" parameterType="int" resultType="User">
  SELECT * FROM user
  WHERE 1=1
  <if test="id != null">
    AND id = #{id}
  </if>
</select>

上述 SQL 语句中，只有当 id 不为 null 时，才会拼接 AND id = #{id} 这部分 SQL。

<choose>, <when>, <otherwise> 标签

类似于 Java 中的 switch-case 语法，用于多条件选择。<choose> 标签包含若干 <when>，如果多个 <when> 条件都不满足，可以用 <otherwise> 作为默认的条件。

语法：

<choose>
  <when test="条件1">
    SQL 语句1
  </when>
  <when test="条件2">
    SQL 语句2
  </when>
  <otherwise>
    默认 SQL 语句
  </otherwise>
</choose>

示例：

<select id="findUser" parameterType="map" resultType="User">
  SELECT * FROM user
  <where>
    <choose>
      <when test="name != null">
        name = #{name}
      </when>
      <when test="age != null">
        age = #{age}
      </when>
      <otherwise>
        status = 'active'
      </otherwise>
    </choose>
  </where>
</select>

<where> 标签

用来自动处理 WHERE 子句前缀问题。<where> 会智能地在第一个条件前添加 WHERE，并自动去掉多余的 AND 或 OR。

示例：

<select id="findUser" parameterType="map" resultType="User">
  SELECT * FROM user
  <where>
    <if test="name != null">
      AND name = #{name}
    </if>
    <if test="age != null">
      AND age = #{age}
    </if>
  </where>
</select>

这里，如果 name 和 age 都为空，<where> 标签会避免生成无效的 WHERE 子句。

<set> 标签

在更新操作中常用，类似于 <where>，<set> 也会自动处理 SET 关键字前后的逗号问题。

示例：

<update id="updateUser" parameterType="User">
  UPDATE user
  <set>
    <if test="name != null">
      name = #{name},
    </if>
    <if test="age != null">
      age = #{age},
    </if>
  </set>
  WHERE id = #{id}
</update>

在生成 SQL 时，<set> 标签会自动处理最后一项的逗号。

<trim> 标签

trim 标签用于自定义去掉前后多余的字符，替代 where 和 set 标签。它有四个重要的属性：
- prefix: SQL 片段的前缀，如 WHERE 或 SET。
- prefixOverrides: 需要去掉的前缀，如 AND、OR。
- suffix: SQL 片段的后缀。
- suffixOverrides: 需要去掉的后缀，如 ,。

示例：

<select id="findUser" parameterType="map" resultType="User">
  SELECT * FROM user
  <trim prefix="WHERE" prefixOverrides="AND">
    <if test="name != null">
      AND name = #{name}
    </if>
    <if test="age != null">
      AND age = #{age}
    </if>
  </trim>
</select>

<foreach> 标签
- 用于处理集合类型的参数，比如 List 或 数组，通常用于 IN 查询或批量插入操作。
- 重要属性：
  - collection: 要遍历的集合，通常是 List 或 Array。
  - item: 当前集合元素的别名。
  - separator: 元素之间的分隔符，如 ,。
  - open 和 close: 分别表示 SQL 片段的开头和结尾字符。
- 示例：
```
<select id="findUserByIds" parameterType="list" resultType="User">
  SELECT * FROM user
  WHERE id IN
  <foreach collection="list" item="id" open="(" separator="," close=")">
    #{id}
  </foreach>
</select>
```

二、条件查询的使用

在实际开发中，条件查询是非常常见的需求。MyBatis 中利用动态 SQL 能够灵活生成条件查询语句，通常使用 <if> 标签来控制条件的生成。

示例：简单条件查询

<select id="findUserByCondition" parameterType="User" resultType="User">
  SELECT * FROM user
  <where>
    <if test="name != null">
      AND name = #{name}
    </if>
    <if test="age != null">
      AND age = #{age}
    </if>
  </where>
</select>

在上面的例子中，只有当 name 或 age 不为空时，才会生成对应的条件。这样可以避免生成无效的 SQL，提升查询效率。

示例：多条件选择查询

<select id="findUserByCondition" parameterType="User" resultType="User">
  SELECT * FROM user
  <where>
    <choose>
      <when test="name != null">
        name = #{name}
      </when>
      <when test="age != null">
        age = #{age}
      </when>
      <otherwise>
        status = 'active'
      </otherwise>
    </choose>
  </where>
</select>

这个例子中，choose 标签确保只有一个条件成立时才会生成对应的 SQL。如果多个条件不成立，则使用 otherwise 语句。

三、动态更新操作

动态 SQL 在更新操作中也非常有用。通常，我们在更新时会根据实际情况只更新某些字段，而不是全部字段。MyBatis 提供了 <set> 标签来方便地生成动态更新语句。

示例：动态更新用户信息

<update id="updateUser" parameterType="User">
  UPDATE user
  <set>
    <if test="name != null">
      name = #{name},
    </if>
    <if test="age != null">
      age = #{age},
    </if>
    <if test="email != null">
      email = #{email},
    </if>
  </set>
  WHERE id = #{id}
</update>

在这个例子中，只有不为空的字段才会被更新，<set> 标签确保了 SQL 语句中不会出现多余的逗号。

四、复杂查询操作

在复杂查询中，动态 SQL 的优势更为明显。我们可以根据多种条件动态生成查询语句，并使用 join、子查询等进行复杂操作。

示例：动态查询用户及其订单

<select id="findUserWithOrders" resultMap="userOrderMap">
  SELECT u.*, o.*
  FROM user u
  LEFT JOIN orders o ON u.id = o.user_id
  <where>
    <if test="u.name != null">
      u.name = #{u.name}
    </if>
    <if test="o.status != null">
      AND o.status = #{o.status}
    </if>
  </where>
</select>

这个查询会根据用户信息和订单状态动态生成 SQL，可以方便地查询用户及其订单。

五、总结

MyBatis 的动态 SQL 为开发者提供了灵活、可扩展的 SQL 生成方式。通过使用 <if>、<choose>、<where>、<set>、<foreach> 等标签，能够根据条件动态生成 SQL，简化了代码，避免了 SQL 拼接的复杂性和冗余性。

动态 SQL 的优势在于：

简化 SQL 编写：开发者可以通过 XML 或注解方式编写复杂的 SQL 逻辑。
提升代码可读性：通过清晰的条件控制和 SQL 生成逻辑，代码更加清晰。
减少代码冗余：避免了在 Java 代码中拼接 SQL 字符串的繁琐操作。

掌握动态 SQL 的使用对于 MyBatis 框架的实际应用非常重要，在复杂的业务逻辑中尤为常见。