Mybatis动态sql中@Param使用详解

Mybatis中的@param注解的使用场景：

1、方法有多个参数
2、方法参数要取别名
3、XML 中的 SQL 使用了 $
4、动态sql中参数是非自定义pojo类型

当方法的参数为非自定义pojo类型，且使用了动态sql，需要在参数前加上@Param注解。

问题1:动态sql中参数是非自定义pojo类型不使用@param注解会怎么样？

不使用时报错：here is no getter for property named ‘name’ in 'class （非自定义pojo类没有目标属性的get方法）

问题2:动态sql中参数是非自定义pojo类型使用@param注解有什么作用，为什么就解决了报错

mybatis处理参数的源码

public Object getNamedParams(Object[] args) {
    final int paramCount = names.size();
    //1、参数为null直接返回
    if (args == null || paramCount == 0) {
      return null;
     
    //2、如果只有一个元素，并且没有Param注解；args[0]：单个参数直接返回
    } else if (!hasParamAnnotation && paramCount == 1) {
      return args[names.firstKey()];
      
    //3、多个元素或者有Param标注
    } else {
      final Map<String, Object> param = new ParamMap<Object>();
      int i = 0;
      
      //4、遍历names集合；{0=id, 1=lastName,2=2}
      for (Map.Entry<Integer, String> entry : names.entrySet()) {
      
      	//names集合的value作为key;  names集合的key又作为取值的参考args[0]:
      	//eg:{id=args[0]:1,lastName=args[1]:Tom,2=args[2]}
        param.put(entry.getValue(), args[entry.getKey()]);
        
        
        // add generic param names (param1, param2, ...)param
        //额外的将每一个参数也保存到map中，使用新的key：param1...paramN
        //效果：有Param注解可以#{指定的key}，或者#{param1}
        final String genericParamName = GENERIC_NAME_PREFIX + String.valueOf(i + 1);
        // ensure not to overwrite parameter named with @Param
        if (!names.containsValue(genericParamName)) {
          param.put(genericParamName, args[entry.getKey()]);
        }
        i++;
      }
      return param;
    }
  }
}

确定流程：
	1.获取每个标了param注解的参数的@Param的值：xx，yy；  赋值给name;
	2.每次解析一个参数给map中保存信息：（key：参数索引，value：name的值）
　name的值：
	　　标注了param注解：注解的值
		　　没有标注：1.全局配置：useActualParamName（jdk1.8）：name=参数名
　　　　　　　2.name=map.size()；相当于当前元素的索引

总结：使用@Param时会封装map，map.entry可以get map的key/value键值对，有了目标属性的get方法，解决了报错