配置文件的体系架构说明

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 外部配置，动态替换，可以将配置信息抽取到配置文件中 -->
    <properties resource="org/mybatis/example/config.properties">
        <property name="username" value="dev_user"/>
        <property name="password" value="F2Fa3!33TYyg"/>
    </properties>

    <!-- 极为重要的调整设置，它们会改变 MyBatis 的运行时行为，下面是setting设置配置示例 -->
    <settings>
        <!-- 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。默认为true-->
        <setting name="cacheEnabled" value="true"/>

        <!-- 延迟加载的全局开关。
        当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。
        默认为false -->
        <setting name="lazyLoadingEnabled" value="true"/>

        <!--
        开启时，任一方法的调用都会加载该对象的所有延迟加载属性。
        否则，每个延迟加载属性会按需加载（参考 lazyLoadTriggerMethods)。
        默认为false （在 3.4.1 及之前的版本中默认为 true）-->
        <setting name="aggressiveLazyLoading" value="false"/>

        <!-- 是否允许单个语句返回多结果集（需要数据库驱动支持）。默认为true-->
        <setting name="multipleResultSetsEnabled" value="true"/>

        <!-- 使用列标签代替列名。实际表现依赖于数据库驱动，具体可参考数据库驱动的相关文档，或通过对比测试来观察。默认为true-->
        <setting name="useColumnLabel" value="true"/>

        <!-- 允许 JDBC 支持自动生成主键，需要数据库驱动支持。
        如果设置为 true，将强制使用自动生成主键。尽管一些数据库驱动不支持此特性，但仍可正常工作（如 Derby）。
        默认为false-->
        <setting name="useGeneratedKeys" value="false"/>

        <!-- 指定 MyBatis 应如何自动映射列到字段或属性。
        NONE 表示关闭自动映射；
        PARTIAL 只会自动映射没有定义嵌套结果映射的字段；
        FULL 会自动映射任何复杂的结果集（无论是否嵌套）。
        默认为 PARTIAL-->
        <setting name="autoMappingBehavior" value="PARTIAL"/>

        <!-- 指定发现自动映射目标未知列（或未知属性类型）的行为。
        NONE: 不做任何反应
        WARNING: 输出警告日志（'org.apache.ibatis.session.AutoMappingUnknownColumnBehavior' 的日志等级必须设置为 WARN）
        FAILING: 映射失败 (抛出 SqlSessionException)
        默认为 NONE-->
        <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>

        <!-- 配置默认的执行器。
        SIMPLE 就是普通的执行器；
        REUSE 执行器会重用预处理语句（PreparedStatement）；
        BATCH 执行器不仅重用语句还会执行批量更新。
        默认为SIMPLE-->
        <setting name="defaultExecutorType" value="SIMPLE"/>

        <!-- 设置超时时间，它决定数据库驱动等待数据库响应的秒数。默认为未设置null-->
        <setting name="defaultStatementTimeout" value="25"/>

        <!-- 为驱动的结果集获取数量（fetchSize）设置一个建议值。此参数只可以在查询设置中被覆盖。默认为未设置null-->
        <setting name="defaultFetchSize" value="100"/>

        <!-- 是否允许在嵌套语句中使用分页（RowBounds）。如果允许使用则设置为 false。-->
        <setting name="safeRowBoundsEnabled" value="false"/>

        <!-- 是否开启驼峰命名自动映射，即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。    true | false
        默认为False-->
        <setting name="mapUnderscoreToCamelCase" value="false"/>

        <!--
        MyBatis 利用本地缓存机制（Local Cache）防止循环引用和加速重复的嵌套查询。
        默认值为 SESSION，会缓存一个会话中执行的所有查询。
        若设置值为 STATEMENT，本地缓存将仅用于执行语句，对相同 SqlSession 的不同查询将不会进行缓存。-->
        <setting name="localCacheScope" value="SESSION"/>

        <!-- 当没有为参数指定特定的 JDBC 类型时，
        空值的默认 JDBC 类型。 某些数据库驱动需要指定列的 JDBC 类型，多数情况直接用一般类型即可，
        比如 NULL、VARCHAR 或 OTHER。-->
        <setting name="jdbcTypeForNull" value="OTHER"/>

        <!-- 指定对象的哪些方法触发一次延迟加载。用逗号分隔的方法列表。-->
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    </settings>

    <!-- 类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置，意在降低冗余的全限定类名书写-->
    <typeAliases>
        <typeAlias alias="Author" type="domain.blog.Author"/>
        <typeAlias alias="Blog" type="domain.blog.Blog"/>
        <typeAlias alias="Comment" type="domain.blog.Comment"/>
        <typeAlias alias="Post" type="domain.blog.Post"/>
        <typeAlias alias="Section" type="domain.blog.Section"/>
        <typeAlias alias="Tag" type="domain.blog.Tag"/>
    </typeAliases>

    <!-- 指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean-->
    <typeAliases>
        <package name="domain.blog"/>
    </typeAliases>

    <!--
    配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中，
    现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置；
    或者想在具有相同 Schema 的多个生产数据库中使用相同的 SQL 映射。还有许多类似的使用场景。
    不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
    -->
    <environments default="development">
        <environment id="development">
            <!--
            两种类型的事务管理器（也就是 type="[JDBC|MANAGED]";
            JDBC – 这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域;
            MANAGED – 这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接。然而一些容器并不希望连接被关闭，因此需要将 closeConnection 属性设置为 false 来阻止默认的关闭行为
           注意：使用 Spring + MyBatis，则没有必要配置事务管理器，因为 Spring 模块会使用自带的管理器来覆盖前面的配置。
            -->
            <transactionManager type="JDBC"/>

            <!--
            dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
            大多数 MyBatis 应用程序会按示例中的例子来配置数据源。虽然数据源配置是可选的，但如果要启用延迟加载特性，就必须配置数据源。
            有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）;
            UNPOOLED– 这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢，但对那些数据库连接可用性要求不高的简单应用程序来说，是一个很好的选择。 性能表现则依赖于使用的数据库，对某些数据库来说，使用连接池并不重要，这个配置就很适合这种情形。UNPOOLED 类型的数据源仅仅需要配置以下 5 种属性：
                driver – 这是 JDBC 驱动的 Java 类全限定名（并不是 JDBC 驱动中可能包含的数据源类）。
                url – 这是数据库的 JDBC URL 地址。
                username – 登录数据库的用户名。
                password – 登录数据库的密码。
                defaultTransactionIsolationLevel – 默认的连接事务隔离级别。
                defaultNetworkTimeout – 等待数据库操作完成的默认网络超时时间（单位：毫秒）。查看 java.sql.Connection#setNetworkTimeout() 的 API 文档以获取更多信息。
            POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。 这种处理方式很流行，能使并发 Web 应用快速响应请求。
                driver – 这是 JDBC 驱动的 Java 类全限定名（并不是 JDBC 驱动中可能包含的数据源类）。
                url – 这是数据库的 JDBC URL 地址。
                username – 登录数据库的用户名。
                password – 登录数据库的密码。
                defaultTransactionIsolationLevel – 默认的连接事务隔离级别。
                defaultNetworkTimeout – 等待数据库操作完成的默认网络超时时间（单位：毫秒）。查看 java.sql.Connection#setNetworkTimeout() 的 API 文档以获取更多信息。
                poolMaximumActiveConnections – 在任意时间可存在的活动（正在使用）连接数量，默认值：10
                poolMaximumIdleConnections – 任意时间可能存在的空闲连接数。
                poolMaximumCheckoutTime – 在被强制返回之前，池中连接被检出（checked out）时间，默认值：20000 毫秒（即 20 秒）
                poolTimeToWait – 这是一个底层设置，如果获取连接花费了相当长的时间，连接池会打印状态日志并重新尝试获取一个连接（避免在误配置的情况下一直失败且不打印日志），默认值：20000 毫秒（即 20 秒）。
                poolMaximumLocalBadConnectionTolerance – 这是一个关于坏连接容忍度的底层设置， 作用于每一个尝试从缓存池获取连接的线程。 如果这个线程获取到的是一个坏的连接，那么这个数据源允许这个线程尝试重新获取一个新的连接，但是这个重新尝试的次数不应该超过 poolMaximumIdleConnections 与 poolMaximumLocalBadConnectionTolerance 之和。 默认值：3（新增于 3.4.5）
                poolPingQuery – 发送到数据库的侦测查询，用来检验连接是否正常工作并准备接受请求。默认是“NO PING QUERY SET”，这会导致多数数据库驱动出错时返回恰当的错误消息。
                poolPingEnabled – 是否启用侦测查询。若开启，需要设置 poolPingQuery 属性为一个可执行的 SQL 语句（最好是一个速度非常快的 SQL 语句），默认值：false。
                poolPingConnectionsNotUsedFor – 配置 poolPingQuery 的频率。可以被设置为和数据库连接超时时间一样，来避免不必要的侦测，默认值：0（即所有连接每一时刻都被侦测 — 当然仅当 poolPingEnabled 为 true 时适用）。
            JNDI – 这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的数据源引用。这种数据源配置只需要两个属性：
                initial_context – 这个属性用来在 InitialContext 中寻找上下文（即，initialContext.lookup(initial_context)）。这是个可选属性，如果忽略，那么将会直接从 InitialContext 中寻找 data_source 属性。
                data_source – 这是引用数据源实例位置的上下文路径。提供了 initial_context 配置时会在其返回的上下文中进行查找，没有提供时则直接在 InitialContext 中查找。
            -->
            <dataSource type="POOLED">
                <!-- ${}由 properties 元素中设置的相应值来替换 -->
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 通过该配置告诉MyBatis到哪里去找到这些SQL语句 -->
    <mappers>
        <!-- 使用相对于类路径的资源引用 -->
        <mapper resource="mapper/CategoriesMapper.xml"/>

        <!-- 使用映射器接口实现类的完全限定类名 -->
        <mapper class="org.mybatis.builder.AuthorMapper"/>
      
        <!-- 使用完全限定资源定位符（URL） -->
        <mapper url="file:///var/mappers/AuthorMapper.xml"/>
    </mappers>
</configuration>