Mybatis最入门---Mapper文件配置详解（上）

[一步是咫尺，一步即天涯]

前文中，我们演示了最基本的HelloWorld程序，下面我们将介绍我们上面各项配置文件的详细解释，以及我们正式开发过程中，各种配置的注意事项等。

惯例，先来看看我们的准备工作有：

a.操作系统 ：win7 x64

b.基本软件：MySQL，Mybatis，Spring，SQLyog，Tomcat，web基础

-------------------------------------------------------------------------------------------------------------------------------------

1.环境配置

上文中我们示例代码如下：

....
<configuration>
	......
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${jdbc.driverClassName}" />
				<property name="url" value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />
			</dataSource>
		</environment>
	</environments>
	......
</configuration>

注意这里的关键点:

• 默认的环境 ID（比如:default=”development”）。在实际使用时，常见的环境配置有开发环境，测试环境，正式环境等。为了方便开发，mybatis提供给我们方便切换环境的方法，这里的ID需要对应下面的每个environment标签的ID值。
• 每个 environment 元素定义的环境 ID（比如:id=”development”）。在该标签中，我们需要配置每一个环境的具体参数，本例我们只是用到基本配置，更多用法见后文中的使用，敬请期待！

2.事务管理器的配置（比如:type=”JDBC”）。

• 在 MyBatis 中有两种类型的事务管理器（也就是 type=”[JDBC|MANAGED]”）：

  • JDBC – 这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务范围。
  • MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。
  • 特别的：如果正在使用 Spring + MyBatis，则没有必要配置事务管理器， 因为 Spring 模块会使用自带的管理器来覆盖前面的配置。具体用法见后文示例。

3.数据源的配置（共有3种：:type=”POOLED”，:type=”UNPOOLED”，:type=”JNDI”）。

POOLED---这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

• poolMaximumActiveConnections – 在任意时间可以存在的活动（也就是正在使用）连接数量，默认值：10
• poolMaximumIdleConnections – 任意时间可能存在的空闲连接数。
• poolMaximumCheckoutTime – 在被强制返回之前，池中连接被检出（checked out）时间，默认值：20000 毫秒（即 20 秒）
• poolTimeToWait – 这是一个底层设置，如果获取连接花费的相当长的时间，它会给连接池打印状态日志并重新尝试获取一个连接（避免在误配置的情况下一直安静的失败），默认值：20000 毫秒（即 20 秒）。
• poolPingQuery – 发送到数据库的侦测查询，用来检验连接是否处在正常工作秩序中并准备接受请求。默认是“NO PING QUERY SET”，这会导致多数数据库驱动失败时带有一个恰当的错误消息。
• poolPingEnabled – 是否启用侦测查询。若开启，也必须使用一个可执行的 SQL 语句设置 poolPingQuery 属性（最好是一个非常快的 SQL），默认值：false。
• poolPingConnectionsNotUsedFor – 配置 poolPingQuery 的使用频度。这可以被设置成匹配具体的数据库连接超时时间，来避免不必要的侦测，默认值：0（即所有连接每一时刻都被侦测 — 当然仅当 poolPingEnabled 为 true 时适用）。

UNPOOLED---这个数据源的实现只是每次被请求时打开和关闭连接。虽然一点慢，它对在及时可用连接方面没有性能要求的简单应用程序是一个很好的选择。 不同的数据库在这方面表现也是不一样的，所以对某些数据库来说使用连接池并不重要，这个配置也是理想的。UNPOOLED 类型的数据源仅仅需要配置以下 5 种属性：

• driver – 这是 JDBC 驱动的 Java 类的完全限定名（并不是JDBC驱动中可能包含的数据源类）。
• url – 这是数据库的 JDBC URL 地址。
• username – 登录数据库的用户名。
• password – 登录数据库的密码。
• defaultTransactionIsolationLevel – 默认的连接事务隔离级别。

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

• initial_context – 这个属性用来在 InitialContext 中寻找上下文（即，initialContext.lookup(initial_context)）。这是个可选属性，如果忽略，那么 data_source 属性将会直接从 InitialContext 中寻找。
• data_source – 这是引用数据源实例位置的上下文的路径。提供了 initial_context 配置时会在其返回的上下文中进行查找，没有提供时则直接在 InitialContext 中查找。

4.属性配置（动态配置，子元素配置）

动态配置：即通过porpeties文件来配置，如在HelloWorld工程中使用的方式即可。

子元素配置：这个不如直接看用法吧，如下：

<properties>
  <property name="username" value="root"/>
  <property name="password" value="1234"/>
</properties>

特别的：

如果属性在不只一个地方进行了配置，那么 MyBatis 将按照下面的顺序来加载：

• 在 properties 元素体内指定的属性首先被读取。
• 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件，并覆盖已读取的同名属性。
• 最后读取作为方法参数传递的属性，并覆盖已读取的同名属性。

因此，通过方法参数传递的属性具有最高优先级，resource/url 属性中指定的配置文件次之，最低优先级的是 properties 属性中指定的属性。

5.别名配置：类型别名是为 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>

这种用法会使得配置项非常非常多，因此我们推荐使用下面的方法进行配置。

<typeAliases>
  <package name="domain.blog"/>
</typeAliases>

即配置一个包路径，当前包下面的所有类都会被自动转化为一个JAVA BEAN.

特别的，当时用这种方法配置时，其别名是首字母小写的别名，如，Author对象的别名为author。同时，我们不难发现，在没有其他配置的情况下，最好不要出现相同命名的对象。如果实在需要时，要使用单独注解的方式来实现，具体使用如下：

@Alias("author")
public class Author {
    ...
}

另外，在Mybatis中已经创建了一些基本的别名对象，它们都是大小写不敏感的，需要注意的是由基本类型名称重复导致的特殊处理。具体如下：

别名	映射的类型
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal
object	Object
map	Map
hashmap	HashMap
list	List
arraylist	ArrayList
collection	Collection
iterator	Iterator

6.映射器（mappers）

所谓映射器，即Mybatis寻找数据库语句文件的配置。在HelloWorld中，我们演示里其中一种配置方式，现在我们我们总结一下我们可以使用的所有配置方法。

a.使用想对路径进行配置，如下：

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

b.使用文件定位符配置，如下：

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

c.使用接口配置

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

d.使用包路经配置，如下：

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

-------------------------------------------------------------------------------------------------------------------------------------

至此，Mybatis最入门---配置详解（上）结束，我们在HelloWorld工程中使用的配置已经介绍完毕，下文我们介绍一些我们后续可能会使用的配置项。

参考资料：

官方文档：http://www.mybatis.org/mybatis-3/