Mybatis常用动态标签大全(详细)

一、前言

动态 SQL 是 MyBatis 的强大特性之一。如果你使用过 JDBC 或其它类似的框架，你应该能理解根据不同条件拼接 SQL 语句有多痛苦，例如拼接时要确保不能忘记添加必要的空格，还要注意去掉列表最后一个列名的逗号。利用动态 SQL，可以彻底摆脱这种痛苦。

使用动态 SQL 并非一件易事，但借助可用于任何 SQL 映射语句中的强大的动态 SQL 语言，MyBatis 显著地提升了这一特性的易用性。

如果你之前用过 JSTL 或任何基于类 XML 语言的文本处理器，你对动态 SQL 元素可能会感觉似曾相识。在 MyBatis 之前的版本中，需要花时间了解大量的元素。借助功能强大的基于 OGNL 的表达式，MyBatis 3 替换了之前的大部分元素，大大精简了元素种类，现在要学习的元素种类比原来的一半还要少。

大概分为这四种常用的动态标签

元素	作用	场景
foreach	循环语句	批量添加或者批量查询
if	判断语句	单条件分支判断
choose、when、otherwise	相当于 Java 中的 switch case default 语句	多条件分支判断
trim、where、set	辅助元素	用于处理一些条件查询

二、foreach语句

动态 SQL 的另一个常见使用场景是对集合进行遍历（尤其是在构建 IN 条件语句的时候）。
1. 参数解释

• collection：collection 属性的值有三个分别是 list、array、map 三种，分别对应的参数类型为：List、数组、map 集合。

• item：表示在迭代过程中每一个元素的别名

• open：前缀

• close：后缀

• separator：分隔符，表示迭代时每个元素之间以什么分隔

• index：表示迭代中每次迭代到的下标位置

2. 例子演示

<select id="queryDataByIds" resultType="com.wang.test.demo.entity.User">
   select * from user where id in
    <foreach collection="list" item="item" open="(" separator="," close=")">
        #{item}
    </foreach>
</select>

三、if语句

使用动态 SQL 最常见情景是根据条件包含 where 子句的一部分。
1. 参数解释

• test: 是对要判断的字段来写限制条件

2. 例子演示

<select id="queryDataBySearch" resultType="com.wang.test.demo.entity.User">
   select * from user
   where stage = 'A'
   <if test="age != null and age != ''">
       and age =#{age}
   </if>
   <if test="name != null and name != ''">
       and name =#{name}
   </if>
</select>

四、choose、when、otherwise语句

有时候，我们不想使用所有的条件，而只是想从多个条件中选择一个使用。针对这种情况，MyBatis 提供了 choose 元素，它有点像 Java 中的 switch 语句.一个成立则choose结束
1. 参数解释

• test: 是对要判断的字段来写限制条件

2. 例子演示

<select id="queryDataBySearchNew" resultType="com.wang.test.demo.entity.User">
    select * from user
    <where>
        <choose>
            <when test="age != null and age != ''">
                and age =#{age}
            </when>
            <when test="name != null and name != ''">
                and name =#{name}
            </when>
            <otherwise>
                stage = 'A'
            </otherwise>
        </choose>
    </where>
</select>

五、trim、where、set语句

1. 参数解释

• prefix：在trim标签内sql语句加上前缀

• suffix：在trim标签内sql语句加上后缀

• prefixOverrides：指定去除多余的前缀内容，如：prefixOverrides=“AND”，去除trim标签内sql语句多余的前缀"AND"。

• suffixOverrides：指定去除多余的后缀内容，suffixOverrides=“OR”，去除trim标签内sql语句多余的前缀"OR"。

2. 例子演示

<update id="updateById" parameterType="com.wang.test.demo.entity.User">
   update user
    <set>
        <trim  suffixOverrides=",">
            <if test="name != null and age != ''">
                name=#{name},
            </if>
            <if test="age != null and name != ''">
                age=#{age},
            </if>
        </trim>
    </set>
    where id=#{id}
</update>

<update id="updateById1" parameterType="com.wang.test.demo.entity.User">
    update user
    <trim  suffixOverrides="," prefix="set">
        <if test="name != null and age != ''">
            name=#{name},
        </if>
        <if test="age != null and name != ''">
            age=#{age},
        </if>
    </trim>
    where id=#{id}
</update>