讲师中心 微信公众号
AI工具推荐 视频效率加速

MyBatis动态SQL中foreach标签的详细使用手册

落萱酱_6420

落萱酱_6420

发布时间:2025-07-05 15:32:01

|

1191人浏览过

|

来源于php中文网

原创

在mybatis中,标签用于处理集合类型参数,适用于动态in查询、批量插入等场景。其核心作用是对集合进行遍历,并将每个元素以特定格式拼接到sql语句中。一、基本语法结构包括collection(指定集合)、item(元素别名)、separator(分隔符)、open和close(生成内容前后添加的字符串)。二、常见使用场景有:1. in查询,通过传入list或array构造in子句;2. 批量插入数据,适用于mysql、postgresql等支持多值插入的数据库;3. 动态拼接多个or条件实现模糊匹配。三、collection属性根据参数类型不同写法各异:list用collection="list"或具体名称,数组用collection="array",map用collection="map"。四、容易出错的地方包括忘记加括号导致语法错误、参数名写错、忽略数据库差异、误用item属性等。掌握关键属性并注意细节可有效应对集合操作需求。

MyBatis动态SQL中foreach标签的详细使用手册

在MyBatis中,<foreach></foreach>标签是处理集合类型参数的重要工具,尤其适用于构建动态IN查询、批量插入等场景。它的核心作用是对传入的集合进行遍历,并将每个元素以特定格式拼接到SQL语句中。

MyBatis动态SQL中foreach标签的详细使用手册

一、<foreach></foreach>标签的基本语法结构

<foreach></foreach>标签有以下几个常用属性:

MyBatis动态SQL中foreach标签的详细使用手册
  • collection:指定要遍历的集合或数组,可以是List、Array、Map等。
  • item:指定集合中每个元素的别名,在循环体内使用。
  • separator:指定每次循环之间插入的分隔符,比如逗号。
  • open 和 close:可选,用于在生成内容前后添加字符串,如括号。

一个典型的写法如下:

<foreach collection="ids" item="id" separator="," open="(" close=")">
    #{id}
</foreach>

这段代码会生成类似 (1,2,3) 的结果,常用于 IN 查询。

MyBatis动态SQL中foreach标签的详细使用手册

二、常见使用场景及写法示例

1. IN 查询中的使用

当你需要根据一组ID查询数据时,最常见的方式就是结合 <foreach></foreach> 使用 IN 子句:

<select id="selectByIds" resultType="User">
    SELECT * FROM users
    WHERE id IN
    <foreach collection="ids" item="id" separator="," open="(" close=")">
        #{id}
    </foreach>
</select>

传入的参数是一个 List 或 Array,例如:[1, 2, 3],最终 SQL 会变成:

SELECT * FROM users WHERE id IN (1,2,3);

2. 批量插入数据

在执行批量插入时,也可以用 <foreach></foreach> 来构造 VALUES 部分:

MySQL8 CRM Schema Design Expert
MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。

下载
<insert id="batchInsert">
    INSERT INTO users (name, email)
    VALUES
    <foreach collection="userList" item="user" separator=",">
        (#{user.name}, #{user.email})
    </foreach>
</insert>

注意:这种写法依赖数据库支持多值插入(MySQL、PostgreSQL 支持),Oracle 不支持这种方式,需要用其他方式处理。

3. 拼接条件语句

有时你可能想根据一个集合动态拼接多个 OR 条件:

<where>
    <foreach collection="keywords" item="keyword" separator=" OR ">
        name LIKE CONCAT('%', #{keyword}, '%')
    </foreach>
</where>

这样就能实现多个关键词模糊匹配的效果。


三、关于collection属性的写法细节

传入参数的类型不同,collection 属性的写法也会有所不同:

参数类型 示例写法
List collection="list" 或具体名称如 ids
数组 collection="array" 或自定义名如 nums
Map collection="map" 或 key 名如 userIds

如果你用了注解方式传参,比如:

List<User> selectByIds(@Param("ids") List<Integer> ids);

那 XML 中就可以直接写 collection="ids"。


四、一些容易出错的地方

  • 忘记加括号:IN 查询时如果不加 open="(" 和 close=")",会导致 SQL 语法错误。
  • 参数名写错:比如传的是 userIdList,但写了 collection="ids",就会找不到集合。
  • 不考虑数据库差异:像 Oracle 不支持多值插入,强行使用 <foreach></foreach> 构造批量插入会导致失败。
  • 误用 item 属性:在 item 中用了非法变量名或重复命名,会影响 SQL 解析。

基本上就这些,掌握好 <foreach></foreach> 标签的几个关键属性和常见用法,就能应对大多数动态 SQL 中的集合操作需求了。不复杂但容易忽略细节,特别是参数传递方式和数据库兼容性问题,建议开发时多测试几种情况。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4763

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

971

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1249

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

6761

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

3483

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

6760

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

9341

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1270

2024.04.29

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 194人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn