myBatis核心配置参考

<?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">

<!--
文档前置说明：
  以下对于mybatis核心配置文件的解读参考mybatis官网文档：
    https://mybatis.org/mybatis-3/zh/
-->


<!-- 配置的顶层标签，所有都需要在其中配置 -->
<configuration>
  <!--
  标签前置说明：
    MyBatis核心配置文件，标签的顺序：
      properties 属性
      settings 设置
      typeAliases 类型别名
      typeHandlers 类型处理器
      objectFactory 对象工厂

      //在mybatis-3-config.dtd约束文件中，存在该两个标签，
      //但是官网文档介绍上没有提到，网上百度也几乎没看到
      objectWrapperFactory 对象包装工厂
      reflectorFactory 反射器工厂

      plugins 插件
      environments 环境
      databaseIdProvider 数据库厂商标识
      mappers 映射器
   -->


  <!--
  properties 属性：
    可以在子标签中进行配置，属性也可以在外部进行配置。
    设置好的属性可以在整个配置文件中用来替换需要动态配置的属性值。
    使用${属性名}语法进行获取

    使用${属性名}语法进行获取的属性，属性的数据源可以由
    SqlSessionFactoryBuilder.build(reader/inputStream, environment, props)
    进行指定props属性源

  属性加载顺序：
    首先读取在properties元素体内指定的属性。
    然后根据properties元素中的resource属性读取类路径下属性文件，
    或根据url属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
    最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。

    所以最高优先级是直接传参的props属性源，次之的是properties中配置的
    外部数据源，最低优先级的是properties标签配置的局部属性源

  其他：
     MyBatis 3.4.2 后，可以为占位符指定一个默认值，${属性名:默认值}
     如果该属性名，没有被配置，那么默认该属性名为默认值
     该特性默认是关闭的可以配置
     org.apache.ibatis.parsing.PropertyParser.enable-default-value打开

     //以下内容摘抄于官网文档，并不清楚其含义**********************************************************************************
     如果你在属性名中使用了 ":" 字符（如：db:username），
     或者在 SQL 映射中使用了 OGNL 表达式的三元运算符
     (如： ${tableName != null ? tableName : 'global_constants'})，
     就需要设置特定的属性来修改分隔属性名和默认值的字符。
     设置org.apache.ibatis.parsing.PropertyParser.default-value-separator属性
   -->
  <properties resource="jdbc.properties">
    <!-- 配置特性用于控制mybatis行为 -->
    <!-- 启用默认值特性 -->
    <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/>
    <!-- 修改默认值的分隔符
    <property name="org.apache.ibatis.parsing.PropertyParser.default-value-separator" value="?:"/>
    -->


    <!-- property子元素配置属性 -->
    <!--
    <property name="driver" value="oracle.jdbc.driver.OracleDriver"/>
    <property name="url" value="jdbc:oracle:thin:@47.103.92.75:1521:ORCLCDB"/>
    <property name="username" value="test001"/>
    <property name="password" value="test001"/>
    -->
  </properties>


  <!--
  settings 设置：
    MyBatis中极为重要的调整设置，会改变MyBatis的运行时行为。
   -->
  <settings>
    <!--
    设置名：cacheEnabled
    有效值：true | false
    默认值：true
    描述：
      全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。
    备注：
     -->
    <setting name="cacheEnabled" value="true"/>
    <!--
    设置名：lazyLoadingEnabled
    有效值：true | false
    默认值：false
    描述：
      延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。
    备注：
     -->
    <setting name="lazyLoadingEnabled" value="false"/>
    <!--
    设置名：aggressiveLazyLoading
    有效值：true | false
    默认值：false （在 3.4.1 及之前的版本中默认为 true）
    描述：
      开启时，任一方法的调用都会加载该对象的所有延迟加载属性。 否则，每个延迟加载属性会按需加载（参考 lazyLoadTriggerMethods)。
    备注：
     -->
    <setting name="aggressiveLazyLoading" value="false"/>
    <!--
    设置名：multipleResultSetsEnabled
    有效值：true | false
    默认值：true
    描述：
      是否允许单个语句返回多结果集（需要数据库驱动支持）。
    备注：
     -->
    <setting name="multipleResultSetsEnabled" value="true"/>
    <!--
    设置名：useColumnLabel
    有效值：true | false
    默认值：true
    描述：
      使用列标签代替列名。实际表现依赖于数据库驱动，具体可参考数据库驱动的相关文档，或通过对比测试来观察。
    备注：
     -->
    <setting name="useColumnLabel" value="true"/>
    <!--
    设置名：useGeneratedKeys
    有效值：true | false
    默认值：false
    描述：
      允许 JDBC 支持自动生成主键，需要数据库驱动支持。如果设置为 true，将强制使用自动生成主键。尽管一些数据库驱动不支持此特性，但仍可正常工作（如 Derby）。
    备注：
     -->
    <setting name="useGeneratedKeys" value="false"/>
    <!--
    设置名：autoMappingBehavior
    有效值：NONE, PARTIAL, FULL
    默认值：PARTIAL
    描述：
      指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示关闭自动映射；PARTIAL 只会自动映射没有定义嵌套结果映射的字段。 FULL 会自动映射任何复杂的结果集（无论是否嵌套）。
    备注：
     -->
    <setting name="autoMappingBehavior" value="PARTIAL"/>
    <!--
    设置名：autoMappingUnknownColumnBehavior
    有效值：NONE, WARNING, FAILING
    默认值：NONE
    描述：
      指定发现自动映射目标未知列（或未知属性类型）的行为。
        NONE: 不做任何反应
        WARNING: 输出警告日志（'org.apache.ibatis.session.AutoMappingUnknownColumnBehavior' 的日志等级必须设置为 WARN）
        FAILING: 映射失败 (抛出 SqlSessionException)
    备注：
     -->
    <setting name="autoMappingUnknownColumnBehavior" value="NONE"/>
    <!--
    设置名：defaultExecutorType
    有效值：SIMPLE REUSE BATCH
    默认值：SIMPLE
    描述：
      配置默认的执行器。SIMPLE 就是普通的执行器；REUSE 执行器会重用预处理语句（PreparedStatement）； BATCH 执行器不仅重用语句还会执行批量更新。
    备注：
     -->
    <setting name="defaultExecutorType" value="SIMPLE"/>
    <!--
    设置名：defaultStatementTimeout
    有效值：任意正整数
    默认值：未设置 (null)
    描述：
      设置超时时间，它决定数据库驱动等待数据库响应的秒数。
    备注：
     -->
    <setting name="defaultStatementTimeout" value=""/>
    <!--
    设置名：defaultFetchSize
    有效值：任意正整数
    默认值：未设置 (null)
    描述：
      为驱动的结果集获取数量（fetchSize）设置一个建议值。此参数只可以在查询设置中被覆盖。
    备注：
     -->
    <setting name="defaultFetchSize" value=""/>
    <!--
    设置名：defaultResultSetType
    有效值：FORWARD_ONLY | SCROLL_SENSITIVE | SCROLL_INSENSITIVE | DEFAULT（等同于未设置）
    默认值：未设置 (null)
    描述：
      指定语句默认的滚动策略。（新增于 3.5.2）
    备注：
     -->
    <setting name="defaultResultSetType" value=""/>
    <!--
    设置名：safeRowBoundsEnabled
    有效值：true | false
    默认值：false
    描述：
      是否允许在嵌套语句中使用分页（RowBounds）。如果允许使用则设置为 false。
    备注：
     -->
    <setting name="safeRowBoundsEnabled" value="false"/>
    <!--
    设置名：safeResultHandlerEnabled
    有效值：true | false
    默认值：true
    描述：
      是否允许在嵌套语句中使用结果处理器（ResultHandler）。如果允许使用则设置为 false。
    备注：
     -->
    <setting name="safeResultHandlerEnabled" value="true"/>
    <!--
    设置名：mapUnderscoreToCamelCase
    有效值：true | false
    默认值：false
    描述：
      是否开启驼峰命名自动映射，即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。
    备注：
     -->
    <setting name="mapUnderscoreToCamelCase" value="false"/>
    <!--
    设置名：localCacheScope
    有效值： SESSION | STATEMENT
    默认值：SESSION
    描述：
      MyBatis 利用本地缓存机制（Local Cache）防止循环引用和加速重复的嵌套查询。 默认值为 SESSION，会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT，本地缓存将仅用于执行语句，对相同 SqlSession 的不同查询将不会进行缓存。
    备注：
     -->
    <setting name="localCacheScope" value="SESSION"/>
    <!--
    设置名：jdbcTypeForNull
    有效值：JdbcType 常量，常用值：NULL、VARCHAR 或 OTHER。
    默认值：OTHER
    描述：
      当没有为参数指定特定的 JDBC 类型时，空值的默认 JDBC 类型。 某些数据库驱动需要指定列的 JDBC 类型，多数情况直接用一般类型即可，比如 NULL、VARCHAR 或 OTHER。
    备注：
     -->
    <setting name="jdbcTypeForNull" value="OTHER"/>
    <!--
    设置名：lazyLoadTriggerMethods
    有效值：用逗号分隔的方法列表。
    默认值：equals,clone,hashCode,toString
    描述：
      指定对象的哪些方法触发一次延迟加载。
    备注：
     -->
    <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    <!--
    设置名：defaultScriptingLanguage
    有效值：一个类型别名或全限定类名。
    默认值：org.apache.ibatis.scripting.xmltags.XMLLanguageDriver
    描述：
      指定动态 SQL 生成使用的默认脚本语言。
    备注：
     -->
    <setting name="defaultScriptingLanguage" value="org.apache.ibatis.scripting.xmltags.XMLLanguageDriver"/>
    <!--
    设置名：defaultEnumTypeHandler
    有效值：一个类型别名或全限定类名。
    默认值：org.apache.ibatis.type.EnumTypeHandler
    描述：
      指定 Enum 使用的默认 TypeHandler 。（新增于 3.4.5）
    备注：
     -->
    <setting name="defaultEnumTypeHandler" value="org.apache.ibatis.type.EnumTypeHandler"/>
    <!--
    设置名：callSettersOnNulls
    有效值：true | false
    默认值：false
    描述：
      指定当结果集中值为 null 的时候是否调用映射对象的 setter（map 对象时为 put）方法，这在依赖于 Map.keySet() 或 null 值进行初始化时比较有用。注意基本类型（int、boolean 等）是不能设置成 null 的。
    备注：
     -->
    <setting name="callSettersOnNulls" value="false"/>
    <!--
    设置名：returnInstanceForEmptyRow
    有效值：true | false
    默认值：false
    描述：
      当返回行的所有列都是空时，MyBatis默认返回 null。 当开启这个设置时，MyBatis会返回一个空实例。 请注意，它也适用于嵌套的结果集（如集合或关联）。（新增于 3.4.2）
    备注：
     -->
    <setting name="returnInstanceForEmptyRow" value="false"/>
    <!--
    设置名：logPrefix
    有效值：任何字符串
    默认值：未设置
    描述：
      指定 MyBatis 增加到日志名称的前缀。
    备注：
     -->
    <setting name="logPrefix" value=""/>
    <!--
    设置名：logImpl
    有效值：SLF4J | LOG4J（3.5.9 起废弃） | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING
    默认值：未设置
    描述：
      指定 MyBatis 所用日志的具体实现，未指定时将自动查找。
    备注：
     -->
    <setting name="logImpl" value=""/>
    <!--
    设置名：proxyFactory
    有效值：CGLIB （3.5.10 起废弃） | JAVASSIST
    默认值：JAVASSIST （MyBatis 3.3 以上）
    描述：
      指定 Mybatis 创建可延迟加载对象所用到的代理工具。
    备注：
     -->
    <setting name="proxyFactory" value="JAVASSIST"/>
    <!--
    设置名：vfsImpl
    有效值：自定义 VFS 的实现的类全限定名，以逗号分隔。
    默认值：未设置
    描述：
      指定 VFS 的实现
    备注：
     -->
    <setting name="vfsImpl" value=""/>
    <!--
    设置名：useActualParamName
    有效值：true | false
    默认值：true
    描述：
      允许使用方法签名中的名称作为语句参数名称。 为了使用该特性，你的项目必须采用 Java 8 编译，并且加上 -parameters 选项。（新增于 3.4.1）
    备注：
     -->
    <setting name="useActualParamName" value="true"/>
    <!--
    设置名：configurationFactory
    有效值：一个类型别名或完全限定类名。
    默认值：未设置
    描述：
      指定一个提供 Configuration 实例的类。 这个被返回的 Configuration 实例用来加载被反序列化对象的延迟加载属性值。 这个类必须包含一个签名为static Configuration getConfiguration() 的方法。（新增于 3.2.3）
    备注：
    -->
    <setting name="configurationFactory" value=""/>
    <!--
    设置名：shrinkWhitespacesInSql
    有效值：true | false
    默认值：false
    描述：
      从SQL中删除多余的空格字符。请注意，这也会影响SQL中的文字字符串。 (新增于 3.5.5)
    备注：
     -->
    <setting name="shrinkWhitespacesInSql" value="false"/>
    <!--
    设置名：defaultSqlProviderType
    有效值：类型别名或者全限定名
    默认值：未设置
    描述：
      指定一个拥有 provider 方法的 sql provider 类 （新增于 3.5.6）. 这个类适用于指定 sql provider 注解上的type（或 value） 属性（当这些属性在注解中被忽略时）。 (e.g. @SelectProvider)
    备注：
     -->
    <setting name="defaultSqlProviderType" value=""/>
    <!--
    设置名：nullableOnForEach
    有效值：true | false
    默认值：false
    描述：
      为 'foreach' 标签的 'nullable' 属性指定默认值。（新增于 3.5.9）
    备注：
     -->
    <setting name="nullableOnForEach" value="false"/>
    <!--
    设置名：argNameBasedConstructorAutoMapping
    有效值：true | false
    默认值：false
    描述：
      当应用构造器自动映射时，参数名称被用来搜索要映射的列，而不再依赖列的顺序。（新增于 3.5.10）
    备注：
     -->
    <setting name="argNameBasedConstructorAutoMapping" value="false"/>
  </settings>


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

  属性加载：
    在仅使用typeAlias标签type属性不添加alias和package进行包加载情况下，
    如果涉及到的类没有添加@Alias("别名")进行指定别名的话，
    默认会将类的简单类名进行小写化(读是亦同)，进行注册别名，如果添加则别名为其注解值

    官方在文档中说，默认是Bean的首字母小写的非限定类名来作为它的别名，
    但是在mybatis-3源码在是以别名值小写进行注册(读是亦同)，意味着别名不区分大小写，
    尝试亦然符合猜测结果，但是还是推荐按照官方标准首字母小写和注解实际值进行使用

  内建别名：
    mybatis别名注册表为一些常见的Java类型注册了内建的类型别名。它们都是不区分大小写的，
    注意，为了应对原始类型的命名重复，采取了特殊的命名风格。
    eg：
      _byte对应byte，string对于String等等
    如果需要使用可以前往文档查看，或者在源码TypeAliasRegistry类型别名注册表中的源码中找到
   -->
  <typeAliases>
    <!-- 为该类(type中类型)配置一个别名(alias中别名) -->
    <typeAlias alias="user" type="com.sdjzu.mybatis.pojo.User"></typeAlias>
    <!-- 指定一个包名，MyBatis会在包名下面搜索需要的Java Bean -->
    <package name="com.sdjzu.mybatis.pojo"/>
  </typeAliases>


  <!--
  typeHandlers 类型处理器：
    MyBatis 在设置预处理语句(PreparedStatement)中的参数或从结果集中取出一个值时， 都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。下表描述了一些默认的类型处理器。
    提示：从 3.4.5 开始，MyBatis默认支持JSR-310(日期和时间API)。

  默认的一下类型处理器：
    参考下面typeHandlers标签内注解

  构建类型处理器：
    可以重写已有的类型处理器或创建自己的类型处理器来处理不支持的或非标准的类型。
    具体做法为：
      实现org.apache.ibatis.type.TypeHandler接口，
      或继承一个很便利的类org.apache.ibatis.type.BaseTypeHandler，
      并且可以（可选地）将它映射到一个JDBC类型。
    eg：示例类型处理器代码
    /*
    ExampleTypeHandler.java
    继承BaseTypeHandler，映射JDBC类型为JdbcType.VARCHAR
    该类型处理器将会覆盖已有的处理Java String类型的属性以及VARCHAR类型的参数和结果的类型处理器。

    java处理类型：
      通过类型处理器的泛型，MyBatis可以获取处理的Java类型
      也可以通过@MappedTypes注解指定与其关联的Java类型列表
      或者在类型处理器的配置元素(typeHandler元素)上增加一个javaType属性(eg：javaType="String")
      两者中同时指定，则typeHandler.javaType属性优先
    jdbc处理类型：
       也可以通过@MappedJdbcTypes注解指定与其关联的JDBC类型列表
       或者在类型处理器的配置元素(typeHandler元素)上增加一个jdbcType属性(eg：jdbcType="VARCHAR")
       两者中同时指定，则typeHandler.jdbcType属性优先
    */
    @MappedJdbcTypes(JdbcType.VARCHAR)
    public class ExampleTypeHandler extends BaseTypeHandler<String> {
      //设置非空参数
      @Override
      public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter);
      }
      //获得可为空的结果
      @Override
      public String getNullableResult(ResultSet rs, String columnName) throws SQLException {
        return rs.getString(columnName);
      }
      //获得可为空的结果
      @Override
      public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        return rs.getString(columnIndex);
      }
      //获得可为空的结果
      @Override
      public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        return cs.getString(columnIndex);
      }
    }

    使用类型处理器：
      要注意MyBatis不会通过检测数据库元信息来决定使用哪种类型，
      意味着MyBatis直到语句被执行时才能获取到jdbc数据类型
      所以必须在参数和结果映射中指明字段的类型，
      以使其能够绑定到正确的类型处理器上。

      当在ResultMap中决定使用哪种类型处理器时，
      此时Java类型是已知的(从结果类型中获得)，
      但是JDBC类型是未知的。
      因此Mybatis使用javaType=[Java 类型],jdbcType=null的组合来选择一个类型处理器。
      这意味着使用@MappedJdbcTypes注解可以限制类型处理器的作用范围，
      并且可以确保，除非显式地设置，否则类型处理器在ResultMap中将不会生效。
      如果希望能在ResultMap中隐式地使用类型处理器，
      那么设置@MappedJdbcTypes注解的includeNullJdbcType=true即可。
      然而从Mybatis 3.4.0开始，
      如果某个Java类型只有一个注册的类型处理器，
      即使没有设置includeNullJdbcType=true，
      那么这个类型处理器也会是ResultMap使用Java类型时的默认处理器。
   -->
  <typeHandlers>
    <!-- 默认类型处理器 -->
    <!--
    类型处理器：BooleanTypeHandler
    Java类型：java.lang.Boolean, boolean
    JDBC类型：数据库兼容的 BOOLEAN
    备注：
    -->
    <!--
    类型处理器：ByteTypeHandler
    Java类型：java.lang.Byte, byte
    JDBC类型：数据库兼容的 NUMERIC 或 BYTE
    备注：
    -->
    <!--
    类型处理器：ShortTypeHandler
    Java类型：java.lang.Short, short
    JDBC类型：数据库兼容的 NUMERIC 或 SMALLINT
    备注：
    -->
    <!--
    类型处理器：IntegerTypeHandler
    Java类型：java.lang.Integer, int
    JDBC类型：数据库兼容的 NUMERIC 或 INTEGER
    备注：
    -->
    <!--
    类型处理器：LongTypeHandler
    Java类型：java.lang.Long, long
    JDBC类型：数据库兼容的 NUMERIC 或 BIGINT
    备注：
    -->
    <!--
    类型处理器：FloatTypeHandler
    Java类型：java.lang.Float, float
    JDBC类型：数据库兼容的 NUMERIC 或 FLOAT
    备注：
    -->
    <!--
    类型处理器：DoubleTypeHandler
    Java类型：java.lang.Double, double
    JDBC类型：数据库兼容的 NUMERIC 或 DOUBLE
    备注：
    -->
    <!--
    类型处理器：BigDecimalTypeHandler
    Java类型：java.math.BigDecimal
    JDBC类型：数据库兼容的 NUMERIC 或 DECIMAL
    备注：
    -->
    <!--
    类型处理器：StringTypeHandler
    Java类型：java.lang.String
    JDBC类型：CHAR, VARCHAR
    备注：
    -->
    <!--
    类型处理器：ClobReaderTypeHandler
    Java类型：java.io.Reader
    JDBC类型：-
    备注：
    -->
    <!--
    类型处理器：ClobTypeHandler
    Java类型：java.lang.String
    JDBC类型：CLOB, LONGVARCHAR
    备注：
    -->
    <!--
    类型处理器：NStringTypeHandler
    Java类型：java.lang.String
    JDBC类型：NVARCHAR, NCHAR
    备注：
    -->
    <!--
    类型处理器：NClobTypeHandler
    Java类型：java.lang.String
    JDBC类型：NCLOB
    备注：
    -->
    <!--
    类型处理器：BlobInputStreamTypeHandler
    Java类型：java.io.InputStream
    JDBC类型：-
    备注：
    -->
    <!--
    类型处理器：ByteArrayTypeHandler
    Java类型：byte[]
    JDBC类型：数据库兼容的字节流类型
    备注：
    -->
    <!--
    类型处理器：BlobTypeHandler
    Java类型：byte[]
    JDBC类型：BLOB, LONGVARBINARY
    备注：
    -->
    <!--
    类型处理器：DateTypeHandler
    Java类型：java.util.Date
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：DateOnlyTypeHandler
    Java类型：java.util.Date
    JDBC类型：DATE
    备注：
    -->
    <!--
    类型处理器：TimeOnlyTypeHandler
    Java类型：java.util.Date
    JDBC类型：TIME
    备注：
    -->
    <!--
    类型处理器：SqlTimestampTypeHandler
    Java类型：java.sql.Timestamp
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：SqlDateTypeHandler
    Java类型：java.sql.Date
    JDBC类型：DATE
    备注：
    -->
    <!--
    类型处理器：SqlTimeTypeHandler
    Java类型：java.sql.Time
    JDBC类型：TIME
    备注：
    -->
    <!--
    类型处理器：ObjectTypeHandler
    Java类型：Any
    JDBC类型：OTHER 或未指定类型
    备注：
    -->
    <!--
    类型处理器：EnumTypeHandler
    Java类型：Enumeration Type
    JDBC类型：VARCHAR 或任何兼容的字符串类型，用来存储枚举的名称（而不是索引序数值）
    备注：
    -->
    <!--
    类型处理器：EnumOrdinalTypeHandler
    Java类型：Enumeration Type
    JDBC类型：任何兼容的 NUMERIC 或 DOUBLE 类型，用来存储枚举的序数值（而不是名称）。
    备注：
    -->
    <!--
    类型处理器：SqlxmlTypeHandler
    Java类型：java.lang.String
    JDBC类型：SQLXML
    备注：
    -->
    <!--
    类型处理器：InstantTypeHandler
    Java类型：java.time.Instant
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：LocalDateTimeTypeHandler
    Java类型：java.time.LocalDateTime
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：LocalDateTypeHandler
    Java类型：java.time.LocalDate
    JDBC类型：DATE
    备注：
    -->
    <!--
    类型处理器：LocalTimeTypeHandler
    Java类型：java.time.LocalTime
    JDBC类型：TIME
    备注：
    -->
    <!--
    类型处理器：OffsetDateTimeTypeHandler
    Java类型：java.time.OffsetDateTime
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：OffsetTimeTypeHandler
    Java类型：java.time.OffsetTime
    JDBC类型：TIME
    备注：
    -->
    <!--
    类型处理器：ZonedDateTimeTypeHandler
    Java类型：java.time.ZonedDateTime
    JDBC类型：TIMESTAMP
    备注：
    -->
    <!--
    类型处理器：YearTypeHandler
    Java类型：java.time.Year
    JDBC类型：INTEGER
    备注：
    -->
    <!--
    类型处理器：MonthTypeHandler
    Java类型：java.time.Month
    JDBC类型：INTEGER
    备注：
    -->
    <!--
    类型处理器：YearMonthTypeHandler
    Java类型：java.time.YearMonth
    JDBC类型：VARCHAR 或 LONGVARCHAR
    备注：
    -->
    <!--
    类型处理器：JapaneseDateTypeHandler
    Java类型：java.time.chrono.JapaneseDate
    JDBC类型：DATE
    备注：
    -->

    <!-- 配置类型处理器
    <typeHandler handler="全限定类名"/>
     -->
    <!-- 指定一个包名，MyBatis会在包名下面搜索类型处理器，使用该自动发现功能的时候，只能通过注解方式来指定JDBC的类型。
    <package name="包名"/>
     -->
  </typeHandlers>


  <!--
  objectFactory 对象工厂：
    每次MyBatis创建结果对象的新实例时，
    它都会使用一个对象工厂(ObjectFactory)实例来完成实例化工作。
    默认的对象工厂需要做的仅仅是实例化目标类，要么通过默认无参构造方法，
    要么通过存在的参数映射来调用带有参数的构造方法。
    如果想覆盖对象工厂的默认行为，可以通过创建自己的对象工厂来实现。

  构建对象工厂：
    eg：
      /*
      ExampleObjectFactory.java
      ObjectFactory接口很简单，它包含两个创建实例用的方法，
      一个是处理默认无参构造方法的，另外一个是处理带参数的构造方法的。
      另外，setProperties方法可以被用来配置ObjectFactory，
      在初始化你的ObjectFactory实例后，objectFactory元素体中定义的属性会被传递给setProperties方法。
      */
      public class ExampleObjectFactory extends DefaultObjectFactory {
        //构建类方法
        @Override
        public <T> T create(Class<T> type) {
          return super.create(type);
        }
        //构建类方法
        @Override
        public <T> T create(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs) {
          return super.create(type, constructorArgTypes, constructorArgs);
        }
        //设置属性
        @Override
        public void setProperties(Properties properties) {
          super.setProperties(properties);
        }
        //是收藏
        @Override
        public <T> boolean isCollection(Class<T> type) {
          return Collection.class.isAssignableFrom(type);
        }}

  <objectFactory type="工厂全类名">
    <property name="属性" value="值"/>
  </objectFactory>
   -->


  <!--
  plugins 插件：
    MyBatis允许在映射语句执行过程中的某一点进行拦截调用。

    默认情况下，MyBatis允许使用插件来拦截的方法调用包括：
      Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
      ParameterHandler (getParameterObject, setParameters)
      ResultSetHandler (handleResultSets, handleOutputParameters)
      StatementHandler (prepare, parameterize, batch, update, query)
    如果想要不仅仅是监控方法的调用，那么最好相当了解要重写的方法的行为，
    在试图修改或重写已有方法行为，因为MyBatis涉及核心。

  实现插件：
    只需实现Interceptor接口，并指定想要拦截的方法签名即可。
    eg：
      /*
      ExamplePlugin.java
      该插件将会拦截在Executor实例中所有的“update”方法调用，这里的Executor是负责执行底层映射语句的内部对象。

      除了用插件来修改MyBatis核心行为以外，还可以通过完全覆盖配置类来达到目的。
      只需继承配置类后覆盖其中的某个方法，再把它传递到SqlSessionFactoryBuilder.build(myConfig)方法即可。
      再次重申，这可能会极大影响MyBatis的行为，务请慎之又慎。
      */
      @Intercepts({@Signature(
        //拦截方法
        type= Executor.class,
        //拦截方法行为
        method = "update",
        //参数
        args = {MappedStatement.class,Object.class})})
      //继承Interceptor类
      public class ExamplePlugin implements Interceptor {
        private Properties properties = new Properties();

        //进行方法增强，这个意思有点像动态代理，但是又差点意思
        @Override
        public Object intercept(Invocation invocation) throws Throwable {
          // 根据需要进行预处理
          Object returnObject = invocation.proceed();
          // 根据需要实施后处理
          return returnObject;
        }

        //设置需求配置文件，提供后续调用
        @Override
        public void setProperties(Properties properties) {
          this.properties = properties;
        }
      }
   -->
  <plugins>
    <!-- 上面注释测试用例调用
    <plugin interceptor="org.mybatis.example.ExamplePlugin">
      <property name="someProperty" value="100"/>
    </plugin>
     -->

    <!--
    设置分页的插件
      该pagehelper分页插件，是mybatis常用插件，
      使用前需要导入坐标，如需查看详情坐标，可以进入pom.xml中查看，或者百度
      具体使用参考(https://blog.csdn.net/zgm_dj/article/details/124096125)
     -->
    <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
  </plugins>


  <!--
  environments 环境配置：
    MyBatis可以配置适应多种环境，配置映射多种数据库或者环境之中，
    尽管可以配置多个环境，但每个SqlSessionFactory实例只能选择一种环境。
    但是可以通过构建多个SqlSessionFactory实例实现同时连接多种环境数据库

    属性:
       default:设置默认使用的环境的id

  使用环境：
    在通过构建SqlSessionFactory时，
    可以将environment环境标签的id通过SqlSessionFactoryBuilder.build()中的environment参数，
    就会使用该id的环境构建成SqlSessionFactory工厂，
    不指定则使用environments标签中default属性中指定的默认环境id
   -->
  <environments default="development">

    <!--
    environment 环境：
      配置独立的数据库环境
    属性：
      id：唯一标识
        environments.default==当前environment.id
        表示默认使用该id的environment环境
     -->
    <environment id="development">

      <!--
      transactionManager 事务管理器 ：
        设置事务管理方式，在 MyBatis 中有两种类型的事务管理器

      属性：
        type：事务管理器类型
        有效值：JDBC/MANAGED/TransactionFactory接口实现类的全限定名或类型别名
          JDBC:
            直接使用了JDBC的提交和回滚功能，执行sql时，需要手动的提交和回滚事务，
            它依赖从数据源获得的连接来管理事务作用域。
            默认情况下，为了与某些驱动程序兼容，它在关闭连接时启用自动提交。
            但是部分驱动程序启用自动提交不必要，且该操作代价高昂。
            所以从3.5.10版本开始，可以通过将"skipSetAutoCommitOnClose"属性设置"true"跳过该行为。
          MANAGED：
            被管理类型，默认情况下基本上什么都不做，让容器来管理事务的整个生命周期(eg:JEE应用服务器的上下文等)，
            但是默认情况下每次会话完成后它会关闭连接。
            然而一些容器并不希望连接被关闭，
            因此可以将closeConnection属性设置为false来阻止默认的关闭行为。

        实现TransactionFactory接口：
          /*
          使用下面两个接口，可以完全自定义MyBatis对事务的处理。
          实现TransactionFactory
          */
          public interface TransactionFactory {

            // 从 3.5.2 开始，该方法为默认方法
            default void setProperties(Properties props) {
              // 空实现
            }
            Transaction newTransaction(Connection conn);
            Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit);
          }

          /*
          在事务管理器实例化后，所有在XML中配置的属性将会被传递给setProperties()方法。
          还需要创建一个Transaction接口的实现类。
          */
          public interface Transaction {
            Connection getConnection() throws SQLException;
            void commit() throws SQLException;
            void rollback() throws SQLException;
            void close() throws SQLException;
            Integer getTimeout() throws SQLException;
          }

      注释：如果使用的是Spring+MyBatis，则没有必要配置事务管理器，因为Spring模块会使用自带的管理器来覆盖前面的配置。
       -->
      <transactionManager type="JDBC">
        <!--
        在事务管理器类型为JDBC时使用的，为该驱动程序跳过关闭连接时自动提交行为

        <property name="skipSetAutoCommitOnClose" value="true"/>
         -->

        <!--
        在事务管理器类型为MANAGED时使用的，为该事务管理器跳过自动关闭连接的行为

        <property name="closeConnection" value="false"/>
         -->
    </transactionManager>

    <!--
    dataSource 数据源：
      dataSource元素使用标准的JDBC数据源接口来配置JDBC连接对象的资源。
      虽然数据源配置是可选的，但如果要启用延迟加载特性，就必须配置数据源。
    属性：
      type：设置数据源的类型
        有效值：POOLED/UNPOOLED/JNDI
          POOLED:表示使用数据库连接池缓存数据库连接
          UNPOOLED：表示不使用数据库连接池
          JNDI：表示使用上下文中的数据源


//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  三种数据源和实现自定义数据源等操作，下面基本上是官网原话，日后解析，目前仅用于参考
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


    UNPOOLED：
      这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢，但对那些数据库连接可用性要求不高的简单应用程序来说，是一个很好的选择。
      性能表现则依赖于使用的数据库，对某些数据库来说，使用连接池并不重要，这个配置就很适合这种情形。
      UNPOOLED类型的数据源仅仅需要配置以下 5 种属性：

      driver：这是 JDBC 驱动的 Java 类全限定名（并不是 JDBC 驱动中可能包含的数据源类）。
      url：这是数据库的 JDBC URL 地址。
      username：登录数据库的用户名。
      password：登录数据库的密码。
      defaultTransactionIsolationLevel：默认的连接事务隔离级别。
      defaultNetworkTimeout：等待数据库操作完成的默认网络超时时间（单位：毫秒）。

      查看java.sql.Connection#setNetworkTimeout()的API文档以获取更多信息。
      作为可选项，你也可以传递属性给数据库驱动。只需在属性名加上“driver.”前缀即可，例如：
        driver.encoding=UTF8
      这将通过DriverManager.getConnection(url, driverProperties)方法传递值为UTF8的encoding属性给数据库驱动。

    POOLED：
      这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。
      这种处理方式很流行，能使并发 Web 应用快速响应请求。
      除了上述提到UNPOOLED下的属性外，还有更多属性用来配置 POOLED 的数据源：

      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中查找。
        和其他数据源配置类似，可以通过添加前缀“env.”直接把属性传递给InitialContext。比如：

      env.encoding=UTF8
      这就会在InitialContext实例化时往它的构造方法传递值为UTF8的encoding属性。

    实现第三方数据源：
      可以通过实现接口org.apache.ibatis.datasource.DataSourceFactory来使用第三方数据源实现：
      eg：
        /*
        DataSourceFactory 数据源工厂接口
        */
        public interface DataSourceFactory {
          void setProperties(Properties props);
          DataSource getDataSource();
        }

        //官方的意思可能是说，使用实现了DataSourceFactory接口的UnpooledDataSourceFactory作父类为构建新的数据源适配器
        org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory可被用作父类来构建新的数据源适配器，
        //官方的意思可能是说，将外部c3p0数据库连接池，使用UnpooledDataSourceFactory接入，使其作为数据源适配器(举例)
        比如下面这段插入C3P0数据源所必需的代码：

          import org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory;
          import com.mchange.v2.c3p0.ComboPooledDataSource;

          public class C3P0DataSourceFactory extends UnpooledDataSourceFactory {

            public C3P0DataSourceFactory() {
              this.dataSource = new ComboPooledDataSource();
            }
          }

        使用该数据源连接PostgreSQL数据库：
          <dataSource type="org.myproject.C3P0DataSourceFactory">
            <property name="driver" value="org.postgresql.Driver"/>
            <property name="url" value="jdbc:postgresql:mydb"/>
            <property name="username" value="postgres"/>
            <property name="password" value="root"/>
          </dataSource>
   -->
      <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>


  <!--
  databaseIdProvider 数据库厂商标识：
    MyBatis 可以根据不同的数据库厂商执行不同的语句，
    多厂商的支持是基于映射语句中的databaseId属性。
    MyBatis会加载带有匹配当前数据库databaseId属性和所有不带databaseId属性的语句。
    如果同时找到带有databaseId和不带databaseId的相同语句，则后者会被舍弃。

  使用数据库厂商标识：
    可以在mapper.xml映射配置文件中的sql标签中添加databaseId属性使用databaseId或者别名，
    mybatis会更据上面的规则进行使用语句

    可以通过实现接口org.apache.ibatis.mapping.DatabaseIdProvider并在mybatis-config.xml中注册来构建自己的DatabaseIdProvider
   -->
  <databaseIdProvider type="DB_VENDOR" >
    <!--
    databaseId和别名的映射：
      一般情况下，会将数据库名作为别名(其他形式也无所谓)，
      将databaseId的值进行映射(应为该值通常很长，比方便使用)
      databaseId值为DatabaseMetaData#getDatabaseProductName()返回的值

    <property name="数据库名" value="databaseId"/>
     -->
  </databaseIdProvider>


  <!--
  mappers 映射器：
    引入sql映射文件
  告诉mybatis sql映射文件位置：
    可以使用相对于类路径的资源引用，或完全限定资源定位符（包括 file:/// 形式的 URL），或类名和包名等。
   -->
  <mappers>
    <!-- 使用xml -->

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

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

    <!-- 使用注解 -->

    <!-- 使用映射器接口实现类的完全限定类名
    <mapper class="org.mybatis.builder.AuthorMapper"/>
     -->

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