Insight mybatis 的参数处理，list、array、@param

mabatis 对于方法参数(list、array、@param )总是思路是：all in one封装（Map结构）。主要用于动态sql解析和执行sql参数注入。

另外，ParameterHandler.setParameters 为了便于ps.setParameter(...) mybatis 必须以唯一的对象包装入参，也就是说有两种情况处理：

1.无入参或者有一个入参，则透传（list、array入参特例）；

2.有两个以上的入参，以map结构包装，透传。

---

参考源码：

// 入参封装实现， @Param 多参数以map形式体现（n in 1, hahaha）
public Object convertArgsToSqlCommandParam(Object[] args) {
    final int paramCount = params.size();
    if (args == null || paramCount == 0) {
        return null;
    } else if (!hasNamedParameters && paramCount == 1) {
        return args[params.keySet().iterator().next()];
    } else {
        final Map param = new ParamMap();
        for (Map.Entry entry : params.entrySet()) {
            param.put(entry.getValue(), args[entry.getKey()]);
        }
        return param;
    }
}

// 对于List、Array的入参，mybatis约定封装至对应的map中，其余的原始对象或者自定义对象透传
private Object wrapCollection(final Object object) {
    if (object instanceof List) {
        StrictMap map = new StrictMap();
        map.put("list", object);
        return map;
    } else if (object != null && object.getClass().isArray()) {
        StrictMap map = new StrictMap();
        map.put("array", object);
        return map;
    }
    return object;
}

备注：对象包装入参使用

// MetaObject 包装入参，遍历parameterMappings，完成ps 入参set
public void setParameters(PreparedStatement ps) throws SQLException {
    List parameterMappings = boundSql.getParameterMappings();
    if (parameterMappings != null) {
        MetaObject metaObject = parameterObject == null ? null : configuration.newMetaObject(parameterObject);
        for (int i = 0; i < parameterMappings.size(); i++) {
            ParameterMapping parameterMapping = parameterMappings.get(i);
            value = metaObject == null ? null : metaObject.getValue(propertyName);
            TypeHandler typeHandler = parameterMapping.getTypeHandler();
            JdbcType jdbcType = parameterMapping.getJdbcType();
            if (value == null && jdbcType == null) jdbcType = configuration.getJdbcTypeForNull();
            typeHandler.setParameter(ps, i + 1, value, jdbcType);
        }
    }
}