1.1 MyBatis 核心配置

  每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。
  从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。 但是也可以使用任意的输入流(InputStream)实例，包括字符串形式的文件路径或者 file:// 的 URL 形式的文件路径来配置。MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件更加容易。
  XML 配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源(DataSource)和决定事务作用域和控制方式的事务管理器(TransactionManager)。要注意 XML 头部的声明，它用来验证 XML 文档正确性。environment 元素体中包含了事务管理和连接池的配置。mappers 元素则是包含一组映射器(mapper)，这些映射器的 XML 映射文件包含了 SQL 代码和映射定义信息。
  配置文件中标签要按照顺序书写 properties ☞ settings ☞ typeAliases ☞ typeHandlers ☞ objectFactory ☞ objectWrapperFactory ☞ reflectorFactory ☞ plugins ☞ environments ☞ databaseIdProvider mappers

1.1.1 properties（属性）

  属性都是可外部配置且可动态替换的，可以在 Java 属性文件中配置，然后其中的属性就可以在整个配置文件中使用 ${} 来替换需要动态配置的属性值。properties 元素的子元素也可以配置属性，例如：

<properties resource="jdbc.properties">
	<property name="username" value="root"/>
	<property name="password" value="F2Fa3!33TYyg"/>
</properties>

1.1.2 setting（设置）

  setting 是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。 下表描述了设置中各项的意图、默认值。

1.1.3 typeAliases（别名）

  使用 typeAliases 可以给全限定名起别名，在 mapper 映射文件中就可以使用别名替换全限定名了，namespace 除外，它不能使用别名。除了我们是自定义的别名，MyBatis 框架已经为我们设置好的一些常用的类型的别名。注意在配置文件中有先后顺序， typeAliases 要放到前面。

  还可以直接指定 package，MyBatis 会自动扫描指定包下面的 Java Bean，并且默认设置一个别名，默认的名字为：Java Bean 的类名首字母小写来作为它的别名。如果在 Java Bean 类上加了 @Alias 注解后将不再使用默认别名，而是指定别名。

1.1.4 typeHandlers（类型处理器）

  无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时，还是从结果集中取出一个值时， 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。下表描述了一些默认的类型处理器。

  可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。具体做法为：实现 org.apache.ibatis.type.TypeHandler 接口， 或继承一个很便利的类 org.apache.ibatis.type.BaseTypeHandler， 然后可以选择性地将它映射到一个 JDBC 类型。例如：一个 Java 中的 Date 数据类型，将之存到数据库的时候存成一个毫秒数，取出来时转换成 java 的 Date，即 java 的 Date 与数据库的 varchar 毫秒值之间转换。

public class DateTypeHandler extends BaseTypeHandler<Date> {

    // 将 java 类型 转换成 数据库需要的类型
    public void setNonNullParameter(PreparedStatement ps, int i, Date date, JdbcType jt) throws SQLException {
        long time = date.getTime();
        ps.setLong(i, time);
    }


    // 将数据库中类型 转换成 java 类型
    // String 参数  要转换的字段名称
    // ResultSet 查询出的结果集
    public Date getNullableResult(ResultSet resultSet, String s) throws SQLException {

        // 获得结果集中需要的数据 long 转换成 Date 类型 返回
        long aLong = resultSet.getLong(s);
        Date date = new Date(aLong);
        return date;
    }


    // 将数据库中类型 转换成 java 类型
    public Date getNullableResult(ResultSet resultSet, int i) throws SQLException {
        long aLong = resultSet.getLong(i);
        Date date = new Date(aLong);
        return date;
    }


    // 将数据库中类型 转换成 java 类型
    public Date getNullableResult(CallableStatement callableStatement, int i) throws SQLException {
        long aLong = callableStatement.getLong(i);
        Date date = new Date(aLong);
        return date;
    }

}

<typeHandlers>
    <typeHandler handler="com.software.mybatis.DateTypeHandler" />
</typeHandlers>

1.1.5 plugins（插件）

  MyBatis 可以使用第三方的插件来对功能进行扩展，例如分页助手 PageHelper 是将分页的复杂操作进行封装，使用简单的方式即可获得分页的相关数据。只需要两步我们就将一个插件配置完毕了，然后根据相关 API 使用该插件即可。

☞ 相关依赖

<!-- 分页助手 -->
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>3.7.5</version>
</dependency>
<dependency>
    <groupId>com.github.jsqlparser</groupId>
    <artifactId>jsqlparser</artifactId>
    <version>0.9.1</version>
</dependency>

☞ 配置插件

<plugin interceptor="com.github.pagehelper.PageHelper">
    <!-- 指定方言 -->
    <property name="dialect" value="mysql"/>
</plugin>

1.1.6 environments（环境配置）

☞ 事务管理器类型

 ♞ JDBC：这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
 ♞ MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期(比如 Java EE 应用服务器的上下文)。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

☞ 数据源类型

 ♞ UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。
 ♞ POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。
 ♞ JNDI：这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

1.1.7 mapper（映射器）

☞ 加载方式

 ♞ 使用相对于类路径的资源引用，例如：<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
 ♞ 使用完全限定资源定位符(URL)，例如：<mapper url="file:///var/mappers/AuthorMapper.xml"/>
 ♞ 使用映射器接口实现类的完全限定类名，例如：<mapper class="org.mybatis.builder.AuthorMapper"/>
 ♞ 将包内的映射器接口实现全部注册为映射器，例如：<package name="org.mybatis.builder"/>

1.2 MyBatis 映射文件

1.2.1 select

  查询语句是 MyBatis 中最常用的元素之一，光能把数据存到数据库中价值并不大，只有还能重新取出来才有用，多数应用也都是查询比修改要频繁。对每个插入、更新或删除操作，通常间隔多个查询操作。这是 MyBatis 的基本原则之一，也是将焦点和努力放在查询和结果映射的原因。简单查询的 select 元素是非常简单的。比如：

<select id="selectPerson" parameterType="int" resultType="hashmap">
  SELECT * FROM PERSON WHERE ID = #{id}
</select>

  这个语句被称作 selectPerson，接受一个 int(或 Integer)类型的参数，并返回一个 HashMap 类型的对象，其中的键是列名，值便是结果行中的对应值。#{id} 就是告诉 MyBatis 创建一个预处理语句(PreparedStatement)参数，在 JDBC 中，这样的一个参数在 SQL 中会由一个 ? 来标识，并被传递到一个新的预处理语句中。select 元素允许你配置很多属性来配置每条语句的作用细节：

1.2.2 insert

  插入语句的配置规则更加丰富，在插入语句里面有一些额外的属性和子元素用来处理主键的生成，而且有多种生成方式。首先，如果你的数据库支持自动生成主键的字段(比如 MySQL)，那么可以设置 useGeneratedKeys="true"，然后再把 keyProperty 设置到目标属性上就 OK 了。例如：

<insert id="insertAuthor" useGeneratedKeys="true" keyProperty="id">
  insert into Author (username,password,email,bio)
  values (#{username},#{password},#{email},#{bio})
</insert>

1.2.3 update、delete

update 和 delete 的实现与 insert 非常接近，元素属性也基本一致。

<update
  id="updateAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">
 </update>
 
<delete
  id="deleteAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">
</delete>

1.3 MyBatis 的 API

1.3.1 SqlSession

  使用 MyBatis 的主要 Java 接口就是 SqlSession。你可以通过这个接口来执行命令，获取映射器和管理事务。我们会概括讨论一下 SqlSession 本身，但是首先我们还是要了解如何获取一个 SqlSession 实例。SqlSession 是由 SqlSessionFactory 实例创建的。SqlSessionFactory 对象包含创建 SqlSession 实例的所有方法。而 SqlSessionFactory 本身是由 SqlSessionFactoryBuilder 创建的，它可以从 XML、注解或手动配置 Java 代码来创建 SqlSessionFactory。

1.3.2 SqlSessionFactoryBuilder

  SqlSessionFactoryBuilder 有五个 build() 方法，每一种都允许你从不同的资源中创建一个 SqlSessionFactory 实例。常用的为 SqlSessionFactory build(InputStream inputStream) 通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象。

String resource = "org/mybatis/builder/mybatis-config.xml"; 
InputStream inputStream = Resources.getResourceAsStream(resource); 
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder(); 
SqlSessionFactory factory = builder.build(inputStream);

1.3.3 SqlSessionFactory

  SqlSessionFactory 有六个方法创建 SqlSession 实例。常用的有两种，SqlSession openSession() 会默认开启一个事务，但事务不会自动提交，也就意味着需要手动提交该事务，更新操作数据才会持久化到数据库中；SqlSession openSession(boolean autoCommit) 参数为是否自动提交，如果设置为true，那么不需要手动提交事务。

1.3.4 SqlSession 的使用

  执行语句方法被用来执行定义在 SQL 映射的 XML 文件中的 SELECT、INSERT、UPDATE 和 DELETE 语句。它们都会自行解释，每一句都使用语句的 ID 属性和参数对象，参数可以是原生类型（自动装箱或包装类）、JavaBean、POJO 或 Map。

<T> T selectOne(String statement, Object parameter)
<E> List<E> selectList(String statement, Object parameter)
<T> Cursor<T> selectCursor(String statement, Object parameter)
<K,V> Map<K,V> selectMap(String statement, Object parameter, String mapKey)
int insert(String statement, Object parameter)
int update(String statement, Object parameter)
int delete(String statement, Object parameter)

  事务控制有四个方法。如果已经设置了自动提交或你正在使用外部事务管理器，这就没有任何效果了。默认情况下 MyBatis 不会自动提交事务，除非它侦测到有插入、更新或删除操作改变了数据库。如果已经做出了一些改变而没有使用这些方法，那么你可以传递 true 值到 commit 和 rollback 方法来保证事务被正常处理(注意，在自动提交模式或者使用了外部事务管理器的情况下设置 force 值对 session 无效)。很多时候不用调用 rollback()，因为 MyBatis 会在你没有调用 commit 时替你完成回滚操作。然而，如果需要在支持多提交和回滚的 session 中获得更多细粒度控制，可以使用回滚操作来达到目的。

void commit()
void commit(boolean force)
void rollback()
void rollback(boolean force)