Mybatis 之List<?>传参的注意事项和原理

Mybatis 如果是传List<?>作为参数的话，SQL语句要用到foreach。

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

我们来看看 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，该参数可选。

重点是这句话：要做foreach的对象，作为入参时，List<?>对象默认用list代替作为键，数组对象有array代替作为键，Map对象没有默认的键。
当然在作为入参时可以使用@Param("keyName")来设置键，设置keyName后，list,array将会失效。

如果传参时不用 @Param("keyName")来设置键，那么List<?>对象默认键 是list，如果集合List 类名不是list，就会报错：参数找不到；

示例：

dao层：

void batchInsert(List<OrderItem> orderItemList);

mapper层：

<foreach collection="orderItemList" index="index" item="item" separator=",">

这样写就会 报错！！

正确 的写法：

void batchInsert(@Param("orderItemList") List<OrderItem> orderItemList);

Map对象没有默认的键，所以一定要用@Param("keyName")来设置键。

List很容易忽视，所以也要格外重视。我就花了几个小时，仅仅因为这个 @Param("keyName")注解。