MyBatis 动态 SQL 常用功能

使用 jdbc 或类似的框架,动态拼接 SQL 是很痛苦的。比如根据当前日期选择数据表、根据传入的参数决定更新哪些字段等,都是比较常用的动态查询。MyBatis 拥有强大的动态 SQL 功能,可以在任何 SQL 语句中使用。MyBatis 的动态 SQL 主要使用以下几个元素来实现:

  • 单一条件:if
  • 多个条件:choose, when, otherwise
  • 自动封装:trim, where, set
  • 遍历集合:foreach

if

if 用于检测条件,动态包含 SQL 语句。例如下面的语句中,根据输入的 title 是否为空来决定是否在查询条件中增加 title 搜索条件。

<select id="select" resultType="Person">
    SELECT * FROM Person WHERE state = ‘ACTIVE’  
    <if test="title != null">
        AND title like #{title}  
    </if>
</select>

choose, when, otherwise

choose 元素提供了类似于 Java 语言中的 switch 功能,可以从多个选项中选择一个加入 SQL 语句。

例如下面的语句,使用了两个 when 和一个 otherwise,类似于 switch 中的 case 和 default。

<select id="select" resultType="Person">
    SELECT * FROM Person WHERE state = ‘ACTIVE’  
    <choose>
        <when test="title != null">
          AND title like #{title}    
        </when>
        <when test="sex != null">
          AND sex = #{sex}    
        </when>
        <otherwise>
          AND height = 170
        </otherwise>
    </choose>
</select>

trim, where, set

trim 元素可以用于为 SQL 语句增加前缀、后缀,并去除指定的开头和结尾。一共有四个属性:

  • prefix:语句的前缀;
  • prefixOverrides:去除开头;
  • suffix:语句的后缀;
  • suffixOverrides:去除结尾。

在下面的语句中,trim 会先删除 somesql 的开头和结尾,然后再增加前缀和后缀。

<trim prefix="前缀" prefixOverrides="去除开头" 
    suffix="后缀" suffixOverrides="去除结尾">
  somesql
</trim>

假设使用 if 语句增加两个动态条件,如下所示。如果只满足第二个条件,或者两个条件都不满足,最终得到的 SQL 是一个有 WHERE 但没有条件的非法 SQL。

<select id="select" resultType="Person">
    SELECT * FROM Person WHERE  
    <if test="sex != null">
        sex = #{sex}  
    </if>
    <if test="title != null">
        AND title like #{title}  
    </if>
</select>

使用 where 元素可以避免这一点,如下所示。where 元素可以检测内部的查询条件是否合法,比如为空、多了 AND / OR,并进行处理使 SQL 语句合法。经过 where 元素处理后,无论内部 if 元素是否成立,我们都可以得到合法的 SQL 语句。

<select id="select" resultType="Person">
    SELECT * FROM Person  
    <where>
        <if test="sex != null">
            sex = #{sex}    
        </if>
        <if test="title != null">
            AND title like #{title}    
        </if>
    </where>
</select>

同样地,update 语句中也可以使用 set 元素来实现类似于 where 元素的功能。在如下的示例中,set 元素确保了 SQL 语句中的 SET 永远是合法的,它能自动处理 SET 为空、结尾多逗号,并自动拼接 SET 字符串。

<update id="update">
    update Person    
    <set>
        <if test="title != null">
            title=#{title},
        </if>
        <if test="sex != null">
            sex=#{sex},
        </if>
    </set>
    where id=#{id}
</update>

foreach

foreach 用于处理集合,比如批量插入、批量查询条件等情况,支持 List、Array、Set、Map 等。在下面的例子中,查询条件是一个 list,使用 in 来查询。

<select id="select" resultType="Person">
    SELECT * FROM Person WHERE id in  
    <foreach item="item" index="index" collection="list"
      open="(" separator="," close=")">
        #{item}
    </foreach>
</select>

foreach 的属性定义如下:

  • Item:集合中元素迭代的别名,如果集合为 map 这里是 value;
  • index:集合中元素迭代的索引,如果集合为 map 这里是 key;
  • collection:集合的类型;
  • open:语句的前缀;
  • separator:语句的分隔符;
  • close:语句的后缀。

分享学习笔记和技术总结,内容涉及 Java 进阶、架构设计、前沿技术、算法与数据结构、数据库、中间件等多个领域,欢迎关注。本文首发于微信公众号“后端开发那点事儿”。

    原文作者:SQL
    原文地址: https://juejin.im/entry/5a77f0eb5188257a6d635d23
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞