Mybatis学习3之配置

MyBatis的配置文件属性

Mybatis配置文件的文件结构如下代码所示：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><properties/>        <!--配置--><settings/>        <!--设置--><typeAliases/> <!--类型别名--><typeHandler/>   <!--类型处理器--><objectFactory/>    <!--对象工厂--><plugins/>       <!--插件--><environments> <!--配置环境--><environment>    <!--环境变量--><transactionManager/>        <!--事务管理器--><dataSource/>               <!--数据源--></environment></environments><databaseIdProvider/>        <!--数据库厂商标识--><mappers>         <!--映射器-->
</configuration>

（一）properties元素

properties是一个配置属性的元素，可以用来从外部加载属性文件，例如Mybatis学习1中的数据源的配置信息，便是从db.properties属性配置文件中加载进来的，同时也可以在Mybatis配置文件内部通过properties元素配置数据源的属性，如下：

<properties><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><property name="username" value="root"/><property name="password" value="123456"/>
</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>

如此我们就将数据源信息配置完成了。
同样的我们还有另外一种方式，同过使用properties配置文件获取数据源属性，在项目的src目录下添加一个db.properties配置文件,配置文件中的配置信息为如下所示：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/test
username=root
password=1234

只需在mybatis配置文件中添加如下代码即可：

<properties resource="db.properties" />

这两种配置方式可以混合使用，但是并不建议混合使用，这样会使得管理变得混乱，推荐使用properties配置文件。

（二）settings(设置)

settings在mybatis中的配置是最复杂的，但也是最重要的配置内容之一，当然即使我们不配置它，mybatis也能够正常运行，Mybatis配置内容请参考官方文档，暂时了解即可，一个完整settings配置的代码如下：

<settings><setting name="cacheEnabled" value="true"/><setting name="lazyLoadingEnabled" value="true"/><setting name="multipleResultSetsEnabled" value="true"/><setting name="useColumnLabel" value="true"/><setting name="useGeneratedKeys" value="false"/><setting name="autoMappingBehavior" value="PARTIAL"/><setting name="autoMappingUnknownColumnBehavior" value="WARNING"/><setting name="defaultExecutorType" value="SIMPLE"/><setting name="defaultStatementTimeout" value="25"/><setting name="defaultFetchSize" value="100"/><setting name="safeRowBoundsEnabled" value="false"/><setting name="mapUnderscoreToCamelCase" value="false"/><setting name="localCacheScope" value="SESSION"/><setting name="jdbcTypeForNull" value="OTHER"/><setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

（三）typeAliases(别名)

此配置可以使用，也可以不使用，通过对某个类设置别名，可以书写别名作为类型，例如下述所示：

<typeAliases><typeAlias alias="user" type="com.muke.User"/>
</typeAliases>

当需要引用User类时，显然它的名字较长，我们可以使用它的别名，即user,它就代表了User类。系统定义的相关别名请参考官方文档包括基本数据类型，包装器类型，集合类型等等。
上述代码为自定义别名，因为系统所给别名往往是不够使用的，我们需要为我们自己创建的一些类型定义别名，我们使用别名来代替全路径名（包名+类名），其目的是为了减少配置的复杂度。
同过自动扫描包的形式定义别名，首先定义需要扫描的包：

<typeAliases><package name="com.muke.pojo"/>
</typeAliases>

然后在我们需要定义别名的类上面使用@Alias注解，如下：

@Alias("user")
public class User{private int id;//...
}

如上两段代码，表示扫描com.muke.pojo包下的User类，定义其别名为user,另外也可以不写注解，此时也会定义别名，会将其类名的第一个字母改为小写。

（四）typeHandler(类型处理器)

Mybatis在预处理语句（PreparedStatement）中设置一个参数时，或者从结果集取出一个参数时，都会使用注册了typeHandler的处理器进行处理。
typeHandler与typeAliases一样分为系统定义的处理器和自定义处理器，typeHandler的常用配置为Java类型（javaType）,JDBC类型（jdbcType）,类型处理器的作用就是从数据库中将jdbcType转换为javaType和将参数从javaType转换为jdbcType,请参考官方文档.

（五）objectFactory(对象工厂)

当Mybatis在构建一个结果返回时，都会使用objectFactory去构建pojo，可以自定义对象工厂，但通常我们使用默认的对象工厂，这里不做过多讲述，可以参考官方文档，注意，大部分情况下，我们无需自己配置objectFactory，使用系统默认即可。

（六）plugins(插件)

插件比较复杂，当我们了解过mybatis运行的原理后再去学习它，而且在开始学习Mybatis时也暂时用不上，后续学习可以慢慢去了解。

（七）environments(配置环境)

默认环境和环境 ID 顾名思义。环境可以随意命名，但务必保证默认的环境 ID 要匹配其中一个环境 ID。比如default=“development” id=“development”。
事务管理器（transactionManager）
配置环境中，我们前面已经了解过一个了，配置数据源，我们首先了解一下，另外一个，事务管理器，在Mybatis中有两种事务管理器。
JDBC：采用JDBC管理事务，这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域。
MANAGED：采用容器方式管理事务，在JNDI数据源中常用；
提示如果你正在使用 Spring + MyBatis，则没有必要配置事务管理器，因为 Spring 模块会使用自带的管理器来覆盖前面的配置。

<transactionManager type="JDBC"/>

数据源（dataSource）
Mybatis为我们提供了三种数据源实现方式。
UNPOOLED：这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢，但对那些数据库连接可用性要求不高的简单应用程序来说，是一个很好的选择。性能表现则依赖于使用的数据库，对某些数据库来说，使用连接池并不重要，这个配置就很适合这种情形；
POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。这种处理方式很流行，能使并发 Web 应用快速响应请求；
JNDI：这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的数据源引用；

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

使用DBCP数据源需要我们提供一个类去配置它，如下配置：

<dataSource type="xx.xx.DbcpDataSourceFactory" >

（八）databaseIdProvider(数据库厂商标识)

在实际应用中，使用的比较少,了解即可，Mybatis提供默认配置规则为：

<databaseIdProvider type="DB_VENDOR"><property name="SQL Server" value="sqlserver"/><property name="DB2" value="db2"/><property name="Oracle" value="oracle" /><property name="MySQL" value="mysql" />
</databaseIdProvider>

（九）mappers(映射器)

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

<!-- 使用相对于类路径的资源引用 -->
<mappers><mapper resource="com/muke/mybatis/userMapper.xml"/><mapper resource="com/muke/mybatis/bookMapper.xml"/>
</mappers>

<!-- 使用完全限定资源定位符（URL） -->
<mappers><mapper url="file:///var/mappers/userMapper.xml"/><mapper url="file:///var/mappers/bookMapper.xml"/>
</mappers>

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers><mapper class="com.muke.mapper.UserMapper"/><mapper class="com.muke.mapper.BookMapper"/>
</mappers>

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers><package name="com.muke.mapper"/>
</mappers>

参考MyBatis中文文档