mybatis传入和返回参数解析

悠悠 2023-09-27 19:26 112阅读 0赞

## 一、传参 ##

### 1.1、一个参数 ###

<select id="getUserByName" parameterType="string" resultMap="BaseResultMap">
      select * from t_user where `name` = #{value}
    </select>

### 1.2、传入Map对象 ###

> 多个参数时，传递Map对象，以key作为参数名称，value作为参数值。

*  map参数

Map<String, Object> map = new HashMap<>();
    map.put("id", 2L);
    map.put("name", "啦啦啦");
    List<TUser> users = userDao.getUserByMap(map);

*  ql获取参数

<select id="getUserByMap" parameterType="map" resultMap="BaseResultMap">
      select * from t_user where `id` = #{id} OR `name` = #{name}
    </select>

### 1.3、传入javaBean对象 ###

> 参数传递依靠javaBean的字段属性来区分。取值与Map集合相似，传参受到javaBean的字段类型类型限制。

*  javaBean对象创建

UserDto dto = UserDto.builder().id(1L).name("啦啦啦").build();
    List<TUser> users = userDao.getUserByDtoBean(dto);

*  sql参数获取

<select id="getUserByDtoBean" parameterType="entity.UserDto" resultMap="BaseResultMap">
        select * from t_user where `id` = #{id} OR `name` = #{name}
    </select>

### 1.4、多个参数传参 ###

> dao层方法需要多个参数时，若是没有使用mybatis的@Param注解，直接调用方法，Mybatis解析XML文件时会将参数名称解析为arg1, arg0…, param1, param2…  
> 这样的参数名，sql的xml文件使用与dao层方法一样的名称是无法解析的。需要在dao层方法上增加@Param注解，指定解析时应该映射成的参数名。

1、dao层接口方法，未加@Param注解  
`List<TUser> getUserByParams(Long id, String name);`  
2、sal参数获取

<select id="getUserByParams" resultMap="BaseResultMap">
        select * from t_user where `id` = #{id} OR `name` = #{name}
    </select>

3、执行结果报错

### Error querying database.  Cause: org.apache.ibatis.binding.BindingException: Parameter 'id' not found. Available parameters are [arg1, arg0, param1, param2]
    ### Cause: org.apache.ibatis.binding.BindingException: Parameter 'id' not found. Available parameters are [arg1, arg0, param1, param2]

4、调整dao层的接口方法，增加注解@Param

List<TUser> getUserByParams(@Param("id") Long id, @Param("name") String name);

### 1.5、传递List集合 ###

> dao层接口中若是没有使用@Param注解，XML文件的sql直接使用list进行判断，若是使用了@Param注解对参数进行命名，要严格按照@Param注解的命名来。

1、dao层方法  
`List<TUser> getUserByList( List idlist);`  
2、参数拼接

List<Long> ids = Arrays.asList(1L, 2L);
    List<TUser> users = userDao.getUserByList(ids);

3、sql参数获取

<select id="getUserByList" parameterType="list" resultMap="BaseResultMap">
      select * from t_user where
      <if test="list != null and list.size() > 0">
        `id` IN
        <foreach collection="list" index="index" close=")" open="(" item="id" separator=",">
          #{id}
        </foreach>
      </if>
    </select>

## 二、传参源码解析 ##

Debug启动测试方法，在dao层接口方法上打上断点，step into跟进方法，可以发现参数解析的源码在org.apache.ibatis.reflection.ParamNameResolver的构造方法ParamNameResolver上，这里会根据@Param注解（有@Param注解时优先使用注解的值作为参数名称），没有的话会解析为arg0、arg1…的参数名称列表。

public ParamNameResolver(Configuration config, Method method) {
        
        Class<?>[] paramTypes = method.getParameterTypes();
        Annotation[][] paramAnnotations = method.getParameterAnnotations();
        SortedMap<Integer, String> map = new TreeMap();
        int paramCount = paramAnnotations.length;
    
        for(int paramIndex = 0; paramIndex < paramCount; ++paramIndex) {
        
            if (!isSpecialParameter(paramTypes[paramIndex])) {
        
                String name = null;
                Annotation[] var9 = paramAnnotations[paramIndex];
                int var10 = var9.length;
    
                for(int var11 = 0; var11 < var10; ++var11) {
        
                    Annotation annotation = var9[var11];
                    if (annotation instanceof Param) {
        
                        this.hasParamAnnotation = true;
                        name = ((Param)annotation).value();
                        break;
                    }
                }
    
                if (name == null) {
        
                    if (config.isUseActualParamName()) {
        
                        name = this.getActualParamName(method, paramIndex);
                    }
    
                    if (name == null) {
        
                        name = String.valueOf(map.size());
                    }
                }
    
                map.put(paramIndex, name);
            }
        }
    
        this.names = Collections.unmodifiableSortedMap(map);
    }

初步解析成arg0、arg1…参数名列表后，后续在执行MapperMethod的executeForMany、executeForCursor等方法的时候会通过如下的这行代码对参数名做进一步的转换，具体还是调用了org.apache.ibatis.reflection.ParamNameResolver的getNamedParams(args)方法。

public Object getNamedParams(Object[] args) {
        
        final int paramCount = names.size();
        if (args == null || paramCount == 0) {
        
          return null;
        } else if (!hasParamAnnotation && paramCount == 1) {
        
          return args[names.firstKey()];
        } else {
        
          final Map<String, Object> param = new ParamMap<Object>();
          int i = 0;
          for (Map.Entry<Integer, String> entry : names.entrySet()) {
        
            param.put(entry.getValue(), args[entry.getKey()]);
            // add generic param names (param1, param2, ...)
            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;
        }
      }

## 三、数据返回 ##