Mybatis（3）——參數處理

單個參數：mybatis不會作特殊處理，
#{參數名/任意名}：取出參數值。

多個參數：mybatis會作特殊處理。
多個參數會被封裝成 一個map，
key：param1...paramN,或者參數的索引也能夠
value：傳入的參數值
#{}就是從map中獲取指定的key的值；

命名參數：明確指定封裝參數時map的key；@Param("id")
多個參數會被封裝成 一個map，
key：使用@Param註解指定的值
value：參數值
#{指定的key}取出對應的參數值

POJO：
若是多個參數正好是咱們業務邏輯的數據模型，咱們就能夠直接傳入pojo；
#{屬性名}：取出傳入的pojo的屬性值

Map：
若是多個參數不是業務模型中的數據，沒有對應的pojo，不常常使用，爲了方便，咱們也能夠傳入map
#{key}：取出map中對應的值

TO：
若是多個參數不是業務模型中的數據，可是常常要使用，推薦來編寫一個TO（Transfer Object）數據傳輸對象
Page{
int index;
int size;
}

========================思考================================
public Employee getEmp(@Param("id")Integer id,String lastName);
取值：id==>#{id/param1} lastName==>#{param2}

public Employee getEmp(Integer id,@Param("e")Employee emp);
取值：id==>#{param1} lastName===>#{param2.lastName/e.lastName}

##特別注意：若是是Collection（List、Set）類型或者是數組，
也會特殊處理。也是把傳入的list或者數組封裝在map中。
key：Collection（collection）,若是是List還可使用這個key(list)
數組(array)
public Employee getEmpById(List<Integer> ids);
取值：取出第一個id的值： #{list[0]}

========================結合源碼，mybatis怎麼處理參數==========================

總結：參數多時會封裝map，爲了避免混亂，咱們可使用@Param來指定封裝時使用的key；
#{key}就能夠取出map中的值；
(@Param("id")Integer id,@Param("lastName")String lastName);
ParamNameResolver解析參數封裝map的；
//一、names：{0=id, 1=lastName}；構造器的時候就肯定好了
    肯定流程：
    1.獲取每一個標了param註解的參數的@Param的值：id，lastName；  賦值給name;
    2.每次解析一個參數給map中保存信息：（key：參數索引，value：name的值）
        name的值：
            標註了param註解：註解的值
            沒有標註：
                1.全局配置：useActualParamName（jdk1.8）：name=參數名
                2.name=map.size()；至關於當前元素的索引
    {0=id, 1=lastName,2=2}
args【1，"Tom",'hello'】:
public Object getNamedParams(Object[] args) {
    final int paramCount = names.size();
    //一、參數爲null直接返回
    if (args == null || paramCount == 0) {
      return null;
    //二、若是隻有一個元素，而且沒有Param註解；args[0]：單個參數直接返回
    } else if (!hasParamAnnotation && paramCount == 1) {
      return args[names.firstKey()];
    //三、多個元素或者有Param標註
    } else {
      final Map<String, Object> param = new ParamMap<Object>();
      int i = 0;
      //四、遍歷names集合；{0=id, 1=lastName,2=2}
      for (Map.Entry<Integer, String> entry : names.entrySet()) {
          //names集合的value做爲key;  names集合的key又做爲取值的參考args[0]:args【1，"Tom"】:
          //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;
    }
  }
}