快捷導(dǎo)航

MyBatis<choose>動(dòng)態(tài)SQL用法詳解

更新時(shí)間：2025年09月21日 15:59:33 作者：night_gu

MyBatis <choose>動(dòng)態(tài)SQL標(biāo)簽用于多條件分支查詢,按順序判斷<when>條件,僅執(zhí)行第一個(gè)匹配項(xiàng),無匹配則執(zhí)行<otherwise>,與<if>不同,它不拼接所有滿足條件的片段,適用于優(yōu)先級(jí)排序、枚舉處理等場(chǎng)景

MyBatis<choose>動(dòng)態(tài)SQL

<choose> 是 MyBatis 動(dòng)態(tài) SQL 中的一個(gè)標(biāo)簽，用于實(shí)現(xiàn)類似 Java 中的 switch-case 邏輯。

它通常與 <when> 和 <otherwise> 配合使用，根據(jù)條件選擇不同的 SQL 片段執(zhí)行。

基本語法結(jié)構(gòu)

<choose>
    <when test="condition1">
        <!-- SQL 片段1 -->
    </when>
    <when test="condition2">
        <!-- SQL 片段2 -->
    </when>
    <otherwise>
        <!-- 默認(rèn) SQL 片段 -->
    </otherwise>
</choose>

使用示例

假設(shè)需要根據(jù)不同的查詢條件動(dòng)態(tài)生成 SQL：

<select id="findActiveBlogLike" resultType="Blog">
    SELECT * FROM BLOG WHERE state = 'ACTIVE'
    <choose>
        <when test="title != null">
            AND title like #{title}
        </when>
        <when test="author != null and author.name != null">
            AND author_name like #{author.name}
        </when>
        <otherwise>
            AND featured = 1
        </otherwise>
    </choose>
</select>

工作原理

按照 <when> 標(biāo)簽的順序依次判斷條件表達(dá)式
當(dāng)某個(gè) <when> 的 test 條件為 true 時(shí)，會(huì)執(zhí)行對(duì)應(yīng)的 SQL 片段
如果所有 <when> 條件都不滿足，則執(zhí)行 <otherwise> 中的 SQL
如果沒有 <otherwise> 且所有條件都不滿足，則不插入任何 SQL

注意事項(xiàng)

每個(gè) <when> 標(biāo)簽的 test 屬性值是 OGNL 表達(dá)式
可以使用復(fù)雜的條件判斷，包括邏輯運(yùn)算符和對(duì)象屬性訪問
只會(huì)選擇第一個(gè)滿足條件的 <when> 分支執(zhí)行
<otherwise> 是可選的，不是必須的

與 if 標(biāo)簽的區(qū)別

<if> 標(biāo)簽會(huì)檢查所有滿足條件的片段并拼接，而 <choose> 只會(huì)選擇第一個(gè)滿足條件的片段執(zhí)行。例如：

<!-- if 標(biāo)簽示例：可能拼接多個(gè)條件 -->
<if test="title != null">AND title = #{title}</if>
<if test="author != null">AND author = #{author}</if>

<!-- choose 標(biāo)簽示例：只選擇第一個(gè)滿足的條件 -->
<choose>
    <when test="title != null">AND title = #{title}</when>
    <when test="author != null">AND author = #{author}</when>
</choose>