foreach标签所能遍历的collection对象一共有三种类型,分别为List、array、Map三种。
先初略的看一个例子:
<delete id="deleteBatch">
delete from user where id in
<foreach collection="array" item="id" index="index" open="(" close=")" separator=",">
#{id}
</foreach>
</delete>
若假如传入的参数是一个数组 int[] ids = {1,2,3,4,5},那么打印之后的SQL如下:
delete form user where id in (1,2,3,4,5)
由这个例子,我们可以看到:
当传入的是一个array数组的时候,collection属性的值是array,
其item代表存储的元素,名字可以随便写但是要和后面的#{ }内的元素名相同,
而index是元素的索引位置,
open和close指定了sql语句中的括号,
其separator就指定了被遍历元素之间的分隔符逗号。———— 算下来foreach标签中共有6个属性
当然这个范例只能给人一点初略的理解。实际上要想真正熟悉完备的用法还得看更多的例子来总结。
下面我们从更多的例子中总结,而不是局限于文档中一系列抽象的描述里不知从何下手:
我们先讲List和数组(array)。——因为list和array在这里有相似的用法,而map则不一样,所以放在后面再讲。
List相关
传入的是list,且其中存储元素是基本数据类型包装类对象时:
映射文件:
<select id="dynamicForeachTest" resultType="Blog">
select * from t_blog where id in
<foreach collection="list" index="index" item="item" open="(" separator="," close=")">
#{item}
</foreach>
</select>
接口:
public List<Blog> dynamicForeachTest(List<Integer> ids);
测试代码:
@Test
public void dynamicForeachTest() {
SqlSession session = Util.getSqlSessionFactory().openSession();
BlogMapper blogMapper = session.getMapper(BlogMapper.class);
List<Integer> ids = new ArrayList<Integer>();
ids.add(1);
ids.add(3);
ids.add(6);
List<Blog> blogs = blogMapper.dynamicForeachTest(ids);
for (Blog blog : blogs)
System.out.println(blog);
session.close();
}
传入的是list,且其中存储元素是类对象时,此时我们要进行查询操作:
pojo:
public class User{
public Integer id;
public String name;
public String bestFriend;
public List<User> friendList;
//这里省略getter和setter
}
映射文件:
<select id="countByUserList" resultType="int" parameterType="list"> <!—传入的参数直接就是list-->
select count(*) from users
<where>
id in
<foreach item="item" collection="list" separator="," open="(" close=")" index="">
#{item.id, jdbcType=NUMERIC} <!—我们的遍历条件是user中的成员属性id-->
</foreach>
</where>
</select>
测试代码:
@Test
public void shouldHandleComplexNullItem() {
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
Mapper mapper = sqlSession.getMapper(Mapper.class);
User user1 = new User(); //创建一个对象
user1.setId(2);
user1.setName("User2");
List<User> users = new ArrayList<User>(); //创建一个user集合容器,并存入前面的user1和null两个对象
users.add(user1);
users.add(null);
int count = mapper.countByUserList(users); //传入的是集合list,其中的元素是实例对象user
Assert.assertEquals(1, count);
} finally {
sqlSession.close();
}
}
传入的是list,且其中存储元素是类对象,此时我们要进行新增操作:
pojo:
public class emp{
public String lastName;
public String email;
public String gender;
public Department dept;
}
映射文件:
<insert id="addEmps">
INSERT INTO tb1_emplyee(last_name,email,gender,d_id)
VALUES
<foreach collection="emps" item="emp" separator=",">
(#{emp.lastName},#{emp.email},#{emp.gender},#{emp.dept.id}) <!--在对象成员的基础上继续取其成员值-->
</foreach>
</insert>
对应的mapper接口:
public void addEmps(@Param("emps")List<Employee> emps);
测试方法:
@Test
public void testBatchSave() throws IOException{
SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
//1、获取到的SqlSession不会自动提交数据
SqlSession openSession = sqlSessionFactory.openSession();
try
{
EmployeeMapperDymanicSQL mapper=openSession.getMapper(EmployeeMapperDymanicSQL.class);
List<Employee> emps=new ArrayList<Employee>();
emps.add(new Employee(null,"Eminem","Eminem@126.com","1",new Department(1)));
emps.add(new Employee(null,"2Pac","2Pac@126.com","1",new Department(1)));
mapper.addEmps(emps);
openSession.commit();
}
finally {
openSession.close();
}
}
传入的是一般类的对象,只是其中包含有一个List类型的成员属性:
pojo:
public class QueryVo{
private User user;
private List<Integer> ids;
}
映射文件:
<!-- 根据ids查询用户 -->
<select id="queryUserByIds" parameterType="queryVo" resultType="user"> <!--parameterType就是对象所属类-->
SELECT * FROM `user`
<where>
<foreach collection="ids" item="item" open="id IN (" close=")" separator=","> <!--collection直接就是这个类中的List类型成员-->
#{item}
</foreach>
</where>
</select>
<!--传入的parameterType直接就是对象的所属类,而collection就是这个类中类型为List的成员属性ids-->
测试方法
public void testQueryUserByIds() {
// mybatis和spring整合,整合之后,交给spring管理
SqlSession sqlSession = this.sqlSessionFactory.openSession();
// 创建Mapper接口的动态代理对象,整合之后,交给spring管理
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 使用userMapper执行根据条件查询用户
QueryVo queryVo = new QueryVo();
List<Integer> ids = new ArrayList<>();
ids.add(1);
ids.add(10);
ids.add(24);
queryVo.setIds(ids);
List<User> list = userMapper.queryUserByIds(queryVo);
for (User u : list) {
System.out.println(u);
}
// mybatis和spring整合,整合之后,交给spring管理
sqlSession.close();
}
array相关
直接传入一个数组进行遍历查询
映射文件:
<select id="dynamicForeach2Test" resultType="Blog">
select * from t_blog where id in
<foreach collection="array" index="index" item="item" open="(" separator="," close=")">
#{item}
</foreach>
</select>
mapper接口:
public List<Blog> dynamicForeach2Test(int[] ids);
测试代码:
@Test
public void dynamicForeach2Test() {
SqlSession session = Util.getSqlSessionFactory().openSession();
BlogMapper blogMapper = session.getMapper(BlogMapper.class);
int[] ids = new int[] {1,3,6,9};
List<Blog> blogs = blogMapper.dynamicForeach2Test(ids);
for (Blog blog : blogs)
System.out.println(blog);
session.close();
}
将字符串处理成一个数组之后传入
字符串为:
String approveStatus = new String("通过,不通过");
映射文件:
<if test="approveStatus != null and approveStatus!=''">
and i.approve_status IN
<foreach collection="approveStatus.split(',')" item="status" open="(" separator="," close=")">
#{status}
</foreach>
</if>
map相关
传入一个map,其中包含了一个映射value是String类型,一个映射value是List集合类型。
映射文件:
<select id="dynamicForeach3Test" resultType="Blog">
select * from t_blog where title like "%"#{title}"%" and id in <!--key值为title的映射-->
<foreach collection="ids" index="index" item="item" open="(" separator="," close=")"> <!--key值为ids的list集合-->
#{item}
</foreach>
</select>
接口代码:
public List<Blog> dynamicForeach3Test(Map<String, Object> params);
测试方法:
@Test
public void dynamicForeach3Test() {
SqlSession session = Util.getSqlSessionFactory().openSession();
BlogMapper blogMapper = session.getMapper(BlogMapper.class);
final List<Integer> ids = new ArrayList<Integer>();
ids.add(1);
ids.add(2);
ids.add(3);
ids.add(6);
ids.add(7);
ids.add(9);
Map<String, Object> params = new HashMap<String, Object>();
params.put("ids", ids); //存入一个映射是List集合类型
params.put("title", "中国"); //另一个是String类型
List<Blog> blogs = blogMapper.dynamicForeach3Test(params);
for (Blog blog : blogs)
System.out.println(blog);
session.close();
}
由此例可见:传入的参数就是map对象中的key值,mapper的sql中的条件名称和map的key值名称一模一样。
利用一个map存入所有的查询条件
创建一个map对象,将后期需要查询到所有条件都存进去:
Map<String,Object> map = new HashMap<>(); //创建一个map容器
//将所有同类的条件都存进以下的集合或者赋给String对象
List<String> list = new ArrayList<>(); //Stirng集合
String aa = "aa"; //单个String类对象
List<实体> objlist = new ArrayList<>(); //自定义类对象集合
//将以上条件都存入map容器中
map.put("stringList",list);
map.put("aa",aa);
map.put("objList",list);
映射文件:(传入的parameterType属性的值肯定是map类型的,这样collection属性的值就能够直接写成map中的key值)
(collection属性的值,除了在传入map时,可以不用写成array或者list而是直接写成map中的key之外。
在传入自定义类的对象时,也可以可以不用写成array或者list而是直接写成类中数据类型是array或者list的成员属性名)
<!--String集合的情况-->
<if test="stringList!= null and stringList.size()>0">
<foreach collection="stringList" item="id">
OR A.ID=#{id}
</foreach>
</if>
<!--单个String类对象-->
<if test="aa != null and aa != ''">
AND A.ID=#{aa}
</if>
<!--自定义类对象集合-->
<if test="objList!= null and objList.size()>0">
<foreach collection="objList" item="obj"> OR A.ID=#{obj.id} </foreach> <!--在其中存储的对象的基础上继续取其成员属性的值-->
</if>
最后才放上抽象的参数说明,结合以上例子,应该能更好理解。
我们可以看到collection和item属性为必选,其他的为可选。