• 从 XML 中构建 SqlSessionFactory

    从 XML 中构建 SqlSessionFactory

    每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。

    从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。 但是也可以使用任意的输入流（InputStream）实例，包括字符串形式的文件路径或者 file:// 的 URL 形式的文件路径来配置。MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件更加容易。 

    1. String resource = "org/mybatis/example/mybatis-config.xml";
    2. InputStream inputStream = Resources.getResourceAsStream(resource);
    3. SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    XML 配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。 XML 配置文件的详细内容后面再探讨，这里先给出一个简单的示例： 

    1. <?xml version="1.0" encoding="UTF-8" ?>
    2. <!DOCTYPE configuration
    3.   PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
    4.   "http://mybatis.org/dtd/mybatis-3-config.dtd">
    5. <configuration>
    6.   <environments default="development">
    7.     <environment id="development">
    8.       <transactionManager type="JDBC"/>
    9.       <dataSource type="POOLED">
    10.         <property name="driver" value="${driver}"/>
    11.         <property name="url" value="${url}"/>
    12.         <property name="username" value="${username}"/>
    13.         <property name="password" value="${password}"/>
    14.       </dataSource>
    15.     </environment>
    16.   </environments>
    17.   <mappers>
    18.     <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    19.   </mappers>
    20. </configuration>

    当然，还有很多可以在 XML 文件中进行配置，上面的示例指出的则是最关键的部分。 要注意 XML 头部的声明，它用来验证 XML 文档正确性。environment 元素体中包含了事务管理和连接池的配置。mappers 元素则是包含一组映射器（mapper），这些映射器的 XML 映射文件包含了 SQL 代码和映射定义信息。