MyBatis3系列__04CRUD以及参数处理
本文将会简单介绍一下MyBatis的CRUD以及结合源码讲解一下MyBatis对参数的处理。
作为一个ORM框架，最基本的使用也就是CRUD了，MyBatis提供了两种方法：xml配置文件和动态注解。个人推荐xml配置文件，方式毕竟注解方式还是要将sql写在代码中，并且动态查询的时候还用嵌套script标签，相当麻烦，扯远了，回归主题。
1.CRUD
创建一个dao接口，定义方法：
package com.mybatis.learn.dao;
import com.mybatis.learn.bean.Employee;
public interface EmployeeMapper {
public Employee getEmpById(Integer id);
public int addEmployee(Employee employee);
public boolean updateEmployeeById(Employee employee);
public void deleteEmployeeById(Integer id);
}
创建一个xml文件并在其中编写sql语句，注意将Mapper与xml文件进行绑定(在mybatis-config.xml文件中使用Mapper标签)。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.mybatis.learn.dao.EmployeeMapper">
<!--
resultType:指定查询结果的返回值类型；MyBatis会自动创建一个ResultMap对象，
然后基于查找出来的属性名进行键值对封装，看到返回类型是Blog对象，
从ResultMap中取出与Blog对象对应的键值对进行赋值。
resultMap:原理同上，当提供的返回类型是resultMap时，因为Map不能很好表示领域模型，
就需要自己再进一步的把它转化为对应的对象，这常常在复杂查询中很有作用。
-->
<select id="getEmpById" resultType="com.mybatis.learn.bean.Employee">
select id, last_name lastName, gender, email from tbl_employee where id = #{id}
</select>
<!--
useGeneratedKeys: true为使用主键绑定，
keyProerty: 指定主键，
parameterKey: 指定参数类型
-->
<insert id="addEmployee" parameterType="com.mybatis.learn.bean.Employee"
statementType="PREPARED" useGeneratedKeys="true" keyProperty="id">
insert into tbl_employee (last_name, gender, email) values (#{lastName}, #{gender}, #{email})
</insert>
<update id="updateEmployeeById" parameterType="com.mybatis.learn.bean.Employee">
update tbl_employee set last_name=#{lastName}, gender=#{gender}, email=#{email} where id=#{id}
</update>
<delete id="deleteEmployeeById" parameterType="java.lang.Integer">
delete from tbl_employee where id=#{id}
</delete>
</mapper>
其中， 各自方法的标签见文知意。需要注意的是，namespace写你的Mapper类的全类名，然后各自的方法中的id填写你的方法名，从而完成了绑定。
2.参数处理
要是只能一句话概括的话，MyBatis会将参数封装为一个map，这是结论，下面详细说明：
大致分为两种情况：
1.单个参数且没有@param注解时：
MyBatis不会进行特殊处理（看上去，其实这种情况只是处理的一种解决方案，后面结合源码会详细介绍），即：#{参数名/任意名}：取出参数值。注意，#{}中不一定要是准确的参数名，比如错把id写成了iddd一样可以运行，因为MyBatis只是取出对应位置的值而已。
2.多个参数或者单个参数有@param注解时：
MyBatis会将参数封装成一个map：
key：param1...paramN,或者参数的索引也可以
value：传入的参数值
#{}就是从map中获取指定的key的值；
在MyBatis处理参数过程中，可能会抛出的异常：（当你写成#{id}并且没有加上@param（“id”）时）
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}
当然，当你的参数过多时，建议你传入的参数为一个POJO,这样就无需使用@param，也能正常传参。
#{属性名}：取出传入的pojo的属性值 。
而当没有对应的POJO时，也可以直接传入一个map，反正MyBatis也会封装一个map，你只需在存入
map时指定号key和value就行了。
如果多个参数不是业务模型中的数据，但是经常要使用，推荐来编写一个TO（Transfer Object）数据
传输对象
Page{
int index;
int size;
}
OK，相信你大致明白了，来搞一下练习吧：
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]}
Ok，现在贴一下部分源码，我加了一点注解：
(@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;
}
}
}
一点补充：
$ 和#的不同：
// #{}是一般情况都使用的，在MyBatis预编译sql的时候会将对应的#{参数名}替换为？，还能防止sql注入。
// ${}的存在也是有价值的，虽然会引起sql注入，但是能解决一些#{}无法搞定的场景，比如排序，表名字等等，举例如下：
@Select("select * from user where ${column} = #{value}")
User findByColumn(@Param("column") String column, @Param("value") String value);
//其中 ${column} 会被直接替换，而 #{value} 会被使用 ? 预处理.
#{}:更丰富的用法：
规定参数的一些规则：
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"/>
