SQL映射文件

一、 SQL映射文件是什么？

SQL映射文件（SQL Mapping File）是MyBatis框架中用于定义数据库操作的XML文件。它与应用程序的数据访问层进行交互，将Java对象与数据库表之间的映射关系进行配置，并提供了执行SQL语句的方式。

二，SQL映射文件中的几个顶级元素介绍：

mapper：SQL映射文件的根元素。只有一个属性namespace，用于区分不同的mapper，必须全局唯一。
cache：为给定命名空间配置缓存。
cache-ref：引用其他命名空间中的缓存配置。
resultMap：用来描述查询结果集中的字段和Java实体类属性的对应关系。
sql：定义可重用的SQL语句块，可以在其他语句映射中引用，提高编写和维护SQL语句的效率。
insert：映射insert语句。
update：映射update语句。
delete：映射delete语句。
select：映射select语句。

1.mapper

​
mapper namespace属性

区别不同的mapper namespace和子元素的id联合保证唯一

绑定DAO接口

namespace的命名必须跟某个接口同名

接口中的方法与映射文件中SQL语句id一一对应

​

2. select

select元素是MyBatis中最常用的元素之一，因此 MyBatis 在查询和结果映射做了相当多的改进。一个简单查询的select元素是非常简单的。比如：

<!-- 查询 User 表的全部内容 -->
<!-- id 表示唯一标识符，parameterType 表示查询返回结果全限定名或别名 -->
<select id="getUserAll" resultType="User">
  SELECT * FROM User
</select>

select元素的一些比较常见属性：

id：在命名空间中唯一的标识符。

parameterType：传入这条语句的参数的类型。

resultType：语句中返回结果的类全限定名或别名。

resultMap：对外部 resultMap 的命名引用。

resultOrdered：该属性仅仅针对嵌套结果 select 语句，默认值为 false。

resultSets：将列出语句执行后返回的结果集并赋予每个结果集一个名称，多个名称之间以逗号分隔，仅适用于多结果集的情况。

timeout：在抛出异常之前，驱动程序等待数据库返回请求结果的秒数，默认没设置。

statementType：可选STATEMENT，PREPARED 或 CALLABLE，默认值：PREPARED。

3.使用resultMap元素自定义结果映射：

//示例
 
//Mapper接口
public List<SysUser> getUserListWithRoleName(SysUser sysUser);
 
//xml文件
//使用resultMap元素定义结果映射
<resultMap id="userWithRoleName" type="sysuser">
    <id property="id" column="id">
    <result property="userRoleName" column="roleName"/>
</resultMap>
 
//resultMap元素定义的规则封装查询结果
<select id="getUserListWithRoleName" parameterType="sysuser" resultMap="userWithRoleName">
    select u.*,r.roleName from t_sys_user u,t_sys_role r
    where u.realName like CONCAT ('%',#{realName},'%')
    and u.roleId = #{roleId} and u.roleId = r.id
</select>

4.association

association属性
resultMap：外部引用 值为id值
property：为你在这个类创建的类对象名称
javaType：为完整java类名或者别名
子元素
id：一般用于主键
result元素属性
property ：属性名
column：数据库列名或者别名

    <resultMap id="SysUserAndSysRoleTow" type="sysUser">
        <id property="id" column="id"></id>
        <result property="account" column="account"></result>
        <result property="realName" column="realName"></result>
        <result property="sex" column="sex"></result>
        <result property="phone" column="phone"></result>
        <result property="roleId" column="roleId"></result>
        <result property="createdTime" column="createdTime"></result>

        <!--association:处理多对一的映射关系
             property:需要处理多对的映射关系的属性名
             javaType:该属性的类型
          -->

        <association property="sysRole" javaType="SysRole">
            <id property="id" column="id"></id>
            <result property="roleName" column="roleName"></result>
        </association>
    </resultMap>

5.collection

collection属性
resultMap：外部引用 值为id值
property：为这个类内的集合名称
ofType：完整的类名或别名，就是集合包含的类型
子元素
id：一般用于主键
result元素属性
property ：属性名
column：数据库列名或者别名

    <resultMap id="SysUserAndSysRoleTow" type="sysUser">
        <id property="id" column="id"></id>
        <result property="account" column="account"></result>
        <result property="realName" column="realName"></result>
        <result property="sex" column="sex"></result>
        <result property="phone" column="phone"></result>
        <result property="roleId" column="roleId"></result>
        <result property="createdTime" column="createdTime"></result>   
        <collection property="sysRole" ofType="SysRole">
            <id property="id" column="id"></id>
            <result property="roleName" column="roleName"></result>
        </collection>
    </resultMap>

6.resultType和resultMap小结：

resultmap：resultMap如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。
resultType：resultType使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。

7.resultMap的自动映射行为：

可以根据查询结果集的列名和 Java 对象的属性名自动进行结果映射，简化了手动编写映射规则的过程，自动映射的前提：属性名与字段名一致，自动映射级别：autoMappingBehavior

自动映射行为	resultType (不支持嵌套映射)	没有嵌言映射的resutMap	有嵌套映射的resultMap
NONE	失效	手工映射	手工映射
PARTIAL	自动映射	自动映射	手工映射
FULL	自动映射	自动映射	自动映射

三，MyBatis的缓存

1、MyBatis的一级缓存

一级缓存是 SqlSession 级别的，通过同一个 SqlSession 查询的数据会被缓存，下次查询相同的数据，就 会从缓存中直接获取，不会从数据库重新访问

使一级缓存失效的四种情况：

1) 不同的 SqlSession 对应不同的一级缓存

2) 同一个 SqlSession 但是查询条件不同

3) 同一个 SqlSession 两次查询期间执行了任何一次增删改操作

4) 同一个 SqlSession 两次查询期间手动清空了缓存

2、MyBatis的二级缓存

二级缓存是 SqlSessionFactory 级别，通过同一个 SqlSessionFactory 创建的 SqlSession 查询的结果会被

缓存；此后若再次执行相同的查询语句，结果就会从缓存中获取

二级缓存开启的条件：

a> 在核心配置文件中，设置全局配置属性 cacheEnabled="true" ，默认为 true ，不需要设置

b> 在映射文件中设置标签 <cache />

c> 二级缓存必须在 SqlSession 关闭或提交之后有效

d> 查询的数据所转换的实体类类型必须实现序列化的接口

使二级缓存失效的情况：

两次查询之间执行了任意的增删改，会使一级和二级缓存同时失效

3、二级缓存的相关配置

在 mapper 配置文件中添加的 cache 标签可以设置一些属性：

eviction 属性：缓存回收策略

LRU （ Least Recently Used ） – 最近最少使用的：移除最长时间不被使用的对象。

FIFO （ First in First out ） – 先进先出：按对象进入缓存的顺序来移除它们。

SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。

WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。

默认的是 LRU 。

flushInterval 属性：刷新间隔，单位毫秒

默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新

size 属性：引用数目，正整数

代表缓存最多可以存储多少个对象，太大容易导致内存溢出

readOnly 属性：只读， true/false

true ：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了

很重要的性能优势。

false ：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些，但是安全，因此默认是

false 。

4、MyBatis缓存查询的顺序

先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用。

如果二级缓存没有命中，再查询一级缓存

如果一级缓存也没有命中，则查询数据库

SqlSession 关闭之后，一级缓存中的数据会写入二级缓存

5.设置二级缓存的类型

<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>