MyBatis学习笔记——MapperXML之增删改与参数处理(源码)

增删改

使用接口式编程，在接口中直接增加对应的方法。

public interface EmployeeMapper {

    public Employee getEmpById(Integer id);

    public Long addEmp(Employee emlpoyee);

    public Boolean updateEmp(Employee employee);

    public void deleteEmp(Integer id);
}

注意：mybatis允许增删改直接定义以下的类型返回值，Integer、Long、Boolean、Void，它会自动将返回结果封装成这边基本类型（封装类型）。
在映射文件中编写对应的sql语句：

  
  
  <insert id="addEmp" parameterType="com.shen.mybaties.bean.Employee">
    insert into tbl_employee (last_name,email,gender) 
    values (#{lastName},#{email},#{gender})
  insert>

    
    <update id="updateEmp">
        update tbl_employee 
        set last_name=#{lastName},email=#{email},gender=#{gender}
        where id = #{id} 
    update>

    
    <delete id="deleteEmp">
        delete from tbl_employee where id = #{id}
    delete>

编写对应的测试方法即可，有一点需要注意：
SqlSession openSession = sqlSessionFactory.openSession();获取的SqlSession默认是不会自动提交的，做完事务需要我们手动进行提交，即openSession.commit()。
当然也可以在获取的时候，使用sqlSessionFactory.openSession(true)来获取一个自动提交的SqlSession。

获取自增的主键值

在自增时，如果设置了自增的主键，该如何获取自动生成的值呢？
在JDBC中，用的是statement.getGenreatedKeys();MyBatis也是用的同样的方法,需要在映射文件中配置即可。

  
  
  
  <insert id="addEmp" parameterType="com.shen.mybaties.bean.Employee" useGeneratedKeys="true" 
  keyProperty="id">
    insert into tbl_employee (last_name,email,gender) 
    values (#{lastName},#{email},#{gender})
  insert>

在Java测试代码中，增加完成后，这个Bean对象即被更新，可以获取到自增逐渐的值。

    @Test
    public void testAdd() throws IOException {
        SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
        // 获取到的sqlSession不会自动提交数据
        SqlSession openSession = sqlSessionFactory.openSession();
        try {
            EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
            Employee employee = new Employee(null, "jerry", "[email protected]", "1");
            Long addEmpResult = mapper.addEmp(employee);
            if (addEmpResult != 0) {
                System.out.println("员工id:" + employee.getId());
            }
            // 手动提交
            openSession.commit();
        } finally {
            openSession.close();
        }
    }

新建时，员工Id为null，增加完成后，我们可以发现员工对象的id有值，即mybatis帮我们进行了主键设置。
注意：当事务rollback时，自增主键并不会回滚，依然会增长下去。

Oracle版本

    
    <insert id="addEmp" databaseId="oracle">
        
        <selectKey keyProperty="id" order="BEFORE" resultType="Integer">
            
            
            select EMPLOYEES_SEQ.nextval from dual 
            
        selectKey>

        
        
        insert into employees(EMPLOYEE_ID,LAST_NAME,EMAIL) 
        values(#{id},#{lastName},#{email}) 
        
    insert>

由于Oracle不支持自增主键，它使用序列模拟自增，mybatis有两种方式去获取主键，分为Before版本和After版本。
Before：查询序列的下一个值，赋值给JavaBean的Id，再插入。
After：使用序列的下一个值先插入，在使用查序列，查当前值。

参数处理（重要）

1. 单个参数：mybatis不做特殊处理。
   #{参数名}：取出参数值，但其实，只有单个参数，参数名随便写都可以取的到。

2. 多个参数：mybatis做特殊处理
   多个参数会被封装成一个map
   key：param1，……paramN，或者参数的索引也可以
   value：传入的参数值
   #{}就是从map中获取指定key的值
   异常：

    org.apache.ibatis.binding.BindingException: 
    Parameter 'id' not found. 
    Available parameters are [0, 1, param1, param2]

操作：
方法：public Employee getEmoByIdAndLastName(Integer id, String lastName);
取值：#{id},#{lastName}

推荐做法

1. 命名参数：明确定值封装参数时map的key，@Param("id")
   多个参数会被封装成一个map：
   key：使用@param注解指定的值
   value：参数值
   此时使用#{指定的key}取出对应的值。
2. POJO：
   如果多个参数正好是业务逻辑的数据模型，我们就直接传入POJO：
   /#{属性名}：取出传入的pojo的属性值。
3. Map：
   如果多个参数不是业务模型中的模型，没有对应的pojo，不经常使用，为了方便，我们也可以直接传入map。
   /#{key}：取出map中对应的值
4. TO：
   如果多个参数不是业务模型中的数据，但是经常使用，推荐来编写一个TO(Transfer Object)数据传输对象，如分页处理的模型，需要传入起始位置和大小。

Page{
    int index;
    int size;
}

思考

（1）public Employee getEmp(@Param("id") Integer id, String lastName);
取值：id====>#{id/param1}, lastName====>#{param2}
（2）public Employee getEmp(Integer id, @Param("e") Employee emp);
取值：id====>#{param1}, lastName====>#{param2.lastName/e.lastName}
（3）public Employee getEmpById(List ids);
取值：取出第一个id的值，id====>#{collection[0]/list[0]}
特别注意，如果是Collection（List、Set）类型或者是数组，也会做特殊处理，也是把list或者数组封装在map中。
其中的key：Collection类型统一的key是collection，如果是List还可以使用list，如果是数组使用array。
所以上面可以使用collection[0]/list[0]。

---

参数处理源码分析

在ParamNameResolver的getNamedParams方法中，为我们处理了参数，返回一个map。

========================结合源码，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'】:

//其中names,在构造器中进行初始化,names的value:若有注解则使用注解的value,若没注解则使用索引,names的key是索引序号.
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 param = new ParamMap