| Option | Description | 
|---|---|
| item | 循环体中的具体对象。支持属性的点路径访问,如item.age,item.info.details。具体说明:在list和数组中是其中的对象,在map中是value。该参数为必选。 | 
| collection | 要做foreach的对象,作为入参时,List<?>对象默认用list代替作为键,数组对象有array代替作为键,Map对象用map代替作为键。当然在作为入参时可以使用@Param(“keyName”)来设置键,设置keyName后,list,array,map将会失效。 除了入参这种情况外,还有一种作为参数对象的某个字段的时候。举个例子:如果User有属性List ids。入参是User对象,那么这个collection = “ids”如果User有属性Ids ids;其中Ids是个对象,Ids有个属性List id;入参是User对象,那么collection = “ids.id”上面只是举例,具体collection等于什么,就看你想对那个元素做循环。该参数为必选。 | 
| separator | 元素之间的分隔符,例如在in()的时候,separator=”,”会自动在元素中间用“,“隔开,避免手动输入逗号导致sql错误,如in(1,2,)这样。该参数可选。 | 
| open | foreach代码的开始符号,一般是(和close=”)”合用。常用在in(),values()时。该参数可选。 | 
| close | foreach代码的关闭符号,一般是)和open=”(“合用。常用在in(),values()时。该参数可选。 | 
| index | 在list和数组中,index是元素的序号,在map中,index是元素的key,该参数可选。 | 
select count(*) from users WHERE id in ( ? , ? )1
2
3
4
5
6
7
8
9<select id="countByUserList" resultType="_int" parameterType="list">    
select count(*) from users    
  <where>    
    id in    
    <foreach item="item" collection="list" separator="," open="(" close=")" index="">    
      #{item.id, jdbcType=NUMERIC}    
    </foreach>    
  </where>    
</select>
insert into deliver select ?,? from dual union all select ?,? from dual1
2
3
4
5
6
7
8
9
10
11
12
13<insert id="addList">  
    INSERT INTO DELIVER  
        (  
            <include refid="selectAllColumnsSql"/>  
         )  
      <foreach collection="deliverList" item="item" separator="UNION ALL">  
            SELECT   
                 #{item.id, jdbcType=NUMERIC},  
                 #{item.name, jdbcType=VARCHAR}  
            FROM DUAL  
      </foreach>  
</insert>
insert into string_string (key, value) values (?, ?) , (?, ?) 1
2
3
4
5<insert id="ins_string_string">    
    insert into string_string (key, value) values    
    <foreach item="item" index="key" collection="map"    
        open="" separator="," close="">(#{key}, #{item})</foreach>    
</insert>
select count(*) from key_cols where col_a = ? AND col_b = ?1
2
3
4
5<select id="sel_key_cols" resultType="int">    
    select count(*) from key_cols where    
    <foreach item="item" index="key" collection="map"    
        open="" separator="AND" close="">${key} = #{item}</foreach>    
</select>
ps: 一定要注意到$和#的区别,$的参数直接输出,#的参数会被替换为?,然后传入参数值执行。