单个参数:
对于单个参数,mybatis不会做处理,#{参数名}:取出参数值
多个参数:
多个参数会被封装成一个map
public Employee getEmpByIdAndLastName(Integer id,String lastName);
封装成的map的key是param1,param2...paramN或者参数的索引
封装成的map的value是传入的参数值
取值时可以用#{param1},#{param2}...
可以通过@param注解指定封装map时的key
public Employee getEmpByIdAndLastName(@param("id")Integer id,@param("lastName")String lastName);
通过注解指定后,取值时可以直接#{注解指定的值}这样取值(#{id})
POJO
传入的参数是个对象
public void add(@param("employee")Employee employee);
取值时可以#{employee.属性名},这样取出传入的pojo的属性值
Map
如果参数是一个map,可以直接#{key}来取出对应的值
如果传入的参数是一个Collection(List、Set)类型或者是数组,mybatis会做特殊处理。
也是把传入的list或者数组封装在map中。
如果是Collection,key为collection,如果是List,其中也可以用#{list}取值
如果是数组,则key为array
public Employee getEmpById(List<Integer> ids);
取值:取出第一个id的值: #{list[0]}
推荐所有参数都应@param来指定key
ParamNameResolver类解析参数封装map的;
public Employee getEmpByIdAndLastName(@param("id")Integer id,@param("lastName")String lastName);
//构造器主要是为了构建一个names:key为参数的索引,value为参数的名字,{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();相当于当前元素的索引
构建好的names为:{0=id, 1=lastName}
*/
public ParamNameResolver(Configuration config, Method method) {
final Class<?>[] paramTypes = method.getParameterTypes();
final Annotation[][] paramAnnotations = method.getParameterAnnotations();
final SortedMap<Integer, String> map = new TreeMap<Integer, String>();
int paramCount = paramAnnotations.length;
// get names from @Param annotations
for (int paramIndex = 0; paramIndex < paramCount; paramIndex++) {
if (isSpecialParameter(paramTypes[paramIndex])) {
// skip special parameters
continue;
}
String name = null;
for (Annotation annotation : paramAnnotations[paramIndex]) {
if (annotation instanceof Param) {
hasParamAnnotation = true;
name = ((Param) annotation).value();
break;
}
}
if (name == null) {
// @Param was not specified.
if (config.isUseActualParamName()) {
name = getActualParamName(method, paramIndex);
}
if (name == null) {
// use the parameter index as the name ("0", "1", ...)
// gcode issue #71
name = String.valueOf(map.size());
}
}
map.put(paramIndex, name);
}
names = Collections.unmodifiableSortedMap(map);
}
args【2,"bing"】:
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}
for (Map.Entry<Integer, String> entry : names.entrySet()) {
//names集合的value作为key; names集合的key又作为取值的参考args[0]:args【2,"bing"】:
//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++;
}
/*
构建好的param为{"id":2,"lastName":"bing","param1":1,"param2":"bing"}
所以取参数时既可以#{id},也可以#{param1}
*/
return param;
}
}
}
#{}和${}的区别:
#{}:是以预编译的形式,将参数设置到sql语句中;PreparedStatement;防止sql注入
${}:取出的值直接拼装在sql语句中;会有安全问题;
大多情况下,我们去参数的值都应该去使用#{};
原生jdbc不支持占位符的地方我们就可以使用${}进行取值
比如分表、排序。。。
select * from ${year}_salary where xxx;
select * from tbl_employee order by ${order}
jdbcType:
在我们数据为null的时候,有些数据库可能不能识别mybatis对null的默认处理。比如Oracle(报错);
JdbcType OTHER:无效的类型;因为mybatis对所有的null都映射的是原生Jdbc的OTHER类型,oracle不能正确处理;
解决:
1、#{email,jdbcType=NULL};
2、jdbcTypeForNull默认是OTHER,可以改成NULL
<setting name="jdbcTypeForNull" value="NULL"/>