mybatis 中 foreach collection的三种用法

本文详细解析了MyBatis中foreach元素的应用,包括其属性如item、index、collection等的使用方法,以及在不同场景下collection属性的设置,通过具体示例展示了如何在SQL语句中迭代集合。

foreach的主要用在构建in条件中,它可以在SQL语句中进行迭代一个集合。

foreach元素的属性主要有 item,index,collection,open,separator,close。

    item表示集合中每一个元素进行迭代时的别名,
    index指 定一个名字,用于表示在迭代过程中,每次迭代到的位置,
    open表示该语句以什么开始,
    separator表示在每次进行迭代之间以什么符号作为分隔 符,
    close表示以什么结束。


在使用foreach的时候最关键的也是最容易出错的就是collection属性,该属性是必须指定的,但是在不同情况 下,该属性的值是不一样的,主要有一下3种情况:

    1. 如果传入的是单参数且参数类型是一个List的时候,collection属性值为list
    2. 如果传入的是单参数且参数类型是一个array数组的时候,collection的属性值为array
    3. 如果传入的参数是多个的时候,我们就需要把它们封装成一个Map了,当然单参数也可

以封装成map,实际上如果你在传入参数的时候,在breast里面也是会把它封装成一个Map的,map的key就是参数名,所以这个时候collection属性值就是传入的List或array对象在自己封装的map里面的key 下面分别来看看上述三种情况的示例代码:
1.单参数List的类型:
  

1 <select id="dynamicForeachTest" resultType="Blog">
2           select * from t_blog where id in
3        <foreach collection="list" index="index" item="item" open="(" separator="," close=")">
4                #{item}       
5        </foreach>    
6    </select>

 


上述collection的值为list,对应的Mapper是这样的
public List dynamicForeachTest(List ids);
测试代码:

复制代码

 1 @Test
 2     public void dynamicForeachTest() {
 3         SqlSession session = Util.getSqlSessionFactory().openSession();      
 4         BlogMapper blogMapper = session.getMapper(BlogMapper.class);
 5          List ids = new ArrayList();
 6          ids.add(1);
 7          ids.add(3);
 8           ids.add(6);
 9         List blogs = blogMapper.dynamicForeachTest(ids);
10          for (Blog blog : blogs)
11              System.out.println(blog);
12          session.close();
13      }

复制代码

 


2.单参数array数组的类型:

1 <select id="dynamicForeach2Test" resultType="Blog">
2     select * from t_blog where id in
3     <foreach collection="array" index="index" item="item" open="(" separator="," close=")">
4          #{item}
5     </foreach>
6 </select>    

 


上述collection为array,对应的Mapper代码:
public List dynamicForeach2Test(int[] ids);
对应的测试代码:
      

复制代码

 1 @Test
 2 public void dynamicForeach2Test() {
 3         SqlSession session = Util.getSqlSessionFactory().openSession();
 4         BlogMapper blogMapper = session.getMapper(BlogMapper.class);
 5         int[] ids = new int[] {1,3,6,9};
 6         List blogs = blogMapper.dynamicForeach2Test(ids);
 7         for (Blog blog : blogs)
 8         System.out.println(blog);    
 9         session.close();
10 }

复制代码

 


3.自己把参数封装成Map的类型

1 <select id="dynamicForeach3Test" resultType="Blog">
2         select * from t_blog where title like "%"#{title}"%" and id in
3          <foreach collection="ids" index="index" item="item" open="(" separator="," close=")">
4               #{item}
5          </foreach>
6 </select>

 


上述collection的值为ids,是传入的参数Map的key,对应的Mapper代码:
public List dynamicForeach3Test(Map params);
对应测试代码:
    

复制代码

@Test
    public void dynamicForeach3Test() {
        SqlSession session = Util.getSqlSessionFactory().openSession();
         BlogMapper blogMapper = session.getMapper(BlogMapper.class);
          final List ids = new ArrayList();
          ids.add(1);
          ids.add(2);
          ids.add(3);
          ids.add(6);
         ids.add(7);
         ids.add(9);
        Map params = new HashMap();
         params.put("ids", ids);
         params.put("title", "中国");
        List blogs = blogMapper.dynamicForeach3Test(params);
         for (Blog blog : blogs)
             System.out.println(blog);
         session.close();
     }
### MyBatisforeach标签无法正确获取collection集合数据的原因及解决方法 在MyBatis框架中,`<foreach>`标签用于遍历集合并动态生成SQL语句中的部分结构。如果遇到`<foreach>`标签无法正确获取`collection`集合数据的情况,通常可能是由于以下几个原因引起的。 #### 1. **参数传递方式不匹配** 当Mapper接口的方法参数是一个简单的Java集合(如`List<T>`),而未按照实际类型设置对应的`collection`属性时,可能导致`<foreach>`无法正常工作。 例如,在参数为`List<T>`的情况下,应将`collection="list"`作为默认值[^3]。如果不指定此值或者拼写错误,则会引发异常或无数据返回。 对于其他类型的参数,需注意以下几点: - 如果参数是数组,则应该设定`collection="array"`; - 若参数为Map,则需要通过键名访问其内部存储的数据集,比如`collection="keyName"`; - 当传入的是自定义POJO对象且该对象包含一个列表字段时,应当指明具体字段名称作为`collection`的值,形如`collection="propertyName"`。 #### 2. **SQL映射文件配置有误** 另一个常见的问题是XML配置文件内的语法书写不符合规范。以下是几个需要注意的地方: - `item`: 表示当前迭代项的名字,默认情况下不需要额外处理。 - `index`(可选): 定义索引变量名,仅适用于某些特殊场景下的调试需求。 - `open`, `separator`, 和 `close`: 控制如何包裹整个表达式的起始字符、中间分隔符以及结束标记。这些选项必须合理搭配才能形成合法有效的最终查询字符串。 下面给出一段标准实现的例子来展示正确的做法: ```xml <select id="selectUsers" parameterType="java.util.List" resultType="User"> SELECT * FROM users WHERE user_id IN <foreach collection="list" index="idx" item="id" open="(" separator="," close=")"> #{id} </foreach> </select> ``` 上述代码片段展示了如何利用`<foreach>`构建带有IN子句的SELECT语句,并假设输入参数是一个整数ID组成的列表。其中每一轮循环都会替换占位符`${}`或`#{}`的内容以完成动态组装过程[^2]。 #### 3. **数据库驱动兼容性问题** 尽管这种情况较为少见,但如果使用的JDBC驱动版本较低也可能影响到复杂查询的支持程度。因此建议始终采用最新稳定版的连接器库并与目标RDBMS保持一致更新频率。 --- ### 总结解决方案 针对以上提到的各种可能性逐一排查即可定位根本原因所在。一般而言调整好函数签名形式及其关联的XML声明就能顺利解决问题。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值