MyBatis 动态更新字段使用 IF 语句指南

在 MyBatis 中，你可以使用 <if> 标签来实现动态更新部分字段的功能，这在只更新有变化的字段时非常有用。

基本语法

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

关键点说明

1. <set> 标签：会自动处理 SQL 语句中的逗号，避免在最后一个条件后出现多余的逗号。

2. <if> 标签：test 属性中的表达式为 true 时，该语句会被包含在 SQL 中。

3. 参数判断：可以判断参数是否为 null 或空字符串等。

更复杂的条件判断

<update id="updateUserSelective" parameterType="User">
    UPDATE user
    <set>
        <if test="username != null and username != ''">username = #{username},</if>
        <if test="password != null and password.length() > 6">password = #{password},</if>
        <if test="email != null and email.contains('@')">email = #{email},</if>
        <if test="phone != null and phone.matches('^1[3-9]\\d{9}$')">phone = #{phone}</if>
    </set>
    WHERE id = #{id}
</update>

使用 OGNL 表达式

MyBatis 使用 OGNL 表达式进行条件判断，支持以下操作：

• 关系运算符：==, !=, <, <=, >, >=
• 逻辑运算符：and, or, not 或 &&, ||, !
• 字符串方法：contains, indexOf, length, matches 等

批量更新示例

<update id="batchUpdate" parameterType="java.util.List">
    <foreach collection="list" item="item" index="index" separator=";">
        UPDATE user
        <set>
            <if test="item.username != null">username = #{item.username},</if>
            <if test="item.email != null">email = #{item.email}</if>
        </set>
        WHERE id = #{item.id}
    </foreach>
</update>

最佳实践

1. 总是包含一个不变的 WHERE 条件（通常是主键）
2. 考虑使用 <trim> 替代 <set> 以获得更多控制
3. 对于复杂的业务逻辑，可以在 Java 代码中构建更新对象

注意事项

• 确保数据库字段和 Java 对象属性名称匹配
• 注意 SQL 注入风险，始终使用参数化查询
• 对于大量字段更新，考虑使用专门的动态 SQL 构建工具

通过这种方式，你可以灵活地只更新那些真正需要更新的字段，提高数据库操作效率。