五、MyBatis 映射文件

MyBatis 的真正强大在于它的映射语句，也是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 就是针对 SQL 构建的，并且比普通的方法做的更好。

SQL 映射文件有很少的几个顶级元素（按照它们应该被定义的顺序）：

cache – 给定命名空间的缓存配置。
cache-ref – 其他命名空间缓存配置的引用。
resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
parameterMap – 已废弃！
sql – 可被其他语句引用的可重用语句块。
insert – 映射插入语句
update – 映射更新语句
delete – 映射删除语句
select – 映射查询语
复制代码

5.1 、Mybatis两种开发方式的比较

5.1.1、传统dao开发的弊端

我们在前面入门的例子就是传统的dao操作，我们可以看到这个操作极为繁琐，不仅繁琐，而且dao实现类也没有干什么实质性的工作，它仅仅就是通过 SqlSession 的相关 API 定位到映射文件 mapper 中相应 id 的 SQL 语句，真正对 DB 进行操作的工作其实是由框架通过 mapper 中的 SQL 完成的。

5.1.2、现代dao开发好处

MyBatis 框架就抛开了 Dao 的实现类，直接定位到映射文件 mapper 中的相应 SQL 语句，对 DB 进行操作。这种对 Dao 的实现方式称为 Mapper 的动态代理方式。 Mapper 动态代理方式无需程序员实现 Dao 接口。接口是由 MyBatis 结合映射文件自动生成的动态代理实现的。

5.2、Mybatis的动态代理

5.2.1、获取代理对象

我们只需调用 SqlSession 的 getMapper()方法，即可获取指定接口的实现类对象。该方法的参数为指定 Dao接口类的 class 值。

SqlSession session = factory.openSession();
UserDao dao = session.getMapper(UserDao.class);
//或者可以使用工具类
UserDao userDao =
MyBatisUtil.getSqlSession().getMapper(UserDao.class);
复制代码

5.2.2、使用代理对象执行sql语句

@Test
  public void TestUpdate(){
    User user = new User(16,"赵六","110");
    userDao.update(user);
  }
复制代码

5.2.3、动态代理原理

这种手段我们称为动态代理，我们debug一下可以看到

点进MapperProxy 类定义：

invoke()方法：

点进去execute方法，重点方法：

5.3、主键生成方式和获取主键值

5.3.1、主键生成方式

支持主键自增，例如 MySQL 数据库
不支持主键自增，例如 Oracle 数据库

5.3.2、获取主键值

若数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server ），则可以设置`useGeneratedKeys=”true”`，然后再把 keyProperty 设置到目标属性上。
复制代码

<insert id="insertEmployee"
insert id="insertEmployee"parameterType="com.atguigu.mybatis.beans.Employee" databaseId="mysql" useGeneratedKeys="true" keyProperty="id">
      insert into tbl_employee(last_name,email,gender) values(#{lastName},#{email},#{gender})
</insert>
复制代码

而对于不支持自增型主键的数据库（例如 Oracle），则可以使用 selectKey 子元素：selectKey 元素将会首先运行，id 会被设置，然后插入语句会被调用

<insert id="insertEmployee" parameterType="com.atguigu.mybatis.beans.Employee" databaseId="oracle">
    <selectKey order="BEFORE" keyProperty="id" resultType="integer">
    select employee_seq.nextval from dual
  </selectKey>
    insert into orcl_employee(id,last_name,email,gender) values(#{id},#{lastName},#{email},#{gender})
</insert>
复制代码

或者这样写

<insert id="insertEmployee" parameterType="com.atguigu.mybatis.beans.Employee" databaseId="oracle">
  <selectKey order="AFTER" keyProperty="id" resultType="integer">
    select employee_seq.currval from dual
  </selectKey>
  insert into orcl_employee(id,last_name,email,gender) values(employee_seq.nextval,#{lastName},#{email},#{gender})
</insert>
复制代码

5.4、参数传递

5.4.1、参数传递的方式

5.4.1.1、单个简单参数

可以接受基本类型，对象类型。这种情况 MyBatis 可直接使用这个参数，不需要经过任何处理。

在mapper.xml中用占位符 #{ 任意字符 }来表示这个参数，和方法的参数名无关。但是一般我们都会用方法的参数名来命名。

//接口中的方法：
User selectById(int id);
复制代码

<!--mapper文件-->
<select id="selectById" resultType="com.bjpowernode.domain.Student">
  select id,username,pwd from user where id=#{abcd}
</select>
<!--
  #{abcd} , abcd是自定义的变量名称，可以不和方法参数名相同，但是实际开发中一般是相同的。
-->
复制代码

5.4.1.2、多个参数（贴注解）

任意多个参数，都会被 MyBatis 重新包装成一个 Map 传入。Map 的 key 是 param1，param2，或者 0，1…，值就是参数的值。

我们一般需要在方法形参前面加入**@Param(“自定义参数名”)， mapper 文件使用#{自定义参数名}**来表示传入多个参数。

//接口方法
List<User> selectUserByCondition(@Param("username") String username, @Param("pwd") int pwd);
复制代码

<!--mapper文件-->
<select id="selectUserByCondition" resultType="com.domain.User">
  select id,username,pwd from student where username = #{username} or pwd = #{pwd}
</select>
复制代码

5.4.1.3、多个参数（封装成对象）

当我们需要传递多个参数的时候，我们可以将这些对象直接封装成一个对象，我们就直接传入JavaBean对象即可，在占位符内写对象的属性。

5.4.1.4、Map

Map 集合可以存储多个值，使用 Map 向 mapper 文件一次传入多个参数。Map 集合使用 String 的 key，Object 类型的值存储参数。 mapper 文件使用 # { key } 引用参数值。

//接口方法
List<User> selectMultiMap(Map<String,Object> map);
复制代码

<!--mapper文件-->
<select id="selectMultiMap" resultType="com.domain.User">
  select id,username,pwd from user where username=#{username} or pwd =#{pwd}
</select>
复制代码

5.4.1.5、Collection/Array

会被MyBatis 封装成一个map 传入, Collection 对应的key 是collection,Array 对应的key是 array. 如果确定是 List 集合，key 还可以是 list.

5.4.2、参数传递的源码分析

以命名参数为例:

public User getUserByIdAndUsername
(@Param("id")Integer id, @Param("username")String username);
复制代码

源码分析

public Object getNamedParams(Object[] args) {
        final int paramCount = names.size();
        if (args == null || paramCount == 0) {
            return null;
        } else if (!hasParamAnnotation && paramCount == 1) {
            return args[names.firstKey()];
        } else {
            final Map<String, Object> param = new ParamMap<Object>();
            int i = 0;
            for (Map.Entry<Integer, String> entry : names.entrySet()) {
                param.put(entry.getValue(), args[entry.getKey()]);
        // add generic param names (param1, param2, ...)
                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;
        }
    }
复制代码

5.4.3、参数处理

参数位置支持的属性

javaType、jdbcType、mode、numericScale、resultMap、typeHandler、jdbcTypeName、expression

使用实例

**实际上通常被设置的是：为可能为空的列名指定 jdbcType **

<select id="selectMultiObject" resultType="com.domain.User">
select id,username pwd from user
where username=#{username,javaType=string,jdbcType=VARCHAR}
or pwd =#{pwd,javaType=int,jdbcType=INTEGER}
</select>
复制代码

5.4.4、参数的获取方式

5.4.4.1、#

#占位符：告诉 mybatis 使用实际的参数值代替。并使用 PrepareStatement 对象执行 sql 语句, #{…}代替sql 语句的?。这样做更安全，更迅速，通常也是首选做法.

<!--mapper文件-->
<select id="selectById" resultType="com.domain.User">
select id,username,pwd from user where id=#{id}
</select>
复制代码

//转为 MyBatis 的执行是：
String sql=” select id,username,pwd from user where id=?”;
PreparedStatement ps = conn.prepareStatement(sql);
ps.setInt(1,1005);
//解释：
where id=? 就是 where id=#{id}
ps.setInt(1,1005) , 1005 会替换掉 #{id}
复制代码

5.4.4.2、$

$ 字符串替换：告诉 mybatis 使用所包含的“字符串”替换所在位置。使用∗∗Statement∗∗把sql语句和所包含的“字符串”替换所在位置。使用 **Statement** 把 sql 语句和所包含的“字符串”替换所在位置。使用∗∗Statement∗∗把sql语句和{}的内容连接起来。主要用在替换表名，列名，不同列排序等操作。

//需求：使用不同列作为查询条件
//接口方法
User findByDiffField(@Param("col") String colunName,@Param("cval") Object value);
复制代码

<!--mapper文件-->
<select id="findByDiffField" resultType="com.domain.User">
select * from user where ${col} = #{cval}
</select>
复制代码

5.5、select 查询的几种情况

5.5.1、查询单行数据返回单个对象

public User getUserById(Integer id );
复制代码

5.5.2、查询多行数据返回对象的集合

public List<User> getAllUser();
复制代码

5.5.3、查询单行数据返回 Map 集合

public Map<String,Object> getUserByIdReturnMap(Integer id );
复制代码

5.5.4、查询多行数据返回 Map 集合

@MapKey("id") // 指定使用对象的哪个属性来充当 map 的 key
public Map<Integer,User> getAllUserReturnMap();
复制代码

5.6、resultType 自动映射

执行 sql 得到 ResultSet 转换的类型，使用类型的完全限定名或别名。注意如果返回的是集合，那应该设置为集合包含的类型，而不是集合本身。resultType 和 resultMap，不能同时使用。

接口方法返回是集合类型，需要指定集合中的类型，不是集合本身。

5.6.1、简单类型

//接口方法
int countUser();
复制代码

<!--mapper 文件-->
<select id="countUser" resultType="int">
  select count(*) from user
</select>
复制代码

5.6.2、对象类型

//接口方法
List<User> selectUsers();
复制代码

<!--mapper文件-->
<select id="selectUsers" resultType="com.domain.User">
  select id,username,pwd from user 
</select>
复制代码

5.6.3、resultType的原理

使用构造方法创建对象。调用 setXXX 给属性赋值。

sql 语句列	java 对象方法
id	setId(rs.setInt("id"))
username	setUsername(rs.setString("username"))
pwd	setPwd(rs.setString("pwd"))

autoMappingBehavior 默认是 PARTIAL，开启自动映射的功能。唯一的要求是列名和javaBean 属性名一致
如果 autoMappingBehavior 设置为 null 则会取消自动映射
数据库字段命名规范，POJO 属性符合驼峰命名法，如 A_COLUMN aColumn，我们可以开启自动驼峰命名规则映射功能，mapUnderscoreToCamelCase=true

5.7、resultMap 自定义映射

resultMap 可以自定义 sql 的结果和 java 对象属性的映射关系。更灵活的把列值赋值给指定属性。常用在列名和 java 对象属性名不一样的情况。

id ：用于完成主键值的映射。
result ：用于完成普通列的映射。
association ：一个复杂的类型关联，许多结果将包成这种类型。
collection ：复杂类型的集。

属性	含义
property	映射到列结果的字段或属性，例如："username"或"address.stree.number"
column	数据表的列名，通常和`resultSet.getString(columnName)`的返回值一致

<!--resultMap: resultMap 标签中的 id 属性值-->
<select id="getEmployeeById" resultMap="myEmp">
  select id, last_name,email, gender from tbl_employee where id =#{id}
</select>
    <!-- 创建 resultMap
    id:自定义的唯一名称，在<select>使用
    type:期望转为的 java 对象的全限定名称或别名
    -->
<resultMap type="com.domain.Employee" id="myEmp">
    <!-- 主键字段使用 id -->
  <id column="id" property="id" />
    <!--非主键字段使用 result-->
  <result column="last_name" property="lastName"/>
  <result column="email" property="email"/>
  <result column="gender" property="gender"/>
</resultMap>
复制代码

5.7.1、association

5.7.1.1、association

POJO 中的属性可能会是一个对象,我们可以使用联合查询，并以级联属性的方式封装对象.使用 association 标签定义对象的封装规则

@Data
public class Department {
  private Integer id ;
  private String departmentName ;
}
复制代码

@Data
public class Employee {
  private Integer id ;
  private String lastName;
  private String email ;
  private String gender ;
  private Department dept ;
}
复制代码

<select id="getEmployeeAndDept" resultMap="myEmpAndDept" >
  SELECT e.id eid, e.last_name, e.email,e.gender ,d.id did, d.dept_name 
    FROM tbl_employee e , tbl_dept d 
    WHERE e.d_id = d.id 
    AND e.id = #{id}
</select>
<resultMap type="com.domain.Employee" id="myEmpAndDept">
  <id column="eid" property="id"/>
  <result column="last_name" property="lastName"/>
  <result column="email" property="email"/>
  <result column="gender" property="gender"/>
  <association property="dept" javaType="com.domain.Department">
    <id column="did" property="id"/>
    <result column="dept_name" property="departmentName"/>
    </association>
</resultMap>
复制代码

5.7.1.2、association 分步查询

实际的开发中，对于每个实体类都应该有具体的增删改查方法，也就是 DAO 层，因此对于查询员工信息并且将对应的部门信息也查询出来的需求，就可以通过分步的方式完成查询。

先通过员工的 id 查询员工信息
再通过查询出来的员工信息中的外键(部门 id)查询对应的部门信息.

<select id="getEmployeeAndDeptStep" resultMap="myEmpAndDeptStep">
  select id, last_name, email,gender,d_id from tbl_employee where id =#{id}
</select>
  <resultMap type="com.atguigu.mybatis.beans.Employee" id="myEmpAndDeptStep">
    <id column="id" property="id" />
    <result column="last_name" property="lastName"/>
    <result column="email" property="email"/>
    <result column="gender" property="gender"/>
    <association property="dept" 
                     select="com.atguigu.mybatis.dao.DepartmentMapper.getDeptById" 
                     column="d_id" 
                     fetchType="eager">
    </association>
</resultMap>
复制代码

5.7.1.3、association 分步查询使用延迟加载

在分步查询的基础上，可以使用延迟加载来提升查询的效率，只需要在全局的Settings 中进行如下的配置

<!-- 开启延迟加载 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 设置加载的数据是按需还是全部 -->
<setting name="aggressiveLazyLoading" value="false"/> 
复制代码

5.7.2、collection

5.7.2.1、collection

POJO 中的属性可能会是一个集合对象,我们可以使用联合查询，并以级联属性的方式封装对象.使用 collection 标签定义对象的封装规则

@Data
public class Department {
  private Integer id ;
  private String departmentName ;
  private List<Employee> emps ;
}
复制代码

<select id="getDeptAndEmpsById" resultMap="myDeptAndEmps">
  SELECT d.id did, d.dept_name ,e.id eid ,e.last_name ,e.email,e.gender
  FROM tbl_dept d 
  LEFT OUTER JOIN tbl_employee e 
  ON d.id = e.d_id
  WHERE d.id = #{id}
</select>
<resultMap type="com.atguigu.mybatis.beans.Department" id="myDeptAndEmps">
  <id column="did" property="id"/>
  <result column="dept_name" property="departmentName"/>
        <!--
        property: 关联的属性名
        ofType: 集合中元素的类型
        -->
    <collection property="emps" ofType="com.atguigu.mybatis.beans.Employee">
      <id column="eid" property="id"/>
      <result column="last_name" property="lastName"/>
      <result column="email" property="email"/>
      <result column="gender" property="gender"/>
    </collection>
</resultMap>
复制代码

5.7.2.2、collection 分步查询

实际的开发中，对于每个实体类都应该有具体的增删改查方法，也就是 DAO 层，因此对于查询部门信息并且将对应的所有的员工信息也查询出来的需求，就可以通过分步的方式完成查询。

先通过部门的 id 查询部门信息
再通过部门 id 作为员工的外键查询对应的部门信息.

<select id="getDeptAndEmpsByIdStep" resultMap="myDeptAndEmpsStep">
  select id ,dept_name from tbl_dept where id = #{id}
</select>
  <resultMap type="com.atguigu.mybatis.beans.Department" id="myDeptAndEmpsStep">
    <id column="id" property="id"/>
    <result column="dept_name" property="departmentName"/>
    <collection property="emps" select="com.atguigu.mybatis.dao.EmployeeMapper.getEmpsByDid" column="id"></collection>
  </resultMap>
复制代码

5.7.3、扩展: 分步查询多列值的传递

如果分步查询时，需要传递给调用的查询中多个参数，则需要将多个参数封装成Map 来进行传递，语法如下: {k1=v1, k2=v2....}。
在所调用的查询方，取值时就要参考 Map 的取值方式，需要严格的按照封装 map时所用的 key 来取值。

5.7.4、扩展: association 或 collection 的 fetchType 属性

在<association> 和<collection>标签中都可以设置 fetchType，指定本次查询是否要使用延迟加载。默认为 fetchType=”lazy” ,如果本次的查询不想使用延迟加载，则可设置为fetchType=”eager”。
fetchType 可以灵活的设置查询是否需要使用延迟加载，而不需要因为某个查询不想使用延迟加载将全局的延迟加载设置关闭。

5.8、模糊查询like

模糊查询的实现有两种方式，：

在 java 代码中给查询数据加上% 。
mapper 文件中使用 like name "%" #{xxx} "%"

5.8.1、方式一

来查询姓名有“力”的

//接口方法
List<User> selectLikeFirst(String username);
复制代码

<!--接口文件-->
<select id="selectLikeFirst" resultType="com.domain.User">
select id,username,pwd from user where username like #{username}
</select>
复制代码

5.8.2、方式二

//接口方法
List<User> selectLikeSecond(String username);
复制代码

<!--mapper文件-->
<select id="selectLikeSecond" resultType="com.domain.User">
select id,username,pwd from user where username like "%" #{studentName} "%"
</select>
复制代码

六、MyBatis 动态 SQL

6.1、MyBatis 动态 SQL 简介

动态 SQL，通过 MyBatis 提供的各种标签对条件作出判断以实现动态拼接 SQL 语句。这里的条件判断使用的表达式为 OGNL 表达式。常用的动态 SQL 标签有、、、等。

MyBatis 的动态 SQL 语句，与 JSTL 中的语句非常相似。动态 SQL，主要用于解决查询条件不确定的情况：在程序运行期间，根据用户提交的查询条件进行查询。提交的查询条件不同，执行的 SQL 语句不同。若将每种可能的情况均逐一列出，对所有条件进行排列组合，将会出现大量的 SQL 语句。此时，可使用动态 SQL 来解决这样的问题。

动态 SQL 是 MyBatis 强大特性之一。极大的简化我们拼装 SQL 的操作
动态 SQL 元素和使用 JSTL 或其他类似基于 XML 的文本处理器相似
MyBatis 采用功能强大的基于 OGNL 的表达式来简化操作
OGNL（ Object Graph Navigation Language ）对象图导航语言，这是一种强大的表达式语言，通过它可以非常方便的来操作对象属性。类似于我们的 EL，SpEL 等

注意：xml 中特殊符号如”,>,<等这些都需要使用转义字符

6.2、if和 where

if

If 用于完成简单的判断.

Where

Where 用于解决 SQL 语句中 where 关键字以及条件中第一个 and 或者 or 的问题

<select id="getEmpsByConditionIf" resultType="com.atguigu.mybatis.beans.Employee">
  select id , last_name ,email , gender
  from tbl_employee
    <where>
      <if test="id!=null">
        and id = #{id}
      </if>
      <if test="lastName!=null &amp;&amp; lastName!=&quot;&quot;">
        and last_name = #{lastName}
      </if>
      <if test="email!=null and email.trim()!=''">
        and email = #{email}
      </if>
      <if test="&quot;m&quot;.equals(gender) or &quot;f&quot;.equals(gender)">
        and gender = #{gender}
      </if>
    </where>
</select>
复制代码

6.3、trim

Trim 可以在条件判断完的 SQL 语句前后添加或者去掉指定的字符，常用方法如下：

prefix: 添加前缀 prefixOverrides: 去掉前缀 suffix: 添加后缀 suffixOverrides: 去掉后缀

<select id="getEmpsByConditionTrim" resultType="com.atguigu.mybatis.beans.Employee">
    select id , last_name ,email , gender from tbl_employee
  <trim prefix="where" suffixOverrides="and">
    <if test="id!=null">
      id = #{id} and
    </if>
    <if test="lastName!=null &amp;&amp; lastName!=&quot;&quot;">
      last_name = #{lastName} and
    </if>
    <if test="email!=null and email.trim()!=''">
      email = #{email} and
    </if>
    <if test="&quot;m&quot;.equals(gender) or &quot;f&quot;.equals(gender)">
      gender = #{gender}
    </if>
  </trim>
</select>
复制代码

6.4、set

set 主要是用于解决修改操作中 SQL 语句中可能多出逗号的问题

<update id="updateEmpByConditionSet">
  update tbl_employee
  <set>
    <if test="lastName!=null &amp;&amp; lastName!=&quot;&quot;">
      last_name = #{lastName},
    </if>
    <if test="email!=null and email.trim()!=''">
      email = #{email} ,
    </if>
    <if test="&quot;m&quot;.equals(gender) or &quot;f&quot;.equals(gender)">
      gender = #{gender}
    </if>
  </set>
  where id =#{id}
</update>
复制代码

6.5、choose(when、otherwise)

choose 主要是用于分支判断，类似于 java 中的 switch case,只会满足所有分支中的一个

<select id="getEmpsByConditionChoose" resultType="com.atguigu.mybatis.beans.Employee">
  select id ,last_name, email,gender from tbl_employee
  <where>
    <choose>
      <when test="id!=null">
        id = #{id}
      </when>
      <when test="lastName!=null">
        last_name = #{lastName}
      </when>
      <when test="email!=null">
        email = #{email}
      </when>
      <otherwise>
        gender = 'm'
      </otherwise>
    </choose>
  </where>
</select>
复制代码

6.6、foreach

foreach 主要用户循环迭代

collection: 要迭代的集合 item: 当前从集合中迭代出的元素 open: 开始字符 close:结束字符 separator: 元素与元素之间的分隔符 index: 迭代的是 List 集合: index 表示的当前元素的下标迭代的 Map 集合: index 表示的当前元素的 key

<select id="getEmpsByConditionForeach" resultType="com.atguigu.mybatis.beans.Employee">
    select id , last_name, email ,gender from tbl_employee where id in
  <foreach collection="ids" item="curr_id" open="(" close=")" separator="," >
    #{curr_id}
  </foreach>
</select>
复制代码

6.7、sql

sql 标签是用于抽取可重用的 sql 片段，将相同的，使用频繁的 SQL 片段抽取出来，单独定义，方便多次引用.

抽取sql

<sql id="selectSQL">
  select id , last_name, email ,gender from tbl_employee
</sql>
复制代码

引用 SQL

<include refid="selectSQL"></include>
复制代码

七、MyBatis 缓存机制

7.1、缓存的简介

MyBatis 包含一个非常强大的查询缓存特性,它可以非常方便地配置和定制。缓存可以极大的提升查询效率
MyBatis 系统中默认定义了两级缓存，一级缓存和二级缓存
默认情况下，只有一级缓存（SqlSession 级别的缓存，也称为本地缓存）开启。
二级缓存需要手动开启和配置，他是基于 namespace 级别的缓存
为了提高扩展性。MyBatis 定义了缓存接口 Cache。我们可以通过实现 Cache 接口来自定义二级缓存

7.2、一级缓存的使用

一级缓存(local cache), 即本地缓存, 作用域默认为 sqlSession。当 Session flush 或close 后, 该 Session 中的所有 Cache 将被清空。本地缓存不能被关闭, 但可以调用 clearCache() 来清空本地缓存, 或者改变缓存的作用域.

7.2.1、一级缓存的工作机制

同一次会话期间只要查询过的数据都会保存在当前 SqlSession 的一个 Map 中 key: hashCode+查询的 SqlId+编写的 sql 查询语句+参数

7.2.2、一级缓存失效的几种情况

不同的 SqlSession 对应不同的一级缓存
同一个 SqlSession 但是查询条件不同
同一个 SqlSession 两次查询期间执行了任何一次增删改操作
同一个 SqlSession 两次查询期间手动清空了缓存

##7.3、二级缓存的使用

二级缓存(second level cache)，全局作用域缓存，二级缓存默认不开启，需要手动配置。
MyBatis 提供二级缓存的接口以及实现，缓存实现要求 POJO 实现 Serializable 接口
二级缓存在 SqlSession 关闭或提交之后才会生效

二级缓存使用的步骤:

全局配置文件中开启二级缓存
需要使用二级缓存的映射文件处使用 cache 配置缓存
注意：POJO 需要实现 Serializable 接口

二级缓存相关的属性

eviction=“FIFO”：缓存回收策略：
LRU – 最近最少使用的：移除最长时间不被使用的对象。
FIFO – 先进先出：按对象进入缓存的顺序来移除它们。
SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。
WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。默认的是 LRU。
flushInterval：刷新间隔，单位毫秒,默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新
size：引用数目，正整数，代表缓存最多可以存储多少个对象，太大容易导致内存溢出
readOnly：只读，true/false
true：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了很重要的性能优势。
false：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些，但是安全，因此默认是 false。

7.4、缓存的相关属性设置

属性	含义
全局 setting 的 cacheEnable	配置二级缓存的开关，一级缓存一直是打开的
select 标签的 useCache 属性	配置这个 select 是否使用二级缓存。一级缓存一直是使用的
sql 标签的 flushCache 属性	增删改默认 flushCache=true。sql 执行以后，会同时清空一级和二级缓存。查询默认 flushCache=false。
sqlSession.clearCache()：	只是用来清除一级缓存

7.5、整合第三方缓存

为了提高扩展性。MyBatis 定义了缓存接口 Cache。我们可以通过实现 Cache 接口来自定义二级缓存，EhCache 是一个纯 Java 的进程内缓存框架，具有快速、精干等特点，是 Hibernate 中默认的 CacheProvider

整合 EhCache 缓存的步骤

导入 ehcache 包，以及整合包，日志包(maven也行) ehcache-core-2.6.8.jar、mybatis-ehcache-1.0.3.jar slf4j-api-1.6.1.jar、slf4j-log4j12-1.6.2.jar
编写 ehcache.xml 配置文件

<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../config/ehcache.xsd">
<!-- 磁盘保存路径 -->
<diskStore path="D:\atguigu\ehcache" />
<defaultCache
maxElementsInMemory="1000"
maxElementsOnDisk="10000000"
eternal="false"
              overflowToDisk="true"
timeToIdleSeconds="120"
timeToLiveSeconds="120"
diskExpiryThreadIntervalSeconds="120"
memoryStoreEvictionPolicy="LRU">
</defaultCache>
</ehcache>
<!--
属性说明：
l diskStore：指定数据在磁盘中的存储位置。
l defaultCache：当借助CacheManager.add("demoCache")创建Cache时，EhCache
便会采用<defalutCache/>指定的的管理策略
以下属性是必须的：
l maxElementsInMemory - 在内存中缓存的element的最大数目
l maxElementsOnDisk - 在磁盘上缓存的element的最大数目，若是0表示无穷大
l eternal - 设定缓存的elements是否永远不过期。如果为true，则缓存的数据始
终有效，如果为false那么还要根据timeToIdleSeconds，timeToLiveSeconds判断
l overflowToDisk - 设定当内存缓存溢出的时候是否将过期的element缓存到磁
盘上
以下属性是可选的：
l timeToIdleSeconds - 当缓存在EhCache中的数据前后两次访问的时间超过
timeToIdleSeconds的属性取值时，这些数据便会删除，默认值是0,也就是可闲置
时间无穷大
l timeToLiveSeconds - 缓存element的有效生命期，默认是0.,也就是element存活
时间无穷大
diskSpoolBufferSizeMB 这个参数设置DiskStore(磁盘缓存)的缓存区大小.默认
是30MB.每个Cache都应该有自己的一个缓冲区.
l diskPersistent - 在VM重启的时候是否启用磁盘保存EhCache中的数据，默认是
false。
l diskExpiryThreadIntervalSeconds - 磁盘缓存的清理线程运行间隔，默认是120
秒。每个120s，相应的线程会进行一次EhCache中数据的清理工作
l memoryStoreEvictionPolicy - 当内存缓存达到最大，有新的element加入的时
候， 移除缓存中element的策略。默认是LRU（最近最少使用），可选的有LFU
（最不常使用）和FIFO（先进先出）
-->
复制代码

配置 cache 标签

<cache type="org.mybatis.caches.ehcache.EhcacheCache"></cache>
复制代码

八、MyBatis 逆向工程

8.1、逆向工程简介

MyBatis Generator: 简称 MBG，是一个专门为 MyBatis 框架使用者定制的代码生成器，可以快速的根据表生成对应的映射文件，接口，以及 bean 类。支持基本的增删改查，以及 QBC 风格的条件查询。但是表连接、存储过程等这些复杂 sql 的定义需要我们手工编写

官方文档地址www.mybatis.org/generator/官方工程地址github.com/mybatis/gen…

8.2、逆向工程的配置

导入逆向工程的 jar 包：mybatis-generator-core-1.3.2.jar
编写 MBG 的配置文件（重要几处配置）,可参考官方手册

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--
targetRuntime: 执行生成的逆向工程的版本
MyBatis3Simple: 生成基本的CRUD
MyBatis3: 生成带条件的CRUD
-->
<context id="DB2Tables" targetRuntime="MyBatis3">
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/mybatis_1129"
userId="root"
password="1234">
</jdbcConnection>
<!-- javaBean的生成策略-->
<javaModelGenerator targetPackage="com.atguigu.mybatis.beans"
                    targetProject=".\src">
<property name="enableSubPackages" value="true" />
<property name="trimStrings" value="true" />
</javaModelGenerator>
<!-- SQL映射文件的生成策略 -->
<sqlMapGenerator targetPackage="com.atguigu.mybatis.dao"
targetProject=".\conf">
<property name="enableSubPackages" value="true" />
</sqlMapGenerator>
<!-- Mapper接口的生成策略 -->
<javaClientGenerator type="XMLMAPPER"
targetPackage="com.atguigu.mybatis.dao" targetProject=".\src">
<property name="enableSubPackages" value="true" />
</javaClientGenerator>
<!-- 逆向分析的表 -->
<table tableName="tbl_dept" domainObjectName="Department"></table>
<table tableName="tbl_employee" domainObjectName="Employee"></table>
</context>
</generatorConfiguration>
复制代码

编写java代码运行

@Test
    public void testMBG() throws Exception {
        List<String> warnings = new ArrayList<String>();
        boolean overwrite = true;
        File configFile = new File("mbg.xml");
        ConfigurationParser cp = new ConfigurationParser(warnings);
        Configuration config = cp.parseConfiguration(configFile);
        DefaultShellCallback callback = new DefaultShellCallback(overwrite);
        MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config,
                callback, warnings);
        myBatisGenerator.generate(null);
    }
复制代码

8.3、逆向工程的使用

基本查询的测试

@Test
    public void testSelect() throws Exception {
        SqlSessionFactory ssf = getSqlSessionFactory();
        SqlSession session = ssf.openSession();
        try {
            EmployeeMapper mapper =
                    session.getMapper(EmployeeMapper.class);
            List<Employee> emps = mapper.selectAll();
            for (Employee employee : emps) {
                System.out.println(employee);
            }
        } finally {
            session.close();
        }
    }
复制代码

带条件查询的测试

@Test
    public void testSelect() throws Exception {
        SqlSessionFactory ssf = getSqlSessionFactory();
        SqlSession session = ssf.openSession();
        try {
            EmployeeMapper mapper =
                    session.getMapper(EmployeeMapper.class);
//条件查询: 名字中带有'张' 并且 email中'j' 或者 did = 2
            EmployeeExample example = new EmployeeExample();
            Criteria criteria = example.createCriteria();
            criteria.andLastNameLike("%张%");
            criteria.andEmailLike("%j%");
//or
            Criteria criteriaOr = example.createCriteria();
            criteriaOr.andDIdEqualTo(2);
            example.or(criteriaOr);
            List<Employee> emps = mapper.selectByExample(example);
            for (Employee employee : emps) {
                System.out.println(employee);
            }
        } finally {
            session.close();
        }
    }
复制代码

#九、扩展-PageHelper 分页插件

9.1、PageHelper 分页插件简介

PageHelper 是 MyBatis 中非常方便的第三方分页插件，官方文档：https://github.com/pagehelper/Mybatis-PageHelper/blob/master/README_zh.md

9.2、PageHelper 的使用步骤

导入相关包 pagehelper-x.x.x.jar 和 jsqlparser-0.9.5.jar
在 MyBatis 全局配置文件中配置分页插件

<plugins>
<plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>
复制代码

使用 PageHelper 提供的方法进行分页
可以使用更强大的 PageInfo 封装返回结果

9.3、Page 对象的使用

在查询之前通过 PageHelper.startPage(页码，条数)设置分页信息，该方法返回 Page 对象

@Test
    public void testPageHelper() throws Exception{
        SqlSessionFactory ssf = getSqlSessionFactory();
        SqlSession session = ssf.openSession();
        try {
            EmployeeMapper mapper =
                    session.getMapper(EmployeeMapper.class);
//设置分页信息
            Page<Object> page = PageHelper.startPage(9, 1);
             List<Employee> emps = mapper.getAllEmps();
for (Employee employee : emps) {
        System.out.println(employee);
    }
    System.out.println("=============获取分页相关的信息
        =================");
        System.out.println("当前页: " + page.getPageNum());
    System.out.println("总页码: " + page.getPages());
    System.out.println("总条数: " + page.getTotal());
    System.out.println("每页显示的条数: " + page.getPageSize());
} finally {
        session.close();
        }
      }
复制代码

9.4、PageInfo 对象的使用

在查询完数据后，使用 PageInfo 对象封装查询结果，可以获取更详细的分页信息以及可以完成分页逻辑

@Test
    public void testPageHelper1() throws Exception{
        SqlSessionFactory ssf = getSqlSessionFactory();
        SqlSession session = ssf.openSession();
        try {
            EmployeeMapper mapper =
                    session.getMapper(EmployeeMapper.class);
//设置分页信息
            Page<Object> page = PageHelper.startPage(9, 1);
            List<Employee> emps = mapper.getAllEmps();
//
            PageInfo<Employee> info = new PageInfo<>(emps,5);
            for (Employee employee : emps) {
                System.out.println(employee);
            }
            System.out.println("=============获取详细分页相关的信息
                    =================");
            System.out.println("当前页: " + info.getPageNum());
            System.out.println("总页码: " + info.getPages());
            System.out.println("总条数: " + info.getTotal());
            System.out.println("每页显示的条数: " + info.getPageSize());
            System.out.println("是否是第一页: " + info.isIsFirstPage());
      System.out.println("是否是最后一页: " + info.isIsLastPage());
      System.out.println("是否有上一页: " + info.isHasPreviousPage());
      System.out.println("是否有下一页: " + info.isHasNextPage());
      System.out.println("============分页逻辑===============");
    int [] nums = info.getNavigatepageNums();
  for (int i : nums) {
        System.out.print(i +" " );
    }
} finally {
        session.close();
        }
        }
复制代码

十、SSM 框架整合

10.1、整合注意事项

查看不同 MyBatis 版本整合 Spring 时使用的适配包；

下载整合适配包：github.com/mybatis/spr…
官方整合示例，jpetstore：github.com/mybatis/jpe…

10.2、整合思路、步骤

搭建环境

创建一个动态的 WEB 工程，导入 SSM 需要使用的 jar 包，导入整合适配包，导入其他技术的一些支持包连接池数据库驱动日志....

Spring + Springmvc

在web.xml 中配置: Springmvc 的前端控制器实例化Spring 容器的监听器 ,字符编码过滤器 REST 过滤器
创建 Spring 的配置文件: applicationContext.xml:组件扫描、连接池、事务.....
创建 Springmvc 的配置文件: springmvc.xml : 组件扫描、视图解析器

MyBatis

创建 MyBatis 的全局配置文件
编写实体类 Mapper 接口 Mapper 映射文件

Spring + MyBatis

MyBatis 的 SqlSession 的创建 .
MyBatis 的 Mapper 接口的代理实现类

测试

10.3、整合的配置

10.3.1、web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<!-- 字符编码过滤器 -->
<filter>
  <filter-name>CharacterEncodingFilter</filter-name>
  <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>CharacterEncodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>
    <!-- REST 过滤器 -->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 实例化SpringIOC容器的监听器 -->
<context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>classpath:applicationContext.xml</param-value>
</context-param>
<listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- Springmvc的前端控制器 -->
<servlet>
  <servlet-name>springDispatcherServlet</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:springmvc.xml</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>springDispatcherServlet</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
复制代码

10.3.2、Spring 配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:mybatis-spring="http://mybatis.org/schema/mybatis-spring"
       xsi:schemaLocation="http://mybatis.org/schema/mybatis-spring
http://mybatis.org/schema/mybatis-spring-1.2.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">
    <!-- 组件扫描 -->
    <context:component-scan base-package="com.atguigu.ssm">
        <context:exclude-filter type="annotation"
                                expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>
    <!-- 连接池 -->
    <context:property-placeholder location="classpath:db.properties"/>
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="${jdbc.driver}"></property>
        <property name="jdbcUrl" value="${jdbc.url}"></property>
        <property name="user" value="${jdbc.username}"></property>
        <property name="password" value="${jdbc.password}"></property>
    </bean>
    <!-- 事务 -->
    <bean id="dataSourceTransactionManager"
          class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"></property>
    </bean>
    <tx:annotation-driven transaction-manager="dataSourceTransactionManager"/>
</beans>
复制代码

10.3.3 SpringMVC 配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd">
    <!-- 组件扫描 -->
    <context:component-scan base-package="com.atguigu.ssm" use-default-filters="false">
        <context:include-filter type="annotation"
                                expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>
    <!--视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>
    <mvc:default-servlet-handler/>
    <mvc:annotation-driven/>
</beans>
复制代码

10.3.4、MyBatis 配置

全局文件的配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- Spring 整合 MyBatis 后， MyBatis中配置数据源，事务等一些配置都可以
    迁移到Spring的整合配置中。MyBatis配置文件中只需要配置与MyBatis相关
    的即可。
    -->
    <!-- settings: 包含很多重要的设置项 -->
    <settings>
        <!-- 映射下划线到驼峰命名 -->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!-- 设置Mybatis对null值的默认处理 -->
        <setting name="jdbcTypeForNull" value="NULL"/>
        <!-- 开启延迟加载 -->
        <setting name="lazyLoadingEnabled" value="true"/>
        <!-- 设置加载的数据是按需还是全部 -->
        <setting name="aggressiveLazyLoading" value="false"/>
        <!-- 配置开启二级缓存 -->
        <setting name="cacheEnabled" value="true"/>
    </settings>
</configuration>
复制代码

SQL 映射文件配置

<?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.atguigu.ssm.mapper.EmployeeMapper">
    <!-- public List<Employee> getAllEmps(); -->
    <select id="getAllEmps" resultMap="myEmpsAndDept" >
        select e.id eid, e.last_name,e.email,e.gender, d.id did, d.dept_name
        from tbl_employee e ,tbl_dept d
        where e.d_id = d.id
    </select>
    <resultMap type="com.atguigu.ssm.beans.Employee" id="myEmpsAndDept">
        <id column="eid" property="id"/>
        <result column="last_name" property="lastName"/>
        <result column="email" property="email"/>
        <result column="gender" property="gender"/>
        <association property="dept" javaType="com.atguigu.ssm.beans.Department">
            <id column="did" property="id"/>
            <result column="dept_name" property="departmentName"/>
        </association>
    </resultMap>
</mapper>
复制代码

Spring 整合 MyBatis 配置

<!-- Spring 整合 Mybatis -->
<!--1. SqlSession -->
<bean class="org.mybatis.spring.SqlSessionFactoryBean">
<!-- 指定数据源 -->
<property name="dataSource" ref="dataSource"></property>
<!-- MyBatis的配置文件 -->
<property name="configLocation"
value="classpath:mybatis-config.xml"></property>
<!-- MyBatis的SQL映射文件 -->
<property name="mapperLocations"
value="classpath:mybatis/mapper/*.xml"></property>
<property name="typeAliasesPackage"
value="com.atguigu.ssm.beans"></property>
</bean>
<!-- Mapper接口
MapperScannerConfigurer 为指定包下的Mapper接口批量生成代理实现类.bean
的默认id是接口名首字母小写.
-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.atguigu.ssm.mapper"></property>
</bean>
<!-- <mybatis-spring:scan base-package="com.atguigu.ssm.mapper"/> -->

MyBatis从前世到今生一网打尽（下）