MyBatis 动态 SQL 详解

1. 什么是动态 SQL？

在使用 MyBatis 进行数据库查询时，可能会遇到一些需要根据条件动态生成 SQL 语句的情况。MyBatis 提供了强大的动态 SQL 支持，通过标签和条件语句，可以让 SQL 语句根据不同的输入参数动态生成。这大大提高了代码的灵活性，避免了拼接 SQL 语句的繁琐和出错风险。

2. 动态 SQL 的常见场景

1. 条件查询：根据不同的参数执行不同的查询条件。
2. 批量插入或更新：动态生成多个插入或更新语句。
3. 分页查询：根据分页参数动态限制查询范围。
4. 可选查询条件：根据用户输入，动态生成 SQL。

---

3. 动态 SQL 的常用标签

MyBatis 提供了一些标签来支持动态 SQL，包括：

1. <if>：判断条件，生成部分 SQL。
2. <choose>：类似于 switch 语句，在多个条件之间选择。
3. <where>：自动添加 WHERE，并处理多余的 AND 或 OR。
4. <trim>：在 SQL 前后添加或去除多余的字符（如逗号、AND）。
5. <foreach>：用于循环遍历集合，生成动态 SQL。
6. <set>：在更新语句中处理动态的 SET 字段。

---

4. 常见动态 SQL 用法示例

4.1 使用 <if> 标签

假设我们有一个查询用户的需求，根据不同的查询条件（username 和 age）来生成查询 SQL：

Mapper XML 文件：

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

生成 SQL 示例：

• 当传入 username="Alice" 时：

  SELECT * FROM users WHERE username = 'Alice';

• 当传入 username="Alice", age=25 时：

  SELECT * FROM users WHERE username = 'Alice' AND age = 25;

---

4.2 使用 <choose> 标签

<choose> 标签类似于 Java 中的 switch，可以根据条件选择执行某段 SQL。

<select id="selectUserByStatus" parameterType="map" resultType="User">
    SELECT * FROM users
    <where>
        <choose>
            <when test="status == 'active'">
                status = 'active'
            </when>
            <when test="status == 'inactive'">
                status = 'inactive'
            </when>
            <otherwise>
                1 = 1
            </otherwise>
        </choose>
    </where>
</select>

SQL 示例：

• 当 status='active' 时：

  SELECT * FROM users WHERE status = 'active';

• 当没有传入 status 时：

  SELECT * FROM users WHERE 1 = 1;

---

4.3 使用 <foreach> 标签

<foreach> 常用于处理集合类型参数，比如批量插入或查询。

<select id="selectUsersByIds" parameterType="list" resultType="User">
    SELECT * FROM users WHERE id IN
    <foreach item="id" index="index" collection="list" open="(" separator="," close=")">
        #{id}
    </foreach>
</select>

Java 调用：

List<Integer> ids = Arrays.asList(1, 2, 3);
userMapper.selectUsersByIds(ids);

生成 SQL：

SELECT * FROM users WHERE id IN (1, 2, 3);

---

4.4 使用 <where> 标签

<where> 会自动处理 SQL 中多余的 AND 或 OR，避免语法错误。

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

• 当只传入 age=25 时：

  SELECT * FROM users WHERE age = 25;

---

4.5 使用 <set> 标签

在更新语句中，如果只有部分字段需要更新，使用 <set> 标签可以避免多余的逗号。

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

SQL 示例：

• 当传入 username="Alice" 和 status="active" 时：

  UPDATE users SET username = 'Alice', status = 'active' WHERE id = ?;

---

5. 动态 SQL 的最佳实践

1. 合理使用动态标签：不要将过多逻辑放在 XML 文件中，复杂逻辑可以放在 Java 代码中处理。
2. 避免 SQL 注入 ：使用 MyBatis 提供的参数占位符（#{}）来避免拼接 SQL。
3. 适当分解 SQL 语句：对于复杂的 SQL，可以拆分成多个小查询，减少 XML 文件的复杂度。
4. 使用日志调试 SQL：开启 MyBatis 的日志功能，查看生成的 SQL 是否符合预期。

---

6. 结论

MyBatis 动态 SQL 提供了非常强大的功能，可以根据不同的业务需求生成灵活的 SQL 语句。通过 <if>、<choose>、<foreach> 等标签，我们可以在 XML 中轻松实现复杂的查询逻辑。在使用过程中，我们需要注意 SQL 的可读性和维护性，避免过多复杂逻辑堆积在 XML 文件中。

掌握 MyBatis 的动态 SQL，可以让你的代码更具弹性，适应不同的业务场景。希望这篇文章能帮助你更好地理解和使用 MyBatis 的动态 SQL 功能。

希望你喜欢这篇关于JMyBatis 动态 SQL 详解的博客文章！请各位点赞和收藏加关注一键三连吧。祝三连的帅哥美女们今年都能暴富。如果有更多问题，欢迎随时提问。