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标签)。

```

        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

   

   

    select id, last_name lastName, gender, email from tbl_employee where id = #{id}

 

   

            statementType="PREPARED" useGeneratedKeys="true" keyProperty="id">

        insert into tbl_employee (last_name, gender, email) values (#{lastName}, #{gender}, #{email})

   

   

        update tbl_employee set last_name=#{lastName}, gender=#{gender}, email=#{email} where id=#{id}

   

   

        delete from tbl_employee where id=#{id}

   

```

    其中， 各自方法的标签见文知意。需要注意的是，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 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 param = new ParamMap