Mybatis引數處理總結

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

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

   異常：
   org.apache.ibatis.binding.BindingException:
   Parameter 'id' not found.
   Available parameters are [1, 0, param1, param2]
   操作：
       方法：public Employee getEmpByIdAndLastName(Integer id,String lastName);
       取值：#{id},#{lastName}

【命名引數】：明確指定封裝引數時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的；
//1、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();
//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]: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;
}
}
}
===========================引數值的獲取======================================
#{}：可以獲取map中的值或者pojo物件屬性的值；
${}：可以獲取map中的值或者pojo物件屬性的值；

select * from tbl_employee where id=${id} and last_name=#{lastName}
Preparing: select * from tbl_employee where id=2 and last_name=?
   區別：
       #{}:是以預編譯的形式，將引數設定到sql語句中；PreparedStatement；防止sql注入
       ${}:取出的值直接拼裝在sql語句中；會有安全問題；
       大多情況下，我們去引數的值都應該去使用#{}；

       原生jdbc不支援佔位符的地方我們就可以使用${}進行取值
       比如分表、排序。。。；按照年份分表拆分
           select * from ${year}_salary where xxx;
           select * from tbl_employee order by ${f_name} ${order}

#{}:更豐富的用法：
   規定引數的一些規則：
   javaType、 jdbcType、 mode（儲存過程）、 numericScale、
   resultMap、 typeHandler、 jdbcTypeName、 expression（未來準備支援的功能）；

   jdbcType通常需要在某種特定的條件下被設定：
       在我們資料為null的時候，有些資料庫可能不能識別mybatis對null的預設處理。比如Oracle（報錯）；

       JdbcType OTHER：無效的型別；因為mybatis對所有的null都對映的是原生Jdbc的OTHER型別，oracle不能正確處理;

       由於全域性配置中：jdbcTypeForNull=OTHER；oracle不支援；兩種辦法
       1、#{email,jdbcType=OTHER};
       2、jdbcTypeForNull=NULL
           <setting name="jdbcTypeForNull" value="NULL"/>

Mybatis引數處理總結

相關文章