详细分析Mybatis中的<foreach>标签

目录

  • 前言
  • [1. 基本语法](#1. 基本语法)
  • [2. Demo](#2. Demo)
  • [3. 实际例子](#3. 实际例子)

前言

对于Java专栏:Java专栏

对于Mybatis的相关知识可看我之前的文章:Mybatis从入门到精通(全)

对于其余Java框架可看我之前的文章:java框架 零基础从入门到精通的学习路线 附开源项目面经等(超全)

对于上述Mybatis中曾有讲过foreach标签!此篇博客对其标签进行拓展

1. 基本语法

MyBatis中的<foreach>标签是用于迭代集合或数组的元素,生成对应的SQL片段,以便在动态SQL中使用。

该标签通常用于循环处理参数集合,生成多个相同的SQL片段,以实现批量操作或动态条件查询。

其基本的语法如下:

xml 复制代码
<foreach collection="collectionName" item="itemName" index="indexName" open="(" close=")" separator=",">
    #{itemName}
</foreach>

对应的属性如下:(只有collection和item是必选,其他都是可选参数)

  • collection: 指定要迭代的集合或数组的属性名,表示传入的参数的数据类型。
    该属性是必须指定的,用于指定要进行foreach操作的对象。
  • item: 指定在迭代过程中每个元素的别名,表示本次迭代获取的元素。
    若collection为List、Set或者数组,则表示其中的元素;
    若collection为map,则代表key-value的value。
    该参数是必选的。
  • index: 指定在迭代过程中每个元素的索引,仅对集合有效。
    在遍历List时,index表示元素的索引;在遍历Map时,index表示Map的key。该参数是可选的。
  • open: 指定迭代开始时的字符串,最常用的是左括弧'('
    MyBatis会将该字符拼接到整体的SQL语句之前,并且只拼接一次。该参数是可选的。
  • close: 指定迭代结束时的字符串,最常用的是右括弧')'
    MyBatis会将该字符拼接到整体的SQL语句之后。该参数是可选的。
  • separator: 指定每次迭代之间的分隔符。
    在SQL语句中,用于分隔不同元素的值。例如,1,2,3之间的,。该参数是可选的。

2. Demo

下面是一个简单的例子,假设有一个包含多个用户ID的集合,我们想要生成一个SQL语句查询这些用户:

xml 复制代码
<select id="selectUsersByIds" resultType="User">
    SELECT * FROM users
    WHERE id IN
    <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
        #{userId}
    </foreach>
</select>

在这个例子中,userIds是一个包含用户ID的集合,<foreach>标签会生成类似于IN (id1, id2, id3)的SQL片段。

另外,如果使用MyBatis的动态SQL功能,可以在<if>标签内使用<foreach>,以根据条件动态生成SQL片段,以下是一个例子,假设有一个条件查询的场景,根据用户选择的角色列表进行查询:

xml 复制代码
<select id="selectUsersByRoles" resultType="User">
    SELECT * FROM users
    <where>
        <if test="roles != null and roles.size > 0">
            AND id IN
            <foreach collection="roles" item="role" open="(" close=")" separator=",">
                #{role}
            </foreach>
        </if>
    </where>
</select>

在这个例子中,selectUsersByRoles是一个动态SQL查询,它根据用户传入的roles参数动态生成SQL条件。

  • 如果roles不为空且包含元素,那么<if>标签内的内容会生效,生成类似于AND id IN (role1, role2, role3)的SQL片段。
  • 如果roles为空或不包含元素,该条件会被忽略,从而生成不包含AND的SQL语句。

在实际应用中,这种动态SQL的使用可以根据不同的业务需求动态构建查询条件,使SQL语句更加灵活和可复用。

3. 实际例子

结合实战中的例子,讲解更加透彻

  • 批量插入,即列表中有多个元素,代码示例:
xml 复制代码
<insert id="saveForList" parameterType="java.util.List">
    INSERT INTO E_DEVICE_TEMP_ALARM_HIST(DEVICE_NAME, BATTERY_TEMP, SEND_TO_DRIVER, CREATE_TIME, UPDATE_TIME, SENDER, SUGGESTION)
    <foreach collection="temperatureAlarmHistList" item="temperatureAlarmHist" separator="union all" open="(" close=")">
        SELECT
        #{temperatureAlarmHist.deviceName, jdbcType=VARCHAR},
        #{temperatureAlarmHist.batteryTemp, jdbcType=VARCHAR},
        #{temperatureAlarmHist.sendToDriver, jdbcType=INTEGER},
        #{temperatureAlarmHist.createTime, jdbcType=DATE},
        #{temperatureAlarmHist.updateTime, jdbcType=DATE},
        #{temperatureAlarmHist.sender, jdbcType=VARCHAR},
        #{temperatureAlarmHist.suggestion, jdbcType=VARCHAR}
        FROM DUAL
    </foreach>
</insert>
  • 动态SQL语句,更新语句也同理:
xml 复制代码
<update id="removeRuleDetailByRuleId"  >
    update equipment_change_shifts_rule_detail set is_deleted = 1 where rule_id IN
    <foreach collection="ids" item="id" index="index" open="(" separator="," close=")">
        #{id}
    </foreach>
</update>
  • 结合if语句,且参数位置可以随意:
xml 复制代码
<select id="trees" resultMap="treeNodeResultMap">
    select id, parent_id, equipment_name as title, id as 'value', id as 'key',location from equipment_architecture where is_deleted = 0
    <if test="tenantId!=null">
        and tenant_id = #{tenantId}
    </if>
    and id in
    <foreach close=")" collection="ids" item="listItem" open="(" separator=",">
        #{listItem}
    </foreach>
</select>
相关推荐
jokerest1235 小时前
web——sqliabs靶场——第十三关——报错注入+布尔盲注
mybatis
武子康5 小时前
Java-06 深入浅出 MyBatis - 一对一模型 SqlMapConfig 与 Mapper 详细讲解测试
java·开发语言·数据仓库·sql·mybatis·springboot·springcloud
WindFutrue8 小时前
使用Mybatis向Mysql中的插入Point类型的数据全方位解析
数据库·mysql·mybatis
AiFlutter9 小时前
Java实现简单的搜索引擎
java·搜索引擎·mybatis
天天扭码12 小时前
五天SpringCloud计划——DAY1之mybatis-plus的使用
java·spring cloud·mybatis
武子康1 天前
Java-05 深入浅出 MyBatis - 配置深入 动态 SQL 参数、循环、片段
java·sql·设计模式·架构·mybatis·代理模式
2的n次方_1 天前
MyBatis——#{} 和 ${} 的区别和动态 SQL
数据库·sql·mybatis
jokerest1232 天前
web——sqliabs靶场——第十二关——(基于错误的双引号 POST 型字符型变形的注入)
数据库·sql·mybatis
天蓝蓝235282 天前
Lucene数据写入流程
java·mybatis·lucene
shiming88792 天前
Lucene数据写入与数据刷盘机制
java·mybatis·lucene