快捷導(dǎo)航

mybatis動態(tài)SQL常用的標(biāo)簽使用及說明

更新時(shí)間：2026年04月27日 15:48:33 作者：m0_59259076

文章主要講解了MyBatis中的動態(tài)SQL標(biāo)簽,包括使用場景、作用和示例,主要介紹了<where>、<choose>、&<set>、&<foreach>、&&<bind>等等、標(biāo)簽的的用用使用方法和作用,以及<sql>片段的概念和引用方式

1. <sql>標(biāo)簽

也叫<sql>片段，在使用sql片段時(shí)使用include標(biāo)簽通過sql片段的id進(jìn)行引用，sql片段的id在當(dāng)前空間是唯一的，sql片段中也可以寫其他的內(nèi)容，只要符合語法規(guī)范都是可以的。

示例：

    <!-- 通用查詢結(jié)果列 -->
    <sql id="Base_Column_List">
        id, name, age, hobby, del_flag, create_time, update_time
    </sql>
    <select id="listAnimals" resultType="com.zhang.entity.Animal">
        select
        <include refid="Base_Column_List"></include>
        from animal
    </select>

（注：<include>可以是單標(biāo)簽的，效果是一樣的，我這里使用了雙標(biāo)簽~）

2.<where>標(biāo)簽

根據(jù)where其后是否有sql，判斷拼接 where,滿足條件就拼接，否則不拼接。示例：

    <select id="getAnimalByName" resultType="com.zhang.entity.Animal">
        select * from animal
        <where>
            <if test="name!=null and name!=''">
                and name = #{name}
            </if>
        </where>
    </select>

3.<choose> 標(biāo)簽

類似于Java中的switch分支。只進(jìn)入一個滿足when的條件，如果所有when都不滿足，則進(jìn)入otherwise。

示例：

    <select id="getAnimalsByNameOrHobby" resultType="com.zhang.entity.Animal">
        select * from animal
        <choose>
            <when test="hobby!=null and hobby!='' and name!=null and name!=''">
                hobby = #{hobby} and name = #{name}
            </when>
            <when test="hobby!=null and hobby!=''">
                hobby = #{hobby}
            </when>
            <otherwise>
                name = #{name}
            </otherwise>
        </choose>
    </select>

4.<set>標(biāo)簽

與where有相似，其后如果存在條件，則拼接set。

<set>標(biāo)簽會動態(tài)地在行首插入SET關(guān)鍵字，并且自動幫我們?nèi)サ舳嘤嗟亩禾枺m用于update，示例：

    <update id="update">
        update animal
        <set>
            <if test="age!=null and age!=''">
                age = #{age}
            </if>
            <if test="name!=null and name!=''">
                name = #{name},
            </if>
            <if test="hobby!=null and hobby!=''">
                hobby = #{hobby}
            </if>
        </set>
        where id = #{id}
    </update>

    <update id="updateById" parameterType="com.zhang.entity.Animal">
    update animal
    <set>
        <if test="name != null">
            `name` = #{name,jdbcType=VARCHAR},
        </if>
        <if test="age != null">
            `age` = #{age,jdbcType=VARCHAR},
        </if>
        <if test="hobby != null">
            hobby = #{hobby,jdbcType=VARCHAR},
        </if>
        <if test="create_time != null">
            create_time = #{create_time,jdbcType=TIMESTAMP},
        </if>
        <if test="update_time != null">
            update_time = #{update_time,jdbcType=TIMESTAMP},
        </if>
    </set>
    where id = #{id,jdbcType=INTEGER}
    </update>

5.<foreach>標(biāo)簽

用于遍歷List、Map、Array , 屬性如下：

collection：指定需要遍歷的元素
item：遍歷之后的每一項(xiàng)
separator：定義foreach里面語句的分隔符
index：map中代表key，數(shù)組中代表數(shù)組下標(biāo)

    <select id="listAnimals" resultType="com.zhang.entity.Animal">
        SELECT * FROM animal
        WHERE id in
        <foreach collection="ids" item="id" index="index"
                 open="(" close=")" separator=",">
            #{id}
        </foreach>
    </select>

6.<bind>標(biāo)簽，用來定義變量

示例：

mapper層：

List<Animal> getByName(@Param("animalName") String name);

xml映射層：

    <select id="getByName" resultType="com.zhang.entity.Animal">
        <!--animalName為傳過來的參數(shù)-->
        <!--根據(jù)動物名字進(jìn)行模糊查詢-->
        <bind name="animalNameLike" value="'%'+ animalName +'%'"/>
        select * from animal
        <where>
            <if test="animalName != null and animalName != ''">
                and `name` like #{animalNameLike}
            </if>
        </where>
    </select>