在使用MyBatis時(shí)，有兩種使用方法。一種是使用的接口形式，另一種是通過SqlSession調(diào)用命名空間。這兩種方式在傳遞參數(shù)時(shí)是不一樣的，命名空間的方式更直接，但是多個(gè)參數(shù)時(shí)需要我們自己創(chuàng)建Map作為入?yún)ⅰＯ啾榷?，使用接口形式更簡單?/p>

接口形式的參數(shù)是由MyBatis自己處理的。如果使用接口調(diào)用，入?yún)⑿枰?jīng)過額外的步驟處理入?yún)ⅲ缶秃兔臻g方式一樣了。

在MapperMethod.Java會(huì)首先經(jīng)過下面方法來轉(zhuǎn)換參數(shù)：

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<String, Object> param = new ParamMap<Object>();
 int i = 0;
 for (Map.Entry<Integer, String> entry : params.entrySet()) {
 param.put(entry.getValue(), args[entry.getKey()]);
 // issue #71, add param names as param1, param2...but ensure backward compatibility
 final String genericParamName = "param" + String.valueOf(i + 1);
 if (!param.containsKey(genericParamName)) {
 param.put(genericParamName, args[entry.getKey()]);
 }
 i++;
 }
 return param;
 }
}

在這里有個(gè)很關(guān)鍵的params，這個(gè)參數(shù)類型為Map<Integer, String> ，他會(huì)根據(jù)接口方法按順序記錄下接口參數(shù)的定義的名字，如果使用@Param指定了名字，就會(huì)記錄這個(gè)名字，如果沒有記錄，那么就會(huì)使用它的序號(hào)作為名字。

例如有如下接口：

List<User> select(@Param('sex')String sex,Integer age);

那么他對(duì)應(yīng)的params如下:

{
 0:'sex',
 1:'1'
}

繼續(xù)看上面的convertArgsToSqlCommandParam方法，這里簡要說明3種情況：

• 入?yún)閚ull或沒有時(shí)，參數(shù)轉(zhuǎn)換為null
• 沒有使用@Param注解并且只有一個(gè)參數(shù)時(shí)，返回這一個(gè)參數(shù)
• 使用了@Param注解或有多個(gè)參數(shù)時(shí)，將參數(shù)轉(zhuǎn)換為Map1類型，并且還根據(jù)參數(shù)順序存儲(chǔ)了key為param1,param2的參數(shù)。
  

注意：從第3種情況來看，建議各位有多個(gè)入?yún)⒌臅r(shí)候通過@Param指定參數(shù)名，方便后面（動(dòng)態(tài)sql）的使用。

經(jīng)過上面方法的處理后，在MapperMethod中會(huì)繼續(xù)往下調(diào)用命名空間方式的方法：

Object param = method.convertArgsToSqlCommandParam(args);
result = sqlSession.<E>selectList(command.getName(), param);

從這之后開始按照統(tǒng)一的方式繼續(xù)處理入?yún)ⅰ?/p>

處理集合

不管是selectOne還是selectMap方法，歸根結(jié)底都是通過selectList進(jìn)行查詢的，不管是delete還是insert方法，都是通過update方法操作的。在selectList和update中所有參數(shù)的都進(jìn)行了統(tǒng)一的處理。

在DefaultSqlSession.java中的wrapCollection方法：

private Object wrapCollection(final Object object) {
 if (object instanceof Collection) {
 StrictMap<Object> map = new StrictMap<Object>();
 map.put("collection", object);
 if (object instanceof List) {
 map.put("list", object);
 }
 return map; 
 } else if (object != null && object.getClass().isArray()) {
 StrictMap<Object> map = new StrictMap<Object>();
 map.put("array", object);
 return map;
 }
 return object;
}

這里特別需要注意的一個(gè)地方是map.put("collection", object) ，這個(gè)設(shè)計(jì)是為了支持Set類型，需要等到MyBatis 3.3.0版本才能使用。

wrapCollection處理的是只有一個(gè)參數(shù)時(shí)，集合和數(shù)組的類型轉(zhuǎn)換成Map2類型，并且有默認(rèn)的Key，從這里你能大概看到為什么<foreach>中默認(rèn)情況下寫的array和list（Map類型沒有默認(rèn)值map）。

參數(shù)的使用

參數(shù)的使用分為兩部分：

• 第一種就是常見#{username}或者${username} 。
• 第二種就是在動(dòng)態(tài)SQL中作為條件，例如<if test="username!=null and username !=''"> 。
  

下面對(duì)這兩種進(jìn)行詳細(xì)講解，為了方便理解，先講解第二種情況。

在動(dòng)態(tài)SQL條件中使用參數(shù)

關(guān)于動(dòng)態(tài)SQL的基礎(chǔ)內(nèi)容可以查看官方文檔。

動(dòng)態(tài)SQL為什么會(huì)處理參數(shù)呢？

主要是因?yàn)閯?dòng)態(tài)SQL中的<if> , <bind> , <foreache>都會(huì)用到表達(dá)式，表達(dá)式中會(huì)用到屬性名，屬性名對(duì)應(yīng)的屬性值如何獲取呢？獲取方式就在這關(guān)鍵的一步。不知道多少人遇到Could not get property xxx from xxxClass或: Parameter ‘xxx' not found. Available parameters are[…] ，都是不懂這里引起的。

在DynamicContext.java中，從構(gòu)造方法看起：

public DynamicContext(Configuration configuration, Object parameterObject) {
 if (parameterObject != null && !(parameterObject instanceof Map)) {
 MetaObject metaObject = configuration.newMetaObject(parameterObject);
 bindings = new ContextMap(metaObject);
 } else {
 bindings = new ContextMap(null);
 }
 bindings.put(PARAMETER_OBJECT_KEY, parameterObject);
 bindings.put(DATABASE_ID_KEY, configuration.getDatabaseId());
}

這里的Object parameterObject就是我們經(jīng)過前面兩步處理后的參數(shù)。這個(gè)參數(shù)經(jīng)過前面兩步處理后，到這里的時(shí)候，他只有下面三種情況：

• null，如果沒有入?yún)⒒蛘呷雲(yún)⑹莕ull，到這里也是null。
• Map類型，除了null之外，前面兩步主要是封裝成Map類型。
• 數(shù)組、集合和Map以外的Object類型，可以是基本類型或者實(shí)體類。

看上面構(gòu)造方法，如果參數(shù)是1,2情況時(shí)，執(zhí)行代碼bindings = new ContextMap(null);參數(shù)是3情況時(shí)執(zhí)行if中的代碼。我們看看ContextMap類，這是一個(gè)內(nèi)部靜態(tài)類，代碼如下：

static class ContextMap extends HashMap<String, Object> {
 private MetaObject parameterMetaObject;
 public ContextMap(MetaObject parameterMetaObject) {
 this.parameterMetaObject = parameterMetaObject;
 }
 public Object get(Object key) {
 String strKey = (String) key;
 if (super.containsKey(strKey)) {
 return super.get(strKey);
 }
 if (parameterMetaObject != null) {
 // issue #61 do not modify the context when reading
 return parameterMetaObject.getValue(strKey);
 }
 return null;
 }
}

我們先繼續(xù)看DynamicContext的構(gòu)造方法，在if/else之后還有兩行：

bindings.put(PARAMETER_OBJECT_KEY, parameterObject);
bindings.put(DATABASE_ID_KEY, configuration.getDatabaseId());

其中兩個(gè)Key分別為：

public static final String PARAMETER_OBJECT_KEY = "_parameter";
public static final String DATABASE_ID_KEY = "_databaseId";

也就是說1,2兩種情況的時(shí)候，參數(shù)值只存在于"_parameter"的鍵值中。3情況的時(shí)候，參數(shù)值存在于"_parameter"的鍵值中，也存在于bindings本身。

當(dāng)動(dòng)態(tài)SQL取值的時(shí)候會(huì)通過OGNL從bindings中獲取值。MyBatis在OGNL中注冊(cè)了ContextMap:

static {
 OgnlRuntime.setPropertyAccessor(ContextMap.class, new ContextAccessor());
}

當(dāng)從ContextMap取值的時(shí)候，會(huì)執(zhí)行ContextAccessor中的如下方法：

@Override
public Object getProperty(Map context, Object target, Object name)
 throws OgnlException {
 Map map = (Map) target;

 Object result = map.get(name);
 if (map.containsKey(name) || result != null) {
 return result;
 }

 Object parameterObject = map.get(PARAMETER_OBJECT_KEY);
 if (parameterObject instanceof Map) {
 return ((Map)parameterObject).get(name);
 }

 return null;
}

參數(shù)中的target就是ContextMap類型的，所以可以直接強(qiáng)轉(zhuǎn)為Map類型。

參數(shù)中的name就是我們寫在動(dòng)態(tài)SQL中的屬性名。

下面舉例說明這三種情況：

1、null的時(shí)候：

不管name是什么（name="_databaseId"除外，可能會(huì)有值），此時(shí)Object result = map.get(name);得到的result=null。

在Object parameterObject = map.get(PARAMETER_OBJECT_KEY);中parameterObject=null，因此最后返回的結(jié)果是null。

在這種情況下，不管寫什么樣的屬性，值都會(huì)是null，并且不管屬性是否存在，都不會(huì)出錯(cuò)。

2、Map類型：

此時(shí)Object result = map.get(name);一般也不會(huì)有值，因?yàn)閰?shù)值只存在于"_parameter"的鍵值中。

然后到Object parameterObject = map.get(PARAMETER_OBJECT_KEY); ，此時(shí)獲取到我們的參數(shù)值。

在從參數(shù)值((Map)parameterObject).get(name)根據(jù)name來獲取屬性值。

在這一步的時(shí)候，如果name屬性不存在，就會(huì)報(bào)錯(cuò)：

throw new BindingException("Parameter '" + key + "' not found. Available parameters are " + keySet());

name屬性是什么呢，有什么可選值呢？這就是處理接口形式的入?yún)⒑吞幚砑咸幚砗笏鶕碛械腒ey。

如果你遇到過類似異常，相信看到這兒就明白原因了。

3、數(shù)組、集合和Map以外的Object類型：

這種類型經(jīng)過了下面的處理：

MetaObject metaObject = configuration.newMetaObject(parameterObject);
bindings = new ContextMap(metaObject);

MetaObject是MyBatis的一個(gè)反射類，可以很方便的通過getValue方法獲取對(duì)象的各種屬性（支持集合數(shù)組和Map，可以多級(jí)屬性點(diǎn).訪問，如user.username,user.roles[1].rolename） 。

現(xiàn)在分析這種情況。

首先通過name獲取屬性時(shí)Object result = map.get(name); ，根據(jù)上面ContextMap類中的get方法：

public Object get(Object key) {
String strKey = (String) key;
if (super.containsKey(strKey)) {
 return super.get(strKey);
}
if (parameterMetaObject != null) {
 return parameterMetaObject.getValue(strKey);
}
return null;
}

可以看到這里會(huì)優(yōu)先從Map中取該屬性的值，如果不存在，那么一定會(huì)執(zhí)行到下面這行代碼：

return parameterMetaObject.getValue(strKey)

如果name剛好是對(duì)象的一個(gè)屬性值，那么通過MetaObject反射可以獲取該屬性值。如果該對(duì)象不包含name屬性的值，就會(huì)報(bào)錯(cuò)：

throw new ReflectionException("Could not get property '" + prop.getName() + "' from " + object.getClass() + ". Cause: " + t.toString(), t);

理解這三種情況后，使用動(dòng)態(tài)SQL應(yīng)該不會(huì)有參數(shù)名方面的問題了。

在SQL語句中使用參數(shù)

SQL中的兩種形式#{username}或者${username} ，雖然看著差不多，但是實(shí)際處理過程差別很大，而且很容易出現(xiàn)莫名其妙的錯(cuò)誤。

${username}的使用方式為OGNL方式獲取值，和上面的動(dòng)態(tài)SQL一樣，這里先說這種情況。

${propertyName}參數(shù)

在TextSqlNode.java中有一個(gè)內(nèi)部的靜態(tài)類BindingTokenParser，現(xiàn)在只看其中的handleToken方法：

@Override
public String handleToken(String content) {
 Object parameter = context.getBindings().get("_parameter");
 if (parameter == null) {
 context.getBindings().put("value", null);
 } else if (SimpleTypeRegistry.isSimpleType(parameter.getClass())) {
 context.getBindings().put("value", parameter);
 }
 Object value = OgnlCache.getValue(content, context.getBindings());
 String srtValue = (value == null ? "" : String.valueOf(value)); // issue #274 return "" instead of "null"
 checkInjection(srtValue);
 return srtValue;
}

從put("value"這個(gè)地方可以看出來，MyBatis會(huì)創(chuàng)建一個(gè)默認(rèn)為"value"的值，也就是說，在xml中的SQL中可以直接使用${value}，從else if可以看出來，只有是簡單類型的時(shí)候，才會(huì)有值。

關(guān)于這點(diǎn)，舉個(gè)簡單例子，如果接口為List<User> selectOrderby(String column) ，如果xml內(nèi)容為：

<select id="selectOrderby" resultType="User">
select * from user order by ${value}
</select>

這種情況下，雖然沒有指定一個(gè)value屬性，但是MyBatis會(huì)自動(dòng)把參數(shù)column賦值進(jìn)去。

再往下的代碼：

Object value = OgnlCache.getValue(content, context.getBindings());
String srtValue = (value == null ? "" : String.valueOf(value));

這里和動(dòng)態(tài)SQL就一樣了，通過OGNL方式來獲取值。

看到這里使用OGNL這種方式時(shí)，你有沒有別的想法？

特殊用法：你是否在SQL查詢中使用過某些固定的碼值？一旦碼值改變的時(shí)候需要改動(dòng)很多地方，但是你又不想把碼值作為參數(shù)傳進(jìn)來，怎么解決呢？你可能已經(jīng)明白了。

就是通過OGNL的方式，例如有如下一個(gè)碼值類：

package com.abel533.mybatis;
public interface Code{
 public static final String ENABLE = "1";
 public static final String DISABLE = "0";
}

如果在xml，可以這么使用：

<select id="selectUser" resultType="User">
 select * from user where enable = ${@com.abel533.mybatis.Code@ENABLE}
</select>

除了碼值之外，你可以使用OGNL支持的各種方法，如調(diào)用靜態(tài)方法。

#{propertyName}參數(shù)

這種方式比較簡單，復(fù)雜屬性的時(shí)候使用的MyBatis的MetaObject。

在DefaultParameterHandler.java中：

public void setParameters(PreparedStatement ps) throws SQLException {
 ErrorContext.instance().activity("setting parameters").object(mappedStatement.getParameterMap().getId());
 List<ParameterMapping> parameterMappings = boundSql.getParameterMappings();
 if (parameterMappings != null) {
 for (int i = 0; i < parameterMappings.size(); i++) {
  ParameterMapping parameterMapping = parameterMappings.get(i);
  if (parameterMapping.getMode() != ParameterMode.OUT) {
  Object value;
  String propertyName = parameterMapping.getProperty();
  if (boundSql.hasAdditionalParameter(propertyName)) { // issue #448 ask first for additional params
   value = boundSql.getAdditionalParameter(propertyName);
  } else if (parameterObject == null) {
   value = null;
  } else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {
   value = parameterObject;
  } else {
   MetaObject metaObject = configuration.newMetaObject(parameterObject);
   value = 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);
  }
 }
 }
}

上面這段代碼就是從參數(shù)中取#{propertyName}值的方法，這段代碼的主要邏輯就是if/else判斷的地方，單獨(dú)拿出來分析：

if (boundSql.hasAdditionalParameter(propertyName)) { // issue #448 ask first for additional params
 value = boundSql.getAdditionalParameter(propertyName);
} else if (parameterObject == null) {
 value = null;
} else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {
 value = parameterObject;
} else {
 MetaObject metaObject = configuration.newMetaObject(parameterObject);
 value = metaObject.getValue(propertyName);
}

首先看第一個(gè)if，當(dāng)使用<foreach>的時(shí)候，MyBatis會(huì)自動(dòng)生成額外的動(dòng)態(tài)參數(shù)，如果propertyName是動(dòng)態(tài)參數(shù)，就會(huì)從動(dòng)態(tài)參數(shù)中取值。

第二個(gè)if，如果參數(shù)是null，不管屬性名是什么，都會(huì)返回null。

第三個(gè)if，如果參數(shù)是一個(gè)簡單類型，或者是一個(gè)注冊(cè)了typeHandler的對(duì)象類型，就會(huì)直接使用該參數(shù)作為返回值，和屬性名無關(guān)。

最后一個(gè)else，這種情況下是復(fù)雜對(duì)象或者M(jìn)ap類型，通過反射方便的取值。

下面我們說明上面四種情況下的參數(shù)名注意事項(xiàng)。

1、動(dòng)態(tài)參數(shù)，這里的參數(shù)名和值都由MyBatis動(dòng)態(tài)生成的，因此我們沒法直接接觸，也不需要管這兒的命名。但是我們可以了解一下這兒的命名規(guī)則，當(dāng)以后錯(cuò)誤信息看到的時(shí)候，我們可以確定出錯(cuò)的地方。
在ForEachSqlNode.java中：

private static String itemizeItem(String item, int i) {
return new StringBuilder(ITEM_PREFIX).append(item).append("_").append(i).toString();
}

其中ITEM_PRFIX為public static final String ITEM_PREFIX = "__frch_"; 。

如果在<foreach>中的collection="userList" item="user" , 那么對(duì)userList循環(huán)產(chǎn)生的動(dòng)態(tài)參數(shù)名就是:

__frch_user_0,__frch_user_1,__frch_user_2…

如果訪問動(dòng)態(tài)參數(shù)的屬性，如user.username會(huì)被處理成__frch_user_0.username ，這種參數(shù)值的處理過程在更早之前解析SQL的時(shí)候就已經(jīng)獲取了對(duì)應(yīng)的參數(shù)值。具體內(nèi)容看下面有關(guān)<foreach>的詳細(xì)內(nèi)容。

2、參數(shù)為null，由于這里的判斷和參數(shù)名無關(guān)，因此入?yún)ull的時(shí)候，在xml中寫的#{name}不管name寫什么，都不會(huì)出錯(cuò)，值都是null。

3、可以直接使用typeHandler處理的類型。最常見的就是基本類型，例如有這樣一個(gè)接口方法User selectById(@Param("id")Integer id) ，在xml中使用id的時(shí)候，我們可以隨便使用屬性名，不管用什么樣的屬性名，值都是id。

4、復(fù)雜對(duì)象或者M(jìn)ap類型一般都是我們需要注意的地方，這種情況下，就必須保證入?yún)@些屬性，如果沒有就會(huì)報(bào)錯(cuò)。這一點(diǎn)和可以參考上面有關(guān)MetaObject的地方。

<foreach>詳解

所有動(dòng)態(tài)SQL類型中， <foreach>似乎是遇到問題最多的一個(gè)。

例如有下面的方法：

<insert id="insertUserList">
 INSERT INTO user(username,password)
 VALUES
 <foreach collection="userList" item="user" separator=",">
 (#{user.username},#{user.password})
 </foreach>
</insert>

對(duì)應(yīng)的接口：

int insertUserList(@Param("userList")List<User> list);

我們通過foreach源碼，看看MyBatis如何處理上面這個(gè)例子。

在ForEachSqlNode.java中的apply方法中的前兩行：

Map<String, Object> bindings = context.getBindings();
final Iterable<?> iterable = evaluator.evaluateIterable(collectionExpression, bindings);

這里的bindings參數(shù)熟悉嗎？上面提到過很多。經(jīng)過一系列的參數(shù)處理后，這兒的bindings如下：

{
 "_parameter":{
 "param1":list,
 "userList":list
 },
 "_databaseId":null,
}

collectionExpression就是collection="userList"的值userList。

我們看看evaluator.evaluateIterable如何處理這個(gè)參數(shù)，在ExpressionEvaluator.java中的evaluateIterable方法：

public Iterable<?> evaluateIterable(String expression, Object parameterObject) {
 Object value = OgnlCache.getValue(expression, parameterObject);
 if (value == null) {
  throw new BuilderException("The expression '" + expression + "' evaluated to a null value.");
 }
 if (value instanceof Iterable) {
  return (Iterable<?>) value;
 }
 if (value.getClass().isArray()) {
  int size = Array.getLength(value);
  List<Object> answer = new ArrayList<Object>();
  for (int i = 0; i < size; i++) {
   Object o = Array.get(value, i);
   answer.add(o);
  }
  return answer;
 }
 if (value instanceof Map) {
  return ((Map) value).entrySet();
 }
 throw new BuilderException("Error evaluating expression '" + expression + "'. Return value (" + value + ") was not iterable.");
}

首先通過看第一行代碼：

Object value = OgnlCache.getValue(expression, parameterObject);

這里通過OGNL獲取到了userList的值。獲取userList值的時(shí)候可能出現(xiàn)異常，具體可以參考上面動(dòng)態(tài)SQL部分的內(nèi)容。

userList的值分四種情況。

• value == null，這種情況直接拋出異常BuilderException。
• value instanceof Iterable，實(shí)現(xiàn)Iterable接口的直接返回，如Collection的所有子類，通常是List。
• value.getClass().isArray()數(shù)組的情況，這種情況會(huì)轉(zhuǎn)換為List返回。
• value instanceof Map如果是Map，通過((Map) value).entrySet()返回一個(gè)Set類型的參數(shù)。

通過上面處理后，返回的值，是一個(gè)Iterable類型的值，這個(gè)值可以使用for (Object o : iterable)這種形式循環(huán)。

在ForEachSqlNode中對(duì)iterable循環(huán)的時(shí)候，有一段需要關(guān)注的代碼：

if (o instanceof Map.Entry) {
 @SuppressWarnings("unchecked") 
 Map.Entry<Object, Object> mapEntry = (Map.Entry<Object, Object>) o;
 applyIndex(context, mapEntry.getKey(), uniqueNumber);
 applyItem(context, mapEntry.getValue(), uniqueNumber);
} else {
 applyIndex(context, i, uniqueNumber);
 applyItem(context, o, uniqueNumber);
}

如果是通過((Map) value).entrySet()返回的Set，那么循環(huán)取得的子元素都是Map.Entry類型，這個(gè)時(shí)候會(huì)將mapEntry.getKey()存儲(chǔ)到index中，mapEntry.getValue()存儲(chǔ)到item中。

如果是List，那么會(huì)將序號(hào)i存到index中，mapEntry.getValue()存儲(chǔ)到item中。

<foreach>常見錯(cuò)誤補(bǔ)充

當(dāng)collection="userList"的值userList中的User是一個(gè)繼承自Map的類型時(shí)，你需要保證<foreach>循環(huán)中用到的所有對(duì)象的屬性必須存在，Map類型存在的問題通常是，如果某個(gè)值是null，一般是不存在相應(yīng)的key，這種情況會(huì)導(dǎo)致<foreach>出錯(cuò)，會(huì)報(bào)找不到__frch_user_x參數(shù)。所以這種情況下，就是值是null，你也需要map.put(key,null) 。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，這篇文章真的非常有用，如果你對(duì)Mybatis有一定的了解，這篇文章幾乎是必讀的一篇。希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作能帶來一定的幫助，如有疑問大家可以留言交流，謝謝大家對(duì)腳本之家的支持。