MyBatis使用笔记

MyBatis

MyBatis做为一个轻量的SQL映射框架，确实很简单，可是知识点挺多，实际使用中仍是会有时想不起来某个标签该怎么写，因此整理了这篇文章，以备查询。因为MyBatis如此简单，使得这一篇文章基本把实际使用中常碰到的事情都涵盖了，包括：

1. MyBatis中的一些概念
2. MyBatis包含的内容
3. SQL映射
4. 动态SQL

1、 MyBatis中的一些概念

MyBatis的架构

1. MyBatis 是个什么东西

在使用MyBatis的项目里，日志中每每会出现不少拼接SQL语句的log，这其实说明了MyBatis底层仍是使用JDBC来实现的。在JDBC的基础上，为了性能考虑，全部的语句都是基于 SqlSession 。顾名思义，维护这个类的实例其实就是维护了一个对于某个数据库的链接的会话，在这个会话里能够有缓存啊什么之类的。

2. mapper 接口是怎么映射成SQL语句的

目前多数开发者仍是会使用XML来进行MyBatis的配置，包括MyBatis的核心配置和SQL映射配置。其实和注解同样，XML自己只不过是一个元数据的载体，最终起做用的仍是MyBatis的核心类。其中有这样几个比较重要的：

1. SqlSessionFactoryBuilder ，用来建立 SqlSessionFactory 的实例，以后就没有用了，其生命周期只是在初始化的时候有做用。
2. SqlSessionFactory ，MyBatis最基础的类，用来建立会话（即 SqlSession 的实例），其生命周期与整个系统的生命周期相同，在系统运行的任什么时候候均可以使用它查询到当前数据库的配置信息等。
3. SqlSession ，真正的和数据库之间的会话，线程不安全，因此其生命周期和使用它的线程相同。
4. 各类 Mapper ，承载了实际的业务逻辑，其生命周期比较短，由 SqlSession 建立。

3. Spring环境中MyBatis的初始化过程

实际状况中MyBatis每每是在Spring的环境中使用的，MyBatis自己并不依赖Spring，可是使用Spring能够极大的提升开发效率，因为Spring进行了控制反转，因此其中MyBatis的初始化过程和正常过程稍稍有些不一样：

1. Spring发现须要建立 SqlSessionFactory 实例，会在classpath下找到MyBatis的核心配置文件，使用它来初始化一个 SqlSessionFactory 实例。固然，这一步彻底可使用代码来完成，或者使用注解，就更加清晰明了。
2. 每每mapper类也会做为bean注入到代码中去的，那么Spring会使用上一步中的 SqlSessionFactory 实例来建立 SqlSession 的实例。
3. 而后再使用 SqlSession 尝试建立各个mapper对象。
4. 于此同时，MyBatis会扫描classpath下的mapper映射XML文件（此路径能够自定义），对于每个mapper接口，它的「类全名」会做为命名空间，来和映射文件中的mapper标签进行匹配。
5. 对于每个映射文件中的一个执行语句标签（如select、delete），MyBatis会把他们映射到 SqlSession 的方法上，建立mapper接口的一个实现类。
6. 若是mapper接口和其映射文件一一匹配，则bean建立成功。

2、MyBatis包含的内容

MyBatis自己就是一个简单的ORM框架，提供了SQL语句到方法、关系型数据表到对象的映射。实际使用中与开发者相关的有两个东西：

1. MyBatis核心配置 
   缓存、数据源、日志等关系到MyBatis其自己行为的一些配置。
2. mapper接口的映射 
   针对于具体业务逻辑的SQL映射。

3、SQL映射

MyBatis也可使用注解来实现映射，对于简单的语句，使用注解可能会更加清晰简单，可是其真正强大的地方仍是XML。

1. select

属性	描述
id	此命名空间内的标识符
parameterType	参数的类的全名或者alias，可选。默认为空。
parameterMap	Deprecated
resultType	返回结果的类型全名或alias，若是结果是集合，此类型表示的是集合的成员类型。
resultMap	使用指定的resultMap来映射结果集。resultMap 和 resultType只能二选一。
flushCache	若是为true，每次调用，一级缓存和二级缓存都会回写。select语句中默认为false。
useCache	若是为true，结果将在二级缓存中缓存。select语句中默认为true
timeout	设置超时，若超时则抛出异常。
fetchSize	尝试在获取数据时分批获取。
statementType	STATEMENT，PREPARED或者CALLABLE. 分别对应JDBC中的Statement，PreparedStatement和CallableStatement respectively。默认PREPARED.
resultSetType	FORWARD_ONLY，SCROLL_SENSITIVE或者SCROLL_INSENSITIVE。默认为空。
databaseId	使用特定的databaseIdProvider
resultOrdered	嵌套查询时使用。
resultSets	多返回集合时使用。

2. 修改语句（insert，update，DELETE）

这3种语句的属性基本和上边select的同样，INSERT和UPDATE的语句有几个特殊的属性以下：

属性	描述
useGeneratedKeys	将使用JDBC的getGeneratedKeys方法来获取主键的值。默认为false。
keyProperty	主键。MyBatis会将生成的主键赋给这个列。联合主键使用逗号隔开。
keyColumn	特定数据库须要使用。

3. SQl语句段（sql标签）

<sql>标签能够定义一段sql语句段，能够在其余语句中引入使用。sql标签能够包含参数。示例以下：

<sql id="userColumns">${alias}.id,${alias}.username,${alias}.password </sql>
<select id="selectUsers" resultType="map">
      select
        <include refid="userColumns"><property name="alias" value="t1"/></include>,
        <include refid="userColumns"><property name="alias" value="t2"/></include>
      from some_table t1
        cross join some_table t2
</select>

参数（property）也能够在refid或者include进来的sql中使用。示例以下：

<sql id="sometable">
      ${prefix}Table
</sql>
<sql id="someinclude">
      from
    <include refid="${include_target}"/>
</sql>
<select id="select" resultType="map">
  select
    field1, field2, field3
  <include refid="someinclude">
    <property name="prefix" value="Some"/>
    <property name="include_target" value="sometable"/>
  </include>
</select>

4. #{} 和 ${} 的区别

1. #{} 在底层实现上使用 ? 作占位符来生成PreparedStatement，而后将参数传入，大多数状况都应使用这个，它更快、更安全。
2. ${} 将传入的数据直接显示生成在sql中。如：order by ${user_id}，若是传入的值是111,那么解析成sql时的值为order by 111, 若是传入的值是id，则解析成的sql为order by id.

5. 类型别名

什么地方都少不了这种小技巧，可让你少打不少字。

<typeAlias type="com.someapp.model.User" alias="User"/>

6. ResultMap

官方文档上说这个特性是整个MyBatis中 最强大 的特性（没有之一）。其实它作的就是映射结果集。

MyBatis底层使用JDBC，因此查询出来的结果是ResultSet，若是resultType是一个对象，MyBatis底层就会建立一个resultMap，并根据字段名一一对应上这个对象。若是你有一个查询，它的结果集很是复杂，可使用resultMap来作映射。

cache和cach-ref

使用cache标签在映射文件内（某命名空间内）实现二级缓存，其全部属性都有缺省值，因此单单一个标签就能够生效。cach-ref能够在两个映射文件之间共享缓存

<cache
        eviction="LRU"//缓存移除策略
        flushInterval="60000"//默认不设置，不定时刷新
        size="1024"
        readOnly="false"/>

4、动态SQL

1. if

条件判断，参数为test

2. choose (嵌套when，otherwise)

多选一，参数为test

3. trim (where，set)

• trim标签能够定制其余标签，而且去头去尾；
• where标签会自动生成where语句，而且能够去除头部的and或者or；
• set标签能够自动生成set语句，而且能够去除尾部的逗号。

4. foreach

循环集合输出，能够循环数组，Iterable对象，或者Map，若是是Map，则index会是key。

<foreach item="item" index="index" collection="list"
  open="(" separator="," close=")">
    #{item}
</foreach>

5. bind

声明一个使用OGNL表达式生成的变量，在sql语句中使用。