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

MyBatis系统学习（三）——动态SQL

news 2026/1/28 10:51:08

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 userWHERE 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 userWHERE 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 uLEFT 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 框架的实际应用非常重要，在复杂的业务逻辑中尤为常见。