mybatis?foreach?屬性及其三種使用情況詳解

更新時(shí)間：2022年01月12日 11:24:48 作者：不只Java

這篇文章主要介紹了mybatis?foreach?屬性及其三種使用情況詳解，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

foreach 屬性介紹

foreach 用于迭代傳入過(guò)來(lái)的參數(shù)。

它的屬性介紹分別是

collection：表示傳入過(guò)來(lái)的參數(shù)的數(shù)據(jù)類型。該參數(shù)為必選。要做 foreach 的對(duì)象，作為入?yún)r(shí)，List 對(duì)象默認(rèn)用 list 代替作為鍵，數(shù)組對(duì)象有 array 代替作為鍵，Map 對(duì)象沒(méi)有默認(rèn)的鍵。當(dāng)然在作為入?yún)r(shí)可以使用 @Param(“keyName”) 來(lái)設(shè)置鍵，設(shè)置 keyName 后，list,array 將會(huì)失效。除了入?yún)⑦@種情況外，還有一種作為參數(shù)對(duì)象的某個(gè)字段的時(shí)候。舉個(gè)例子：如果 User 有屬性 List ids。入?yún)⑹?User 對(duì)象，那么這個(gè) collection = “ids” 如果 User 有屬性 Ids ids;其中 Ids 是個(gè)對(duì)象，Ids 有個(gè)屬性 List id;入?yún)⑹?User 對(duì)象，那么 collection = “ids.id”

如果傳入的是單參數(shù)且參數(shù)類型是一個(gè) List 的時(shí)候，collection 屬性值為 list

如果傳入的是單參數(shù)且參數(shù)類型是一個(gè) array 數(shù)組的時(shí)候，collection 的屬性值為 array

如果傳入的參數(shù)是多個(gè)的時(shí)候，我們就需要把它們封裝成一個(gè) Map 了，當(dāng)然單參數(shù)也可以封裝成 map。

item：循環(huán)體中的具體對(duì)象。支持屬性的點(diǎn)路徑訪問(wèn)，如 item.age,item.info.details。具體說(shuō)明：在 list 和數(shù)組中是其中的對(duì)象，在 map 中是 value，該參數(shù)為必選。（它是每一個(gè)元素進(jìn)行迭代時(shí)的別名）
index：在 list 和數(shù)組中,index 是元素的序號(hào)；在 map 中，index 是元素的 key。
open：表示該語(yǔ)句以什么開始
close：表示該語(yǔ)句以什么結(jié)束
separator：表示在每次進(jìn)行迭代之間以什么符號(hào)作為分隔符

介紹完屬性之后，下面就進(jìn)入實(shí)踐。首先先來(lái)看一個(gè)簡(jiǎn)單到爆炸的表（表名：t_test_foreach）

這里寫圖片描述

單參數(shù)是 array 類型

測(cè)試類

// ids = {1,2,3}
public List<User> testFindByArray(int[] ids) throws Exception {
? ? SqlSession sqlSession = getSession().openSession();
? ? userList = sqlSession.selectList(NameSpace + ".findByArray", ids);
? ? System.out.println(userList.toString());
? ? sqlSession.close();
? ? return userList;
}

mapper.xml

<!--這里的 item 值可以和傳遞過(guò)來(lái)的參數(shù)名不一樣，在介紹屬性的時(shí)候已經(jīng)說(shuō)過(guò)這是一個(gè)別名了。比如可以修改成如下代碼：
? ? <foreach collection="array" item="id" index="index" open="(" close=")" separator=",">
? ? ? ? #{id} ? <!--這里要和 item 值保持一致-->
? ? </foreach>
-->
<select id="findByArray" resultType="com.test.foreach.User">
? ? SELECT id,`name` FROM t_test_foreach WHERE id IN
? ? <foreach collection="array" item="ids" index="index" open="(" close=")" separator=",">
? ? ? ? #{ids}
? ? </foreach>
</select>

輸出結(jié)果

DEBUG - ==> Preparing: SELECT id,`name` FROM t_test_foreach WHERE id IN ( ? , ? , ? )
DEBUG - ==> Parameters: 1(Integer), 2(Integer), 3(Integer)
DEBUG - <== Total: 3
[User{name='n1', id='1'}, User{name='n2', id='2'}, User{name='n3', id='3'}]

單參數(shù)是 List 類型

測(cè)試類

// List 元素有 1，3，5
public List<User> testFindByList(List<Integer> ids) throws Exception {
? ? SqlSession sqlSession = getSession().openSession();
? ? userList = sqlSession.selectList(NameSpace + ".findByList", ids);
? ? System.out.println(userList.toString());
? ? sqlSession.close();
? ? return userList;
}

mapper.xml

<select id="findByList" resultType="com.test.foreach.User">
? ? SELECT id,`name` FROM t_test_foreach WHERE id IN
? ? <foreach collection="list" item="ids" index="index" open="(" close=")" separator=",">
? ? ? ? #{ids}
? ? </foreach>
</select>

輸出結(jié)果

DEBUG - ==> Preparing: SELECT id,`name` FROM t_test_foreach WHERE id IN ( ? , ? , ? )
DEBUG - ==> Parameters: 1(Integer), 3(Integer), 5(Integer)
DEBUG - <== Total: 3
[User{name='n1', id='1'}, User{name='n3', id='3'}, User{name='n5', id='5'}]

單參數(shù)是 Map 類型

測(cè)試類

// Map<String, Object> 中的元素有 int[] ids = {2, 4};map.put("ids", ids);
public List<User> testFindByMap(Map map) throws Exception {
? ? SqlSession sqlSession = getSession().openSession();
? ? System.out.println(map.toString());
? ? List<Object> objects = sqlSession.selectList(NameSpace + ".findByMap", map);
? ? System.out.println(objects.toString());
? ? sqlSession.close();
? ? return userList;
}

mapper.xml

<!--注意 collection 值是 ids，即要進(jìn)行迭代的對(duì)象。覺(jué)得有點(diǎn)懵的伙伴可以回到最開始介紹 collection 屬性那里看看,不要急-->
<select id="findByMap" resultType="com.test.foreach.User">
? ? SELECT id,`name` FROM t_test_foreach WHERE id IN
? ? <foreach collection="ids" item="id" index="index" open="(" close=")" separator=",">
? ? ? ? #{id}
? ? </foreach>
</select>

輸出結(jié)果

DEBUG - ==> Preparing: SELECT id,`name` FROM t_test_foreach WHERE id IN ( ? , ? )
DEBUG - ==> Parameters: 2(Integer), 4(Integer)
DEBUG - <== Total: 2
[User{name='n2', id='2'}, User{name='n4', id='4'}]

多參數(shù)

這種情況在傳參數(shù)時(shí)，一定要改用 Map 方式

測(cè)試類

public void testUpdateByParams(int[] ids,String name) throws Exception {
? ? SqlSession sqlSession = getSession().openSession();
? ? Map<String,Object> map = new HashMap<String, Object>();
? ? map.put("ids",ids); // ids = {1,2,4}
? ? map.put("name",name);// name = "updated"
? ? sqlSession.selectList(NameSpace + ".findByParams", map);
? ? sqlSession.close();
}

mapper.xml

<select id="findByParams">
? ? UPDATE t_test_foreach SET `name` = '#{name}' WHERE id IN
? ? <foreach collection="ids" item="item" index="index" open="(" close=")" separator=",">
? ? ? ? #{item}
? ? </foreach>
</select>

輸出結(jié)果

DEBUG - ==> Preparing: UPDATE t_test_foreach SET `name` = ? WHERE id IN ( ? , ? , ? )
DEBUG - ==> Parameters: updated(String), 1(Integer), 2(Integer), 4(Integer)

這里寫圖片描述