快捷導(dǎo)航

Mybatis傳遞List集合方式

更新時(shí)間：2025年07月23日 15:46:43 作者：jushisi

MyBatis傳遞List參數(shù)時(shí),若XML變量名不匹配默認(rèn)的"list"鍵,會(huì)報(bào)錯(cuò),需通過(guò)@Param指定名稱、使用collection屬性或索引方式正確引用

第一種

參數(shù)是常規(guī)的List, 但是xml變量名不是list------報(bào)錯(cuò)

完整錯(cuò)誤如下：

org.apache.ibatis.binding.BindingException: Parameter ‘customerIdList’ not found. Available parameters are [collection, list]

解釋：

當(dāng)我們傳遞一個(gè) List 實(shí)例或者數(shù)組作為參數(shù)對(duì)象傳給 MyBatis。
當(dāng)你這么做的時(shí) 候,MyBatis 會(huì)自動(dòng)將它包裝在一個(gè) Map 中,用名稱在作為鍵。
List 實(shí)例將會(huì)以“list” 作為鍵,而數(shù)組實(shí)例將會(huì)以“array”作為鍵。
所以，當(dāng)我們傳遞的是一個(gè)List集合時(shí)，mybatis會(huì)自動(dòng)把我們的list集合包裝成以list為Key值的map。

DAO 層：
Long selectCustomerCountList(List customerIdList);
 
XML文件：
<select id="selectCustomerCountList" parameterType="java.util.List" resultType="java.lang.Long">
    select count(1) from np_customer_info where id in
    <foreach item="item" collection="customerIdList" separator="," open="(" close=")" index="">
    	#{item, jdbcType=INTEGER}   
    </foreach>
</select>

======================
注意：DAO 層接口的參數(shù)名與XML 文件中的collection的屬性值一致，是導(dǎo)致的問(wèn)題的主要原因。

第二種

參數(shù)是常規(guī)的List, xml變量名是list------正常

利用Mybatis給我們的封裝進(jìn)行XML配置，將我們的XML中collection屬性值設(shè)置為list。

DAO 層：
Long selectCustomerCountList( List customerIdList);
 
XML文件：
<select id="selectCustomerCountList" parameterType="java.util.List" resultType="java.lang.Long">
    select count(1) from np_customer_info where id in
    <foreach item="item" collection="list" separator="," open="(" close=")" index="">
    	#{item, jdbcType=INTEGER}   
    </foreach>
</select>
    
======================
注意：此時(shí)collection強(qiáng)制指定為list且不可改變

第三種

利用注解@Param指定入?yún)ist的名稱------正常

DAO層：
Long selectCustomerCountList(@Param("customerIdList") List customerIdList);
 
XML文件：
<select id="selectCustomerCountList" parameterType="java.util.List" resultType="java.lang.Long">
    select count(1) from np_customer_info where id in
    <foreach item="item" collection="customerIdList" separator="," open="(" close=")" index="">  
    	#{item, jdbcType=INTEGER}   
    </foreach>
</select>
 
======================
注意： 此時(shí)的DAO層參數(shù)名可以 @Param("customerIdList") 與 collection的屬性值一致

第四種

將List包裝成Map參數(shù)進(jìn)行傳遞------正常

在Service業(yè)務(wù)處理層次上面將參數(shù)進(jìn)行包裝
public Long selectCustomerCountMap(List customerIdList) {  
    Map maps = new HashMap();
    maps.put("customerIds", customerIdList);
    return customerMapper.selectCustomerCountMap(maps);
}
   
DAO層：
Long selectCustomerCountMap(Map maps);
    
XML文件：
<select id="selectCustomerCountMap" parameterType="java.util.Map" resultType="java.lang.Long">
    select count(1) from np_customer_info where id in
    <foreach item="item" collection="customerIds" separator="," open="(" close=")" index="">
    	#{item, jdbcType=INTEGER}   
    </foreach>
</select>
    
==============
注意： 入?yún)㈩愋褪莏ava.util.Map而不再是List ,此時(shí)的collection屬性值為Map中的Key值。

第五種

把List 放入一個(gè)Bean對(duì)象中 ------報(bào)錯(cuò)

Model層(Bean層):
public class CompanyQueryModel {
    private String companyType;
    private List<String> customsCodeList; 
}

DAO層:
List<CompanyResultModel> selectCompanyInfo (CompanyQueryModel companyQueryModel);

XML層:
<select id="selectCompanyInfo" parameterType="com..dto.CompanyQueryModel" resultType="com.dto.CompanyResultModel">
    select * from np_company_info 
	<if test="customsCodeList != null and customsCodeList.size() > 0">
        and v.CUSTOMS_CODE in
        <foreach item="item" index="index" collection="customsCodeList" open="(" separator="," close=")">
            #{item}
        </foreach>
	</if>
</select>

第六種

把List 放入一個(gè)Bean對(duì)象中,利用@Param指定入?yún)ean名稱,Xml取Bean.List------正常

Model層(Bean層):
public class CompanyQueryModel {
    private String companyType;
    private List<String> customsCodeList; 
}

DAO層:
List<CompanyResultModel> selectCompanyInfo(@Param("model") CompanyQueryModel companyQueryModel);

XML層:
<select id="selectCompanyInfo" parameterType="com..dto.CompanyQueryModel" resultType="com.dto.CompanyResultModel">
    select * from np_company_info 
	<if test="model.customsCodeList != null and model.customsCodeList.size() > 0">
        and v.CUSTOMS_CODE in
        <foreach item="item" index="index" collection="model.customsCodeList" open="(" separator="," close=")">
            #{item}
        </foreach>
    </if>
</select>

第七種

把List 放入一個(gè)Bean對(duì)象中, XML不用#{item} 改為 #{tagIds[${index}]}

這中寫法意思是,取這個(gè)數(shù)組中的每一個(gè)，因?yàn)樽侄问荓ist。

Bean層:
public class AlarmConditionDTO {
    private List<String> orgIds;  
    private List<String> tagIds;   
    private String alertType;
}

DAO層:
List<Map<String,String>> selectDeviceCountByCondition(AlarmConditionDTO alarmConditionDTO);

XML層:
<select id="selectDeviceCountByCondition" resultType="java.util.Map">
    SELECT * from md_tag_target_relation_device 
    where 1=1
    <if test="tagIds != null and tagIds.size()>0">
        and tag_id IN
        <foreach collection="orgIds" index="index" open="(" close=")" separator="," item="item">
            #{tagIds[${index}],jdbcType=VARCHAR}
        </foreach>
    </if>
    <if test="orgIds != null and orgIds.size()>0">
        and d.region_code IN
        <foreach collection="orgIds" index="index" open="(" close=")" separator="," item="item">
            #{orgIds[${index}],jdbcType=VARCHAR}
        </foreach>
    </if>