MyBatis动态if/trim/where/set标签详解

动态SQL是Mybatis的强大特性之一，能够完成不同的sql拼接

官网文档为：

本节是对上一章内容经行的扩充

一、<if>标签

在注册用户时，我们经常会遇到必填字段和非必填字段的情况。例如，性别（gender）可能是一个非必填字段，程序需要根据用户是否填写该字段来动态生成SQL语句。这时就可以使用MyBatis的**<if>**标签来实现条件判断。

1.1 接口定义

java 复制代码

// 根据条件插入用户信息
Integer insertUserByCondition(UserInfo userInfo);

1.2 Mapper.xml实现

xml 复制代码

<insert id="insertUserByCondition">
    INSERT INTO userinfo (
        username,
        `password`,
        age,
        <if test="gender != null">
            gender,
        </if>
        phone
    ) VALUES (
        #{username},
        #{password},
        #{age},
        <if test="gender != null">
            #{gender},
        </if>
        #{phone}
    )
</insert>

1.3 注解方式实现（不推荐）

java 复制代码

@Insert("<script>" +
        "INSERT INTO userinfo (username, `password`, age, " +
        "<if test='gender!=null'>gender,</if> " +
        "phone) " +
        "VALUES(#{username}, #{password}, #{age}, " +
        "<if test='gender!=null'>#{gender},</if> " +
        "#{phone})" +
        "</script>")
Integer insertUserByCondition(UserInfo userInfo);

注意事项：

test属性 ：test="gender != null"中的gender是传入Java对象的属性名，不是数据库字段名。
字段默认值问题：不能简单地将字段设置为null，因为如果数据库字段有默认值，插入null会使用默认值而不是保持为空。
注解方式 ：需要使用<script></script>标签包裹动态SQL，但IDEA不会进行格式检查，容易出错，建议初学者使用XML方式。

二、<trim>标签

当有多个字段都可能成为选填项时，使用多个<if>标签会导致SQL语句末尾出现多余的逗号。这时可以使用**<trim>** 标签结合<if>标签，对多个字段进行动态生成。

2.1 <trim>标签属性

prefix：表示整个语句块，以prefix的值作为前缀
suffix：表示整个语句块，以suffix的值作为后缀
prefixOverrides：表示整个语句块要去除掉的前缀
suffixOverrides：表示整个语句块要去除掉的后缀

2.2 Mapper.xml实现

xml 复制代码

<insert id="insertUserByCondition">
    INSERT INTO userinfo
    <trim prefix="(" suffix=")" suffixOverrides=",">
        <if test="username != null">
            username,
        </if>
        <if test="password != null">
            `password`,
        </if>
        <if test="age != null">
            age,
        </if>
        <if test="gender != null">
            gender,
        </if>
        <if test="phone != null">
            phone,
        </if>
    </trim>
    VALUES
    <trim prefix="(" suffix=")" suffixOverrides=",">
        <if test="username != null">
            #{username},
        </if>
        <if test="password != null">
            #{password},
        </if>
        <if test="age != null">
            #{age},
        </if>
        <if test="gender != null">
            #{gender},
        </if>
        <if test="phone != null">
            #{phone}
        </if>
    </trim>
</insert>

2.3 动态解析过程

在SQL动态解析时，第一个<trim>部分会进行如下处理：

基于prefix配置，开始部分加上(
基于suffix配置，结束部分加上)
多个<if>组织的语句都以,结尾，在最后拼接好的字符串还会以,结尾，会基于suffixOverrides配置去掉最后一个,

2.4 注解方式实现（不推荐）

java 复制代码

@Insert("<script>" +
        "INSERT INTO userinfo " +
        "<trim prefix='(' suffix=')' suffixOverrides=','>" +
        "<if test='username!=null'>username,</if>" +
        "<if test='password!=null'>password,</if>" +
        "<if test='age!=null'>age,</if>" +
        "<if test='gender!=null'>gender,</if>" +
        "<if test='phone!=null'>phone,</if>" +
        "</trim> " +
        "VALUES " +
        "<trim prefix='(' suffix=')' suffixOverrides=','>" +
        "<if test='username!=null'>#{username},</if>" +
        "<if test='password!=null'>#{password},</if>" +
        "<if test='age!=null'>#{age},</if>" +
        "<if test='gender!=null'>#{gender},</if>" +
        "<if test='phone!=null'>#{phone}</if>" +
        "</trim>" +
        "</script>")
Integer insertUserByCondition(UserInfo userInfo);

三、<where>标签

在实际业务中，我们经常需要根据不同的筛选条件动态组装WHERE子句。**<where>**标签可以智能地处理这种情况，避免SQL语法错误。

3.1 应用场景

需求：传入用户对象，根据属性做WHERE条件查询，用户对象中属性不为null的，都作为查询条件。例如username为"a"，则查询条件为WHERE username="a"。

3.2 接口定义

java 复制代码

// 根据条件查询用户
List<UserInfo> queryByCondition(UserInfo userInfo);

3.3 Mapper.xml实现

xml 复制代码

<select id="queryByCondition" resultType="com.example.demo.model.UserInfo">
    SELECT id, username, age, gender, phone, delete_flag, create_time, update_time
    FROM userinfo
    <where>
        <if test="age != null">
            AND age = #{age}
        </if>
        <if test="gender != null">
            AND gender = #{gender}
        </if>
        <if test="deleteFlag != null">
            AND delete_flag = #{deleteFlag}
        </if>
    </where>
</select>

3.4 <where>标签特性

智能处理：只会在子元素有内容的情况下才插入WHERE子句
自动去除：会自动去除子句开头的AND或OR，避免SQL语法错误
替代方案 ：可以使用<trim prefix="where" prefixOverrides="and">替换，但这种方式在子元素都没有内容时，WHERE关键字也会保留

3.5 注解方式实现

java 复制代码

@Select("<script>" +
        "SELECT id, username, age, gender, phone, delete_flag, create_time, update_time " +
        "FROM userinfo " +
        "<where>" +
        "    <if test='age != null'> AND age = #{age} </if>" +
        "    <if test='gender != null'> AND gender = #{gender} </if>" +
        "    <if test='deleteFlag != null'> AND delete_flag = #{deleteFlag} </if>" +
        "</where>" +
        "</script>")
List<UserInfo> queryByCondition(UserInfo userInfo);

四、<set>标签

在更新操作中，我们经常需要根据传入的对象属性来动态更新字段。**<set>**标签可以智能地处理UPDATE语句中的SET部分，避免多余的逗号问题。

4.1 应用场景

需求：根据传入的用户id属性，修改其他不为null的属性。只更新有值的字段，避免将null值更新到数据库。

4.2 接口定义

java 复制代码

// 根据条件更新用户信息
Integer updateUserByCondition(UserInfo userInfo);

4.3 Mapper.xml实现

xml 复制代码

<update id="updateUserByCondition">
    UPDATE userinfo
    <set>
        <if test="username != null">
            username = #{username},
        </if>
        <if test="age != null">
            age = #{age},
        </if>
        <if test="deleteFlag != null">
            delete_flag = #{deleteFlag},
        </if>
    </set>
    WHERE id = #{id}
</update>

4.4 <set>标签特性

智能插入：动态地在SQL语句中插入SET关键字
自动处理逗号：会删掉额外的逗号，避免SQL语法错误
替代方案 ：可以使用<trim prefix="set" suffixOverrides=",">替换，实现相同的功能

4.5 注解方式实现

java 复制代码

@Update("<script>" +
        "UPDATE userinfo " +
        "<set>" +
        "    <if test='username!=null'>username=#{username},</if>" +
        "    <if test='age!=null'>age=#{age},</if>" +
        "    <if test='deleteFlag!=null'>delete_flag=#{deleteFlag},</if>" +
        "</set>" +
        "WHERE id=#{id}" +
        "</script>")
Integer updateUserByCondition(UserInfo userInfo);

4.6 使用注意事项

条件判断 ：test属性中的字段名是Java对象的属性名
逗号处理 ：即使最后一个条件不满足，<set>标签也会自动处理末尾的逗号
性能考虑：只更新必要的字段，减少数据库的写操作

六、<include>标签

在XML映射文件中配置SQL时，经常会遇到很多重复的SQL片段，导致代码冗余。<include> 标签结合**<sql>**标签可以解决这个问题，通过抽取可重用的SQL片段来提高代码的复用性和可维护性。

6.1 问题分析

在开发过程中，多个SQL语句可能包含相同的字段列表或条件片段，例如：

xml 复制代码

<!-- 查询所有用户 -->
<select id="queryAllUser" resultMap="BaseMap">
    SELECT id, username, age, gender, phone, delete_flag, create_time, update_time
    FROM userinfo
</select>

<!-- 根据ID查询用户 -->
<select id="queryById" resultType="com.example.demo.model.UserInfo">
    SELECT id, username, age, gender, phone, delete_flag, create_time, update_time
    FROM userinfo WHERE id = #{id}
</select>

可以看到，两个查询语句都包含了相同的字段列表，这违反了DRY（Don't Repeat Yourself）原则。

6.2 <sql>标签：定义可重用SQL片段

**<sql>**标签用于定义可重用的SQL片段：

xml 复制代码

<sql id="allColumn">
    id, username, age, gender, phone, delete_flag, create_time, update_time
</sql>

特性说明：

id属性：SQL片段的唯一标识符，用于在其他地方引用
内容：可以是字段列表、WHERE条件、JOIN语句等任何SQL片段
位置：通常放在Mapper.xml文件的顶部或底部，便于管理

6.3 <include>标签：引用SQL片段

<include> 标签通过refid属性引用已定义的SQL片段：

xml 复制代码

<!-- 查询所有用户 -->
<select id="queryAllUser" resultMap="BaseMap">
    SELECT
    <include refid="allColumn"/>
    FROM userinfo
</select>

<!-- 根据ID查询用户 -->
<select id="queryById" resultType="com.example.demo.model.UserInfo">
    SELECT
    <include refid="allColumn"/>
    FROM userinfo WHERE id = #{id}
</select>

6.4 使用优势

代码复用：避免重复编写相同的SQL片段
维护方便：当字段列表需要修改时，只需修改一处
可读性高：SQL语句更加简洁清晰
减少错误：避免因复制粘贴导致的字段遗漏或错误

6.5 高级用法：带参数的SQL片段

<include> 标签还可以结合**<property>**标签传递参数：

xml 复制代码

<!-- 定义带表名前缀的SQL片段 -->
<sql id="userColumns">
    ${alias}.id, ${alias}.username, ${alias}.age
</sql>

<!-- 使用带参数的SQL片段 -->
<select id="queryUserWithAlias" resultType="com.example.demo.model.UserInfo">
    SELECT
    <include refid="userColumns">
        <property name="alias" value="u"/>
    </include>
    FROM userinfo u
</select>

6.6 最佳实践建议

合理划分片段：将常用的字段列表、WHERE条件、JOIN语句等抽取为SQL片段
统一命名规范 ：使用有意义的id名称，如baseColumns、whereConditions等
避免过度抽取：只抽取真正需要复用的SQL片段，避免过度设计
注释说明：为每个SQL片段添加注释，说明其用途和适用场景

6.7 实际应用场景

场景一：多表查询字段复用

xml 复制代码

<sql id="userBaseColumns">
    u.id, u.username, u.email, u.create_time
</sql>

<sql id="orderBaseColumns">
    o.id as order_id, o.order_no, o.amount, o.status
</sql>

<select id="queryUserWithOrders" resultMap="UserOrderMap">
    SELECT
    <include refid="userBaseColumns"/>,
    <include refid="orderBaseColumns"/>
    FROM user u
    LEFT JOIN orders o ON u.id = o.user_id
    WHERE u.id = #{userId}
</select>

场景二：复杂条件复用

xml 复制代码

<sql id="activeUserCondition">
    delete_flag = 0 AND status = 1
</sql>

<select id="queryActiveUsers" resultType="com.example.demo.model.UserInfo">
    SELECT * FROM userinfo
    WHERE <include refid="activeUserCondition"/>
</select>

<select id="countActiveUsers" resultType="java.lang.Integer">
    SELECT COUNT(*) FROM userinfo
    WHERE <include refid="activeUserCondition"/>
</select>

七、小结

本来准备昨天更两篇的但是实在是太困了，今天是我上班第一天，感觉良好。晚上回来自己做了手抓饼，谁敢信一个手抓饼我搞了一个小时，吃了还拉肚子了，以后工作日回来再也不自己整了，好困好困好困