MyBatis：核心配置文件

本篇内容包括：MyBatis 配置文件概述以及核心配置文件详解（configuration、properties、settings、typeAliases、typeHandlers、objectFactory等）的内容。

一、概述

Mybatis 配置文件两大类：1.Mybatis 主配置文件；2.Mybatis 的 mapper 文件

1. Mybatis 主配置文件：提供 Mybatis 全局设置的。包含的内容、日志、数据源、mapper 文件位置等信息。
2. Mybatis 的 mapper 文件：写 sql 语句的。一个表/Mapper接口一个 mapper 文件。

二、核心配置文件

核心配置文件 mybatis-config.xml，配置文件会影响 mybatis 的行为设置和属性信息

MyBatis 配置文档的顶层结构如下：

• – configuration（配置）
• – properties（属性）
• ​ – property（属性信息）
• – settings（设置）
• – typeAliases（类型别名）
• – typeHandlers（类型处理器）
• – objectFactory（对象工厂）
• – plugins（插件）
• – environments（环境配置）
• ​ – environment（环境变量）
• ​ – transactionManager（事务管理器）
• ​ – dataSource（数据源）
• ​ – property（属性信息）
• – databaseIdProvider（数据库厂商标识）
• – mappers（映射器）

在配置文件里面添加这些配置，要按顺序来添加，不然会报错

1、properties（属性）

properties（属性）是用来加载配置文件或声明属性信息的，比如：

    <properties resource="db.properties">
        <property name="username" value="dev_user"/>-->
        <property name="password" value="F2Fa3!33TYyg"/>-->
    </properties>

2、settings（设置）

在 MyBatis 中 settings 是最复杂的配置，它能深刻影响 MyBatis 底层的运行，但是在大部分情况下使用默认值便可以运行，所以在大部分情况下不需要大量配置它，只需要修改一些常用的规则即可，比如自动映射、驼峰命名映射、级联规则、是否启动缓存、执行器（Executor）类型等

3、typeAliases（类型别名）

类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置，意在降低冗余的全限定类名书写

在Mybatis核心配置文件中配置（将Java类的全路径替换成一个别名，在xml使用）：

    <typeAliases>
        <typeAlias alias="User" type="com.hjxlog.domain.User"/>
    </typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，使用 Bean 的首字母小写的非限定类名来作为它的别名：

    <typeAliases>
        <package name="com.lizhengi.domain"/>
    </typeAliases>

使用注解的形式起别名：

@Alias("theUser")
public class User {}

    <select id="selectUserList" resultType="theUser">
        select * from public.user
    </select>

其中，mybatis 核心配置文件中配置优先级最高，开启包扫描后，如果还有另外配置注解，则以注解为准。

Ps：Java类型的别名，如果在前面加下划线_，映射的是基本类型，如果没有加下划线，映射的是包装类型。

4、typeHandlers（类型处理器）

由于Java 类型和数据库的 JDBC 类型不是一一对应的（比如 String 与 varchar）， 所以我们把 Java 对象转换为数据库的值，和把数据库的值转换成 Java 对象，需要经过 一定的转换，这两个方向的转换就要用到 TypeHandler。我们平时没有做任何关于 TypeHandler 的配置，为什么实体类对象里面的 String 属性，可以保存成数据库里面的 varchar 字段或者保存成 char 字段呢，这是因为 MyBatis 中已经内置了很多 TypeHandler。

typeHandlers（类型处理器）标签是用来重写或者自定义类型处理器的。

5、objectFactory（对象工厂）

当我们把数据库返回的结果集转换为实体类的时候，需要创建对象的实例，由于我 们不知道需要处理的类型是什么，有哪些属性，所以不能用 new 的方式去创建。在 MyBatis 里面，它提供了一个工厂类的接口，叫做 ObjectFactory，专门用来创建对象的实例。

typeHandlers（类型处理器）标签是用来重写或者自定义类型对象工厂的。

6、plugins（插件）

MyBatis 可以使用第三方的插件来对功能进行扩展，比如分页助手 PageHelper 是将分页的复杂操作进行封装，使用简单的方式即可获得分页的相关数据。

<!--配置分页助手插件-->
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageHelper">
            <property name="dialect" value="mysql"></property>
        </plugin>
    </plugins>

7、environments（环境配置）

mybatis 可以配置多套环境使用，将 SQL 映射到不同的数据库中。比如开发、测试和生产环境的数据库不同，需要不同的配置。但是，尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。有多少个环境，就需要多少个 SqlSessionFactory 实例。

		<!--    default为默认使用的环境    -->
    <environments default="development">
				<!--   id为development的环境    -->
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="org.postgresql.Driver"/>
                <property name="url" value="jdbc:postgresql://127.0.0.1:5432/postgres?useSSL=false"/>
                <property name="username" value="postgres"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
				<!--    id为test的环境    -->
        <environment id="test">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED"></dataSource>
            ...
        </environment>
    </environments>

事务管理器（transactionManager）有两种配置： type=“[JDBC|MANAGED]”

• JDBC：使用了 JDBC 的提交和回滚设施。
• MANAGED ： 这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期。

数据源（dataSource） 有三种类型：type=“[UNPOOLED|POOLED|JNDI]”

• UNPOOLED – 这个数据源的实现会每次请求时打开和关闭连接。
• POOLED – 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。默认的是这个。
• JNDI – 这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用。

8、databaseIdProvider（数据库厂商标识）

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。

MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。 如果同时找到带有 databaseId 和不带 databaseId 的相同语句，则后者会被舍弃。 为支持多厂商特性只要像下面这样在 mybatis-config.xml 文件中加入 databaseIdProvider 即可：

<databaseIdProvider type="DB_VENDOR" />

这里的 DB_VENDOR 会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。 由于通常情况下这个字符串都非常长而且相同产品的不同版本会返回不同的值，所以最好通过设置属性别名来使其变短，如下：

<databaseIdProvider type="DB_VENDOR">
  <property name="SQL Server" value="sqlserver"/>
  <property name="DB2" value="db2"/>        
  <property name="Oracle" value="oracle" />
</databaseIdProvider>

9、mappers（映射器）

映射器就是告诉 MyBatis 到哪里去找到这些语句。

方式一：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
</mappers>

方式二：

<!-- 使用完全限定资源定位符（URL） -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
</mappers>

方式三：

<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
</mappers>

注意：1.接口和mapper文件必须同名，2.接口和mapper文件在同一个包下

方式四：

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>