MyBatis | 全局配置文件

按照 MyBatis 官方文档的介绍顺序，接下来记录关于全局配置文件的内容。从这一章开始我决定使用 Maven 工具来进行配置，但是整体的架构是不变的

首先先罗列一下需要介绍的几个配置参数，由于使用频率问题，我只会对其中几个比较常用的作介绍
* properties：用来加载属性文件
* settings：设置全局参数
* typeAliases：用来设置类型的别名
* typeHandlers：用来设置类型处理器
* objectFactory：用来设置对象工厂
* plugins：用来设置插件
* environments：用来设置配置环境
* mappers：配置映射文件

1. properties 属性

我们之前使用 JDBC 的时候，都是调用外部的 jdbc.properties 配置文件，通过获取键对应的值来获取参数的，这里同样可以使用这种方法。不过，以后使用Spring整合时配置信息都写在Spring里。这里我们只是测试一下这种用法

jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?useSSL=false
jdbc.username=root
jdbc.password=lwh011305

配置文件 mybatis-config.xml

<properties resource="jdbc.properties"></properties>
<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC" />
        <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driver}" />
            <property name="url" value="${jdbc.url}" />
            <property name="username" value="${jdbc.username}" />
            <property name="password" value="${jdbc.password}" />
        </dataSource>
    </environment>
</environments>

Ⅰ.
<properties> 属性在外部使用时，可以引入外部的 properties 配置文件的内容，其中：
resource ：表示引入类路径下的资源
url：表示引入网络或者磁盘下路径下的资源
同时 <properties> 属性内部还可以使用 <property> 属性，其中可以定义 name 和 value

Ⅱ.
在 <property> 中定义的属性也可以被 <evironments> 来加载，上述代码中的 value 为对应 jdbc.properties 文件中的 key 值

Ⅲ.
这么多位置的 <property> 属性，那么应该先执行哪一个呢？官方文档给出了答案
* 在 properties 元素体内指定的属性首先被读取。
* 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件，并覆盖已读取的同名属性。
* 最后读取作为方法参数传递的属性，并覆盖已读取的同名属性。

PS：尽量不要把属性写在 properties 下，都写在外部的配置文件中，然后使用 <environment> 来调用

2. settings 设置

主要用来设置一些一些运行参数，由 name 和 value 两个参数组成，由于设置项比较多，此处不罗列了，可以去官方文档查看

3. typeAliases 类型别名

Ⅰ.

我们先看一个 sql 的配置文件 EmployeeMapper.xml

<mapper namespace="ee">
    <select id="emp" resultType="edu.just.mybatis.Employee">
        select id, last_name lastName, email, gender from Employee where id = #{id}
    </select>
</mapper>

其中的 resultType 属性，指定输出结果的类型，必须要输入全类名才行，如果只是输入类似 Employee 的类名，是跑不通的，此时可以使用类型别名

我们在 <typeAliases> 属性中设置 Employee 类的别名是 emp，此时我们就可以在 EmployeeMapper.xml 的 resultType 属性中输入 emp 即可

<typeAliases>
    <typeAlias type="edu.just.mybatis.bean.Employee" alias="emp"/>      
</typeAliases>

PS：如果我们没有设置 alias 属性，那么默认别名可以是 Employee 或者 employee，可以看到类名首字母部分大小写

Ⅱ.

我们还可以使用批量别名

<typeAliases>
    <package name="edu.just.mybatis.bean"/>
</typeAliases>

指定一个包名，mybatis 会自动的扫描包中所有 Java Bean，自动定义别名，类名上面没有注解的话，别名就是类名（首字母大写或小写都可以）。如果由注解，那么就是注解的设置的属性值

@Alias("emp2")
public class Employee {
     ...
}

PS：当然还有一些 Java 内置的相应类型的别名，以下是截至官方文档的图

4. environments 环境配置

一般情况下，我们会有两个环境，一个是自己搭建的测试环境，一个则是生产环境，那其中的具体配置，比如数据源，事务等等，肯定是不同的，这个时候就会用到环境配置

<environments default="development">

    <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="edu.just.mybatis.test.C3P0Test">
            <property name="driverClass" value="${jdbc.driver}" />
            <property name="jdbcUrl" value="${jdbc.url}" />
            <property name="user" value="${jdbc.username}" />
            <property name="password" value="${jdbc.password}" />
        </dataSource>
    </environment>

    <environment id="development">
        <transactionManager type="JDBC" />
        <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driver}" />
            <property name="url" value="${jdbc.url}" />
            <property name="username" value="${jdbc.username}" />
            <property name="password" value="${jdbc.password}" />
        </dataSource>
    </environment>

</environments>

上面我们配置了两个环境，根据环境的 id 加以区分，这个 id 相当于一个身份认证，标识了这个环境的用处，这里我标识了两个，一个是 test ，还有一个 development，此 id 会被环境的默认 id 调用（default），
default：默认的环境 id，这里我们使用的是第二个环境配置
transactionManager：事务管理器的配置（比如:type=”JDBC”）
dataSource：数据源的配置（比如:type=”POOLED”）

PS：当然，事务和数据源的配置以后都是在 Spring 中加以配置的，所以这里不加以详细阐述

5. mappers 映射器

Ⅰ.

<mapper> 标签是通过 resource 属性来加载 sql 映射文件的。当然，也可以使用 url 属性，这一点上述说过，不在赘述

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

Ⅱ.

<mapper> 还可以使用 class 属性来引用接口

<mappers>
    <mapper class="edu.just.mybatis.dao.EmployeeMapper"/>
</mappers>

我们映射了 EmployeeMapper 这个接口，但是此时，需要把 sql 映射文件 EmployeeMapper.xml 放到和接口一个包下，即放到包 edu.just.mybatis.dao 下。

Ⅲ.

<mappers>
    <package name="edu.just.mybatis.dao"/>
</mappers>

但是如果这个时候有不止一个 sql 映射文件，这时可以指定mapper接口的包名，mybatis自动扫描包下面所有的mapper接口进行加载，但是此时 sql 配置文件也需要放在相同名字的包下面。此时接口的名称和 sql 配置文件名字要一致
如图所示，我们把接口文件和 sql 文件放置在同一包下，同时除了后缀外，名字一定要相同