foreach一共有三种类型,分别为List,[](array),Map三种。
foreach所包含的属性:
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等于什么,就看你想对那个元素做循环。 该参数为必选。 |
index | 在list和数组中,index是元素的序号;在map中,index是元素的key。该参数可选。 |
open | foreach代码的开始符号,一般是(和close=")"合用。常用在in(),values()时。该参数可选。 |
separator | 元素之间的分隔符,例如在in()的时候,separator=","会自动在元素中间用“,“隔开,避免手动输入逗号导致sql错误,如in(1,2,)这样,如果循环的是select语句,该属性也可写"union"、"union all"、"or"、"and"等.该参数可选。 |
close | foreach代码的关闭符号,一般是)和open="("合用。常用在in(),values()时。该参数可选。 |
示例一:
<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>
其SQL为:select count(*) from users WHERE id in ( ? , ? )
示例二:
<select id="selectJobPlanState" parameterType="java.util.List" resultType="String">
select * from (
<foreach collection="list" item="jobPlanCodes" separator="union all">
SELECT RUNSTATE
FROM (SELECT DECODE(RUNSTATE, '0', '运行中', '1', '已完成', '等待')RUNSTATE
FROM CF_JOBRUNLOG
WHERE JOBPLANCODE = #{jobPlanCodes}
ORDER BY SERIALNO DESC)
WHERE ROWNUM = '1'
</foreach>
) A
</select>
其SQL为:
select runstate from (select decode(runstate,'0','运行中','1','已完成','等待')runstate from cf_jobrunlog where jobplancode =#{jobpalncode} order by serialno desc)
union all
select runstate from (select decode(runstate,'0','运行中','1','已完成','等待')runstate from cf_jobrunlog where jobplancode =#{jobpalncode} order by serialno desc)
union all
... ...
示例三:
map和List,array相比,map是用K,V存储的,在foreach中,使用map时,index属性值为map中的Key的值。
因为map中的Key不同于list,array中的索引,所以会有更丰富的用法。
<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>
可以看到这个例子相当简单,表中需要两个值,正好和K,V对应,因而map中的一个K,V就对应一条数据,如果map中有多个K,V,就会保存多个结果。
如果map中有两对K,V,那么执行SQL如下:
DEBUG [main] - ==> Preparing: insert into string_string (key, value) values (?, ?) , (?, ?)
DEBUG [main] - ==> Parameters: key 1(String), value 1(String), key 2(String), value 2(String)
DEBUG [main] - <== Updates: 2
最后,如果不考虑元素的顺序和map中Key,map和list,array可以拥有一样的效果,都是存储了多个值,然后循环读取出来。