Mybatis 示例之 foreach

时间:2024-02-19 13:52:41

http://zz563143188.iteye.com/blog/1825168

http://pan.baidu.com/share/home?uk=4076915866&view=share#category/type=0

 

http://blog.csdn.net/gchonghavefun/article/details/8214223

在mybatis的mapper配置文件中,可以利用<foreach>标签实现sql条件的循环,可完成类似批量的sql

mybatis接受的参数分为:(1)基本类型(2)对象(3)List(4)数组(5)Map

 

无论传哪种参数给mybatis,他都会将参数放在一个Map中:

如果传入基本类型:变量名作为key,变量值作为value    此时生成的map只有一个元素。

如果传入对象:        对象的属性名作为key,属性值作为value,

如果传入List:         "list"作为key,这个List是value  (这类参数可以迭代,利用<foreach>标签实现循环)

如果传入数组:       "array"作为key,数组作为value(同上)

如果传入Map:        键值不变。

 

<foreach>标签的用法:

六个参数:

collection:要循环的集合

index:循环索引(不知道啥用。。)

item:集合中的一个元素(item和collection,按foreach循环理解)

open:以什么开始

close:以什么结束

separator:循环内容之间以什么分隔

例如:

[html] view plain copy
 
 print?
  1. <update id="pubS" parameterType="Map">  
  2.   UPDATE BMC_SUBPLATE  
  3.   SET PLSTATUS = \'02\'  
  4.   WHERE  
  5.   <foreach collection="ids" item="plid" open="" close="" separator="OR">  
  6.    PLID = #{plid}  
  7.   </foreach>  
  8.  </update>  

collection的值其实就是mybatis把参数转化成Map以后,这个Map的key,但是这个key对应的value必须是一个集合,  可以是数组,也可以是List

生成的动态sql:   

Executing: UPDATE BMC_SUBPLATE SET PLSTATUS = \'02\' WHERE PLID = ? OR PLID = ?                                

Parameters: 20121116144947537692(String), 20121116141301414855(String)

 

http://blog.csdn.net/isea533/article/details/21237175?locationNum=2

http://blog.csdn.net/isea533/article/details/22336991?locationNum=1

http://www.suyunyou.com/aid5.html

 

foreach一共有三种类型,分别为List,[](array),Map三种。

foreach的第一篇用来将List和数组(array)。

 

下面表格是我总结的各个属性的用途和注意点。

foreach属性

属性描述
item 循环体中的具体对象。支持属性的点路径访问,如item.age,item.info.details。
具体说明:在list和数组中是其中的对象,在map中是value。
该参数为必选。
collection 要做foreach的对象,作为入参时,List<?>对象默认用list代替作为键,数组对象有array代替作为键,Map对象没有默认的键。
当然在作为入参时可以使用@Param("keyName")来设置键,设置keyName后,list,array将会失效。 除了入参这种情况外,还有一种作为参数对象的某个字段的时候。举个例子:
如果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,该参数可选。

 

下面是测试。

SQL

 

[sql] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. drop table users if exists;  
  2.   
  3. create table users (  
  4.   id int,  
  5.   name varchar(20)  
  6. );  
  7.   
  8. insert into users (id, name) values(1, \'User1\');  
  9. insert into users (id, name) values(2, \'User2\');  
  10. insert into users (id, name) values(3, \'User3\');  
  11. insert into users (id, name) values(4, \'User4\');  
  12. insert into users (id, name) values(5, \'User5\');  
  13. insert into users (id, name) values(6, \'User6\');  

 

 

User类



Mapper.xml

 

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. <select id="countByUserList" resultType="_int" parameterType="list">  
  2. select count(*) from users  
  3.   <where>  
  4.     id in  
  5.     <foreach item="item" collection="list" separator="," open="(" close=")" index="">  
  6.       #{item.id, jdbcType=NUMERIC}  
  7.     </foreach>  
  8.   </where>  
  9. </select>  


测试代码:

 

 

[java] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. @Test  
  2. public void shouldHandleComplexNullItem() {  
  3. SqlSession sqlSession = sqlSessionFactory.openSession();  
  4. try {  
  5.   Mapper mapper = sqlSession.getMapper(Mapper.class);  
  6.   User user1 = new User();  
  7.   user1.setId(2);  
  8.   user1.setName("User2");  
  9.   List<User> users = new ArrayList<User>();  
  10.   users.add(user1);  
  11.   users.add(null);  
  12.   int count = mapper.countByUserList(users);  
  13.   Assert.assertEquals(1, count);  
  14. finally {  
  15.   sqlSession.close();  
  16. }  
  17. }  


测试日志:

 

DEBUG [main] - Logging initialized using \'class org.apache.ibatis.logging.slf4j.Slf4jImpl\' adapter.
DEBUG [main] - Opening JDBC Connection
DEBUG [main] - Setting autocommit to false on JDBC Connection [org.hsqldb.jdbc.JDBCConnection@4b83b34e]
DEBUG [main] - Resetting autocommit to true on JDBC Connection [org.hsqldb.jdbc.JDBCConnection@4b83b34e]
DEBUG [main] - Closing JDBC Connection [org.hsqldb.jdbc.JDBCConnection@4b83b34e]
DEBUG [main] - Opening JDBC Connection
DEBUG [main] - Setting autocommit to false on JDBC Connection [org.hsqldb.jdbc.JDBCConnection@763d1932]
DEBUG [main] - ==>  Preparing: select count(*) from users WHERE id in ( ? , ? ) 
DEBUG [main] - ==> Parameters: 2(Integer), null
DEBUG [main] - <==      Total: 1
DEBUG [main] - Resetting autocommit to true on JDBC Connection [org.hsqldb.jdbc.JDBCConnection@763d1932]
DEBUG [main] - Closing JDBC Connection [org.hsqldb.jdbc.JDBCConnection@763d1932]

 

 

上面这个例子是List的,但是和数组的情况基本一样,所以不针对数组进行测试了。可以看到这个例子的内容是很简单的,实际上List,array,map也可以互相嵌套,可以用多个foreach去执行,如果想看这样一个例子,可以移步这里:

新人求解问题哦,被卡了两天了,悲伤..

上面这个问题就遇到了list,map一起用的问题,3楼是问题的答案,可以参考一看。

 

由于map的key,value比较特殊,所以下次再说。

 

foreach是用来对3种类型的对象进行循环操作的,关于foreach的基础知识请看:Mybatis 示例之 foreach (上)

 

注:Map类型没有默认的map,所以不能直接写collection="map",如果这么写,需要保证传入的Map参数有@Param("map")注解。

有关参数的更详细内容,建议看:深入了解MyBatis参数

 

这节讲的是foreach中map的用法。

 

map和List,array相比,map是用K,V存储的,在foreach中,使用map时,index属性值为map中的Key的值。

 

因为map中的Key不同于list,array中的索引,所以会有更丰富的用法。

 

第一个简单例子:

 

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. <insert id="ins_string_string">  
  2.         insert into string_string (key, value) values  
  3.         <foreach item="item" index="key" collection="map"  
  4.             open="" separator="," close="">(#{key}, #{item})</foreach>  
  5.     </insert>  


可以看到这个例子相当简单,表中需要两个值,正好和K,V对应,因而map中的一个K,V就对应一条数据,如果map中有多个K,V,就会保存多个结果。

 

如果map中有两对K,V,那么执行SQL如下:

 

[plain] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. DEBUG [main] - ==>  Preparing: insert into string_string (key, value) values (?, ?) , (?, ?)   
  2. DEBUG [main] - ==> Parameters: key 1(String), value 1(String), key 2(String), value 2(String)  
  3. DEBUG [main] - <==    Updates: 2  


大部分数据库是支持values()()这种形式的插入语句,可以插入多条(相关链接 - 可能需FQ)。

 

 

下面再看一个select的例子:

 

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. <select id="sel_key_cols" resultType="int">  
  2.         select count(*) from key_cols where  
  3.         <foreach item="item" index="key" collection="map"  
  4.             open="" separator="AND" close="">${key} = #{item}</foreach>  
  5.     </select>  


可以看到这里用key=value来作为查询条件,对于动态的查询,这种处理方式可以借鉴。一定要注意到$和#的区别,$的参数直接输出,#的参数会被替换为?,然后传入参数值执行。

 

 

上述SQL执行日志如下:

 

[plain] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. DEBUG [main] - ==>  Preparing: select count(*) from key_cols where col_a = ? AND col_b = ?   
  2. DEBUG [main] - ==> Parameters: 22(Integer), 222(Integer)  
  3. DEBUG [main] - <==      Total: 1  



 

最后,如果不考虑元素的顺序和map中Key,map和list,array可以拥有一样的效果,都是存储了多个值,然后循环读取出来。

 

如果有这方面的问题,欢迎留言提问。若有宝贵意见,欢迎指出。