MyBatis02--Configuration.xml配置

前言：

上一篇文章，我们对Mybatis进行了简单的介绍，其中提到一个MyBatis的XML映射配置文件，即configuration.xml，在这里，我们对该xml文件进行一下详细的介绍。
（只介绍几个常用的，其它一些比较高级的设置，在真正的项目开发中，在慢慢补充。）

MyBatis的官方文档：http://www.mybatis.org/mybatis-3/zh/index.html

---

先说一下一个完整的XML映射配置文件包含的元素及层次结构，如下：

• configuration 配置
  
  • properties 属性
  • settings 设置
  • typeAliases 类型命名
  • typeHandlers 类型处理器
  • environments 环境
    
    • environment 环境变量
    • transactionManager 事务管理器
    • dataSource 数据源
  • databaseIdProvider 数据库厂商标识
  • mappers 映射器

---

1、typeAliases：

类型别名是为 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>

当这样配置时，Blog可以用在任何使用domain.blog.Blog的地方。

---

2、配置环境（environments）

MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置；或者共享相同 Schema 的多个生产数据库， 想使用相同的 SQL 映射。许多类似的用例。
有一个很关键的问题是：虽然你可以配置多种环境，但你只能为每个SqlSessionFactory实例选择一个。意思就是：每个数据库对应一个 SqlSessionFactory 实例
所以，如果你想连接两个数据库，就需要创建两个 SqlSessionFactory 实例，每个数据库对应一个。而如果是三个数据库，就需要三个实例，依此类推。
这是前面xml文件中的<environments></environments>

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/test"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
</environments>

对应的java代码为：
1）这是在默认环境环境下的加载，因为忽略了环境参数。

reader = Resources.getResourceAsReader("configuration.xml");
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);

2）另一种比较重要的方法是指定了创建的环境：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment,properties);

原则是：如果传入environment，指定的envrionment被绑定到SqlSessionFactory；如果不传入environment，default指定的environment被绑定到SqlSessionFactory。

关键点：

• 默认的环境 ID（比如:default=”development”）
• 每个 environment 元素定义的环境 ID（比如:id=”development”）
• 事务管理器的配置（比如:type=”JDBC”）
• 数据源的配置（比如:type=”POOLED”）

下面介绍一下环境元素：

1. 事务管理器（transactionManager）
在MyBatis中有两种事物管理器类型，一种是JDBC，一种是MANAGED。
- JDBC—-这个配置直接简单使用了JDBC的提交和回滚设置，它依赖于数据源得到的连接来管理事物范围
- MANAGED—-这个配置几乎不做什么。它从来不提交或回滚一个连接，而它会让容器来管理事物的整个生命周期（比如Spring或J2EE应用服务器的上下文），默认情况下它会关闭连接，然而一些容器并不希望这样，因此如果你需要从连接中停止它，将closeConnection属性设置为false，例如：


<transactionManager type="MANAGED">
<property name="closeConnection" value="false"/>
</transactionManager>

2. 数据源（dataSource）
dataSource元素使用基本的JDBC数据源接口来配置JDBC连接对象的资源。许多MyBatis的应用程序将会按照上面的示例来配置数据源，然而它并不是必须的，要知道为了方便使用使用延迟加载，数据源才是必须的。有三种内建的数据源类型（也就是type=”XXX”）：
（1）UNPOOLED

• driver—-这是JDBC驱动的Java类的完全限定名
• url—-这是数据库的JDBC URL地址
• username—-登陆数据库的用户名
• password—-登录数据库的密码
• defaultTransactionIsolationLevel—-默认的连接事物隔离级别
• driver.encoding—-传递数据库驱动的属性，前缀以”driver.”开头即可，”driver.encoding”表示的就是传递encoding属性

（2）UNPOOLED
这是JDBC连接对象的数据源连接池的实现，用来避免创建新的连接实例时必要的连接和认证时间。这是一种当前Web应用程序用来快速响应请求的很流行的方法。除了上述（UNPOOLED）的属性之外，还有些别的属性可以用来配置POOLED数据源：

• poolMaximumActiveConnections—-在任意时间存在的活动（也就是正在使用）连接的数量，默认值为10
• poolMaximumIdleConnections—-任意时间存在的空闲连接数
• poolMaximumCheckoutTime—-在被强制返回之前，池中连接被检查的时间，默认值为2000毫秒也就是20秒
• poolTimeToWait、poolPingQuery、poolPingEnabled、poolPingConnectionsNotUsedFor—-这些都是一些侦测数据库连接的属性

（3）JNDI
这个数据源的实现是为了使用如Spring或应用服务器这类的容器，容器可以集中或在外部配置数据源，然后放置一个JNDI上下文的引用。这个数据源只需要两个属性：

• initial_context—-这个属性用来从初始上下文寻找环境，这个是可选属性，如果被忽略，那么data_source属性将会直接以initialContext为背景再次寻找
• data_source—-这是引用数据源实例位置的上下文路径，它会以由initial_context查询返回的环境为背景来查找，如果initial_context没有返回结果时，直接以初始上下文为环境来查找

---

2、映射器（mappers）

既然 MyBatis 的行为已经由上述元素配置完了，我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在自动查找这方面没有提供一个很好的方法，所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用， 或完全限定资源定位符（包括 file:/// 的 URL），或类名和包名等。例如：

<!-- Using classpath relative resources -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

<!-- Using url fully qualified paths -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
  <mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>

<!-- Using mapper interface classes -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
</mappers>

<!-- Register all interfaces in a package as mappers -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

这些配置会告诉了 MyBatis 去哪里找映射文件，剩下的细节就应该是每个 SQL 映射文件了，我们会在下一篇文章中进行讨论。