mybatis动态SQL常用的标签使用及说明

更新时间：2026年04月27日 15:48:33 作者：m0_59259076

文章主要讲解了MyBatis中的动态SQL标签,包括使用场景、作用和示例,主要介绍了<where>、<choose>、&<set>、&<foreach>、&&<bind>等等、标签的的用用使用方法和作用,以及<sql>片段的概念和引用方式

1. <sql>标签

也叫<sql>片段，在使用sql片段时使用include标签通过sql片段的id进行引用，sql片段的id在当前空间是唯一的，sql片段中也可以写其他的内容，只要符合语法规范都是可以的。

示例：

    <!-- 通用查询结果列 -->
    <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>可以是单标签的，效果是一样的，我这里使用了双标签~）

2.<where>标签

根据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> 标签

类似于Java中的switch分支。只进入一个满足when的条件，如果所有when都不满足，则进入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>标签

与where有相似，其后如果存在条件，则拼接set。

<set>标签会动态地在行首插入SET关键字，并且自动帮我们去掉多余的逗号，适用于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>标签

用于遍历List、Map、Array , 属性如下：

collection：指定需要遍历的元素
item：遍历之后的每一项
separator：定义foreach里面语句的分隔符
index：map中代表key，数组中代表数组下标

    <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>标签，用来定义变量

示例：

mapper层：

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

xml映射层：

    <select id="getByName" resultType="com.zhang.entity.Animal">
        <!--animalName为传过来的参数-->
        <!--根据动物名字进行模糊查询-->
        <bind name="animalNameLike" value="'%'+ animalName +'%'"/>
        select * from animal
        <where>
            <if test="animalName != null and animalName != ''">
                and `name` like #{animalNameLike}
            </if>
        </where>
    </select>

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Java实现阿里云短信接口的示例
这篇文章主要介绍了Java实现阿里云短信接口的示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09
关于Idea的Invalidate Caches/Restart使用
项目类导入爆红可能因Idea缓存异常导致Maven依赖识别失败,解决方法为通过Invalidate Caches/Restart清除缓存,等待重新构建索引后重新进入项目
2025-07-07
使用okhttp替换Feign默认Client的操作
这篇文章主要介绍了使用okhttp替换Feign默认Client的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-02-02
SpringMVC中转发与重定向的区别浅析
这篇文章主要给大家介绍了关于SpringMVC中转发与重定向的区别，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-12-12
SpringIOC的注解应用方式
在Spring框架中,除了通过xml配置文件进行Bean管理外,还可以采用注解的方式实现Bean的注册和自动装配,通过在类上添加@Component、@Service、@Repository、@Controller等注解,可以将Bean注册到IOC容器中
2024-11-11
Netty分布式pipeline管道创建方法跟踪解析
这篇文章主要为大家介绍了Netty分布式pipeline管道创建方法跟踪解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-03-03
引入QQ邮箱发送验证码进行安全校验功能实现
最近遇到这样的需求用户输入自己的邮箱，点击获取验证码，后台会发送一封邮件到对应邮箱中，怎么实现呢？下面小编给大家带来了引入QQ邮箱发送验证码进行安全校验功能,需要的朋友可以参考下
2023-02-02
Java可以写android的应用程序吗
在本篇文章里小编给大家整理的是一篇关于Java可以写android的应用程序吗的相关基础文章，有兴趣的朋友们可以学习下。
2020-11-11
java单链表使用总结
这篇文章主要为大家详细介绍了java单链表使用总结，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01
详解Java中的do...while循环语句的使用方法
这篇文章主要介绍了Java中的do...while循环语句的使用方法,是Java入门学习中的基础知识,需要的朋友可以参考下
2015-10-10