MyBatis XML 映射配置文件

在前面说了MyBatis入门，了解了开发的基本流程。从上一篇博客中，我们可以发现MyBatis主要配置文件有两个，一个是mybatis-config.xml（名称不固定），一个是实体类与表之间的映射文件（根据实体的个数，可能存在多个）。这里先来总结一下mybatis-config.xml配置文件。

    mybatis-config.xml主要的功能就是为MyBatis指定数据库相关信息、实体与表的映射配置文件、MyBatis运行时的一些方式设置、插件配置等等。

其主要有：

·properties 属性

·settings 设置

·typeAliases 类型命名

·typeHandlers 类型处理器

·objectFactory 对象工厂

·plugins 插件

·environments 环境

·environment 环境变量

·transactionManager 事务管理器

·dataSource 数据源

·databaseIdProvider chinese?

·mappers 映射器

properties

主要配置数据库中的驱动、url、用户名、密码等信息，这个大家做JDBC时都很熟悉了，就不多说了。

settings

主要是为了控制MyBatis在运行时的行为方式，下面是定义的属性和其表示的意义

typeAliases

类别名，是为了Java类型命名一个简短的名称，注意的是它只和XML配置有关。

<typeAliases>
  <typeAlias alias="Blog" type="com.iflytek.model.Blog"/>
 </typeAliases>

使用这个配置，Blog就可以替代com.iflytek.model.Blog

typeHandlers

无论是MyBatis在预处理语句中设置一个参数, 还是从结果集中取出一个值时, 类型处理器被用来将获取的值以合适的方式转换成Java类型。下面这个表格描述了默认的类型处理器。

你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型

@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-config.xml -->
<typeHandlers>
  <typeHandler handler="org.mybatis.example.ExampleTypeHandler"/>
</typeHandlers>

使用这样的类型处理器将会覆盖已经存在的处理Java的String类型属性和VARCHAR参数及结果的类型处理器。要注意MyBatis不会审视数据库元信息来决定使用哪种类型, 所以你必须在参数和结果映射中指定那是VARCHAR类型的字段,来绑定到正确的类型处理器上。这是因为MyBatis直到语句被执行都不知道数据类型的这个现实导致的。

environments

MyBatis可以配置多种环境。这会帮助我们将SQL映射应用于多种数据库中。例如，你也许为开发要设置不同的配置，测试和生产环境。或者你可能有多种生产级数据库却共享相同的模式，所以你会想对不同数据库使用相同的SQL映射。这里需要注意的是你可以配置多种环境，但是你只能为每个SqlSessionFactory实例选择一个。所以，如果你想连接两个数据库,你需要创建两个 SqlSessionFactory 实例,每个数据库对应一个。

为了明确创建哪种环境,你可以将它作为可选的参数传递给 SqlSessionFactoryBuilder。 可以接受环境配置的两个方法签名是：

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

配置环境

<environments default="development">
		<environment id="development">
			<!-- 使用JDBC的事务管理 -->
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${database.driver}" />
				<property name="url" value="${database.url}" />
				<property name="username" value="${database.username}" />
				<property name="password" value="${database.password}" />
			</dataSource>
		</environment>

	</environments>

说明：

    1、Default，默认的环境，可以随意定义，但是environment中的Id则必须指定到default；

    2、MyBatis中有两种事务管理，即type=”[JDBC|MANAGED]”。JDBC ，这个配置直接简单使用了JDBC的提交和回滚设置。它依赖于从数据源得到的连接来管理事务范围。MANAGED，这个配置几乎没做什么。它从来不提交或回滚一个连接。而它会让容器来管理事务的整个生命周期(比如 Spring 或 JEE 应用服务器的上下文) 默认情况下它会关闭连接。 然而一些容器并不希望这样, 因此如果你需要从连接中停止它,需要将 closeConnection 属性设置为 false。

    ３、对于dataSource，MyBatis中提供了三种内建的数据源类型

· UNPOOLED ：这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢, 这是对简单应用程序的一个很好的选择, 因为它不需要及时的可用连接。 不同的数据库对这个的表现也是不一样的, 所以对某些数据库来说配置数据源并不重要, 这个配置也是闲置的。 UNPOOLED 类型的数据源仅仅用来配置以下 5 种属性: driver、url、username、password、defaultTransactionIsolationLevel(默认的连接事务隔离级别)

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

•poolMaximumActiveConnections – 在任意时间存在的活动(也就是正在使用)连 接的数量。默认值:10

•poolMaximumIdleConnections – 任意时间存在的空闲连接数。

•poolMaximumCheckoutTime – 在被强制返回之前,池中连接被检查的时间。默认 值:20000 毫秒(也就是 20 秒)

•poolTimeToWait – 这是给连接池一个打印日志状态机会的低层次设置,还有重新 尝试获得连接, 这些情况下往往需要很长时间 为了避免连接池没有配置时静默失败)。默认值:20000 毫秒(也就是 20 秒)

•poolPingQuery – 发送到数据的侦测查询,用来验证连接是否正常工作,并且准备 接受请求。默认是“NO PING QUERY SET” ,这会引起许多数据库驱动连接由一 个错误信息而导致失败。

•poolPingEnabled – 这是开启或禁用侦测查询。如果开启,你必须用一个合法的 SQL 语句(最好是很快速的)设置 poolPingQuery 属性。默认值:false。

•poolPingConnectionsNotUsedFor – 这是用来配置 poolPingQuery 多次时间被用一次。 这可以被设置匹配标准的数据库连接超时时间, 来避免不必要的侦测。 默认值: 0(也就是所有连接每一时刻都被侦测-但仅仅当 poolPingEnabled 为 true 时适用)。

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

•initial_context – 这 个 属 性 用 来 从 初 始 上 下 文 中 寻 找 环 境 ( 也 就 是 initialContext.lookup(initial——context) 。这是个可选属性,如果被忽略,那么 data_source 属性将会直接以 initialContext 为背景再次寻找。

•data_source – 这是引用数据源实例位置的上下文的路径。它会以由initial_context 查询返回的环境为背景来查找,如果 initial_context 没有返回结果时,直接以初始 上下文为环境来查找。

mappers

既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要定义SQL映射语句了。 但是, 首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java在这方面没有提供一个很好的方法, 所以最佳的方式是告诉 MyBatis到哪里去找映射文件。你可以使用相对于类路径的资源引用,或者字符表示,或url引用的完全限定名(包括 file:///URLs) 。

<!-- 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>