【MyBatis】主配置文件

11.2【MyBatis】主配置文件

       MyBatis的 XML 配置文件包含了影响 MyBatis 行为很深的设置和属性信息，也可称之为主配置文件。此 XML文档的层级结构如下：

       

       configuration一>配置

       properties一>属性

       settings一>设置

       typeAliases一>类型命名

       typeHandlers一>类型处理器

       objectFactory一>对象工厂

       plugins一>插件

       environments一>配置环境

       environment一>环境变量

       transactionManager一>事务管理器

       dataSource一>数据源

       databaseIdProvider一>数据库厂商标识

       mappers一>映射器

       必须注意的是，MyBatis 配置项的顺序不能颠倒。如果其顺序颠倒了，则会在 MyBatis 启动阶段发生异常，导致程序无法运行。例如，可能会产生如下的报错信息：

org.xml.sax.SaxParseException: The content of elment type "configuration must match"
        "(properties?,setting?,typeAliases?,...,
environments?databaseIdProvider?,mappers?)"

      1.properties（属性）

       MyBatis 提供了 3 种方式来使用 properties，分别如下

       （1）property子元素。

       （2）properties 文件。

       （3）程序代码传递。

       properties 属性可以通过property 子元素来传递也可以配置在典型的Java属性配置文件中。例如：        

<properties resource="org/mybatis/example/jdbc.properties">
  <property name="username" value="boy" />
    <property name="password" value="1" />
</properties>

       其中的属性可以在整个配置文件中使用，使用可替换的属性（参数）来实现动态配置。

例如：        

<dataSource type="POOLED">
    <property name="driver" value="${driver}"/>
    <property name="url" value="${url}"/>
    <property name="username" value="${username}" />
    <property name="password" value="${password}" />
</dataSource>

       其中，username 和 password 将会由 property 子元素中设置的值来替换。driver 和 url 属性将会由包含进来的jdbc.properties文件中的值来替换。

       属性也可以被传递到SqlSessionBuilder.build()方法中。例如：

SqlSessionFactory factory=sqlSessionFactoryBuilder.build(reader， props);
//...or...
SqlSessionFactory factory = qlSessionFactoryBuilder,build(reader,environmentprops);

       如果属性多于一个，则MyBatis将按照如下的顺序进行属性加载。

       1）在 properties 元素体内指定的属性被读取。

       2）从类路径下资源或者 properties 元素的 url 属性中加载的属性被读取它会覆盖已经存在的完全一样的属性。

       3）作为方法参数传递的属性最后被读取，它也会覆盖任一已经存在的完全一样的属性这些属性可能是从 properties 元素体内和资源或者 url 属性中加载的。

       因此，最高优先级的属性是那些作为方法参数的属性，其次是资源 /url 属性，最后是 properties 元素中指定的属性。

       2.settings(设置)

       settings 会改变 MyBatis 在运行时的行为方式是 MyBatis 中极为重要的调整设置。表11-1描述了 MyBatis 的设置信息，以及其含义和默认值。

       3.typeAliases(别名)

       类型别名是为 Java类型命名的一个短的名称。它只和XM配置有关，存在的意义仅在于用来减少类完全限定名的冗余。例如：

 <typeAliases>
        <typeAliasalias="Blog” type="domain.blog.Blog"/></typeAliases>
</typeAliases>
<typeAliases>
        <package name="com.mialab.mybatisdemo.domainu/>
</typeAliases>

               这样，每一个包中的JavaBean在没有注解的情况下，会使用Bean的首字母小写的非限定类名来作为它的别名。

       如果在包中的实体类中发现了 @Alias 注解，则将使用注解的值作为它的别名。例如，com.mialab.mybatis.demo.domain包下存在Student实体类，并且有以下代码。

        那么，可用“student”来作为“com.mialab.mybatisdemo.domain.Student”的别名。

@Alias("student")
public class Student {
        ...
}

       4.typeHandlers类型处理器

       无论是MyBatis在预处理语句中设置一个参数，还是从结果集中取出一个值，类型处理器都被用来将获取的值以合适的方式转换成Java 类型。

      5.objectFactory 对象工厂

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

       6.plugins(插件)

       MyBatis允许用户在已映射语句执行过程中的某一点进行拦截调用默认情况下MBatis允许使用插件来拦截的接口和方法包括以下几个。

Executor (update,query,flushStatements,commit,rollback,getTransaction,closerisClosed)
ParameterHandler (getParameterObject，setParameters)
ResultSetHandler(handleResultSets,handleCursorResultSets,
handleOutputResultSetHandlerParameters)
StatementHandler (prepare,parameterizer batch, update, query)

       这4个接口及其包含的方法的细节可以通过查看每个方法的签名来了解，或者直接查看MyBatis 发行包中的源代码。假设用户想做的不仅仅是监控方法的调用，那么应该很好地了解正在重写的方法的行为。因为在试图修改或重写已有方法行为的时候，很可能会破坏 MBatis的核心模块，这些都是底层的类和方法，所以使用插件的时候要特别当心。

      7.environments (配置环境)

       MyBatis可以配置多种环境，这种机制使得MyBatis可以将SOL映射应用于多种数据库中。例如，开发、测试和生产环境需要有不同的配置。尽管可以配置多个环境，但是每个SqlSessionFactory实例只能选择一个环境，即每个数据库对应一个SlSessionFactory实例。所以如果想连接两个数据库，就需要创建两个SqlSessionFactory实例，每个数据库对应一个。

       8.mappers (映射器)

       既然MyBatis的行为已经由上述元素配置现在需要开发者自己编写SQL映射语。mappers会告诉MyBatis到哪里去找映射文件，进而找到这些SOL语句。实际开发中，可以使用相对于类路径的资源引用或完全限定资源定位符(包括file:///URLs)类名或者包名等。例如：

<!-- Using classpath relative resources -->
<mappers>
  <mapper resource-"org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
</mappers>
<!-- Using url fully qualified paths -->
<mappers>
  <mapper url=file://va/mappers/AuthorMapper.xml"/>
  <mapper url=fl://var/mappers/BlogMapper.xm."/>
</mappers>
<!-- Using mapper interface classes -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMappr"/>
</mappers>
<!-- Register all interfaces in a package as mappers -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>