CMS项目总结：9、MyBatis初步：Config XML文件的分析

Mybatis是目前企业中流行的两大持久化框架之一（hibernate和mybatis）。

MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis使用简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plan Old Java Objects，普通的Java对象）映射成数据库中的记录。 

 

首先在类路径classpath下即src目录下创建一个SqlMapConfig.xml文件

 

现在在分析这个配置文件：

1、typeAliases

在mybatis中是需要通过全路径类名来区分类的，如果不定义别名的话，凡是用到的类全得写全路径类名。这句话的意思就是定义别名，即在具体实现的xml文件中可以直接写Article就知道是cn.com.leadfar.cms.backend.model.Article。使用这个配置，“Article”可以任意用来替代“cn.com.leadfar.cms.backend.model.Article”所使用的地方。

2、environments

MyBatis可以配置多种环境。这会帮助你将SQL映射应用于多种数据库之中。例如，你也许为开发要设置不同的配置，测试和生产环境。或者你可能有多种生产级数据库却共享相同的模式，所以你会想对不同数据库使用相同的SQL映射。这种用例是很多的。 

一个很重要的问题要记得：你可以配置多种环境，但你只能为每个SqlSessionFactory实例选择一个。 所以，如果你想连接两个数据库，你需要创建两个SqlSessionFactory实例，每个数据库对应一个。而如果是三个数据库，你就需要三个实例，以此类推。记忆起来很简单： 

Ø 每个数据库对应一个SqlSessionFactory 

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

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

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

如果环境被忽略，那么默认环境将会被加载，如下进行： 

SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader); 

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

环境元素定义了如何配置环境。 

<environments default="development"> 

<environment id="development"> 

<transactionManager type="JDBC"> 

<property name="..." value="..."/>  //这一行不知道是干嘛用的

</transactionManager> 

<dataSource type="POOLED"> 

<property name="driver" value="${driver}"/>       //（value="com.mysql.jdbc.Driver"）

<property name="url" value="${url}"/>       //（value="jdbc:mysql://localhost/cms"）

<property name="username" value="${username}"/>  //（value="root"）

<property name="password" value="${password}"/>   //（value="qimiguang"）

</dataSource> 

</environment> 

</environments> 

注意这里的键： 

l 默认的环境ID（比如：default=”development”）。 

l 每个environment元素定义的环境ID（比如：id=”development”）。 

l 事务管理器的配置（比如：type=”JDBC”）。 

l 数据源的配置（比如：type=”POOLED”）。 

默认的环境和环境ID是自我解释的。你可以使用你喜欢的名称来命名，只要确定默认的要匹配其中之一。 

transactionManager 

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

l JDBC – 这个配置直接简单使用了JDBC的提交和回滚设置。它依赖于从数据源得到的连接来管理事务范围。 

（l MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接。而它会让容器来管理事务的整个生命周期（比如Spring或JEE应用服务器的上下文）。默认情况下它会关闭连接。然而一些容器并不希望这样，因此如果你需要从连接中停止它，将closeConnection属性设置为false。例如： 

<transactionManager type="MANAGED"> 

<property name="closeConnection" value="false"/> 

</transactionManager>     估计是不重要）

（这两种事务管理器都不需要任何属性。然而它们都是类型别名，要替换使用它们，你需要放置将你自己的类的全路径类名或类型别名，它们引用了你对TransacFactory接口的实现类。 

public interface TransactionFactory { 

void setProperties(Properties props); 

Transaction newTransaction(Connection conn, boolean autoCommit); 

} 

任何在XML中配置的属性在实例化之后将会被传递给setProperties()方法。你的实现类需要创建一个事务接口的实现，这个接口也很简单： 

public interface Transaction { 

Connection getConnection(); 

void commit() throws SQLException; 

void rollback() throws SQLException; 

void close() throws SQLException; 

} 

使用这两个接口，你可以完全自定义MyBatis对事务的处理。     估计是不重要） 

dataSsource 

dataSource元素使用基本的JDBC数据源接口来配置JDBC连接对象的资源。 

Ø 许多MyBatis的应用程序将会按示例中的例子来配置数据源。然而它并不是必须的。要知道为了方便使用延迟加载，数据源才是必须的。 

有三种内建的数据源类型（也就是type=”???”）： 

1、UNPOOLED – 这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢，这是对简单应用程序的一个很好的选择，因为它不需要及时的可用连接。不同的数据库对这个的表现也是不一样的，所以对某些数据库来说配置数据源并不重要，这个配置也是闲置的。

UNPOOLED类型的数据源仅仅用来配置以下4种属性： 

l driver – 这是JDBC驱动的Java类的完全限定名（如果你的驱动包含，它也不是数据源类）。 

l url – 这是数据库的JDBC URL地址。 

l username – 登录数据库的用户名。 

l password – 登录数据库的密码。 

l defaultTransactionIsolationLevel – 默认的连接事务隔离级别。 

作为可选项，你可以传递数据库驱动的属性。要这样做，属性的前缀是以“driver.”开头的，例如： 

l driver.encoding=UTF8 

这样就会传递以值“UTF8”来传递属性“encoding”，它是通过DriverManager.getConnection(url,driverProperties)方法传递给数据库驱动。 

2、POOLED – 这是JDBC连接对象的数据源连接池的实现，用来避免创建新的连接实例时必要的初始连接和认证时间。这是一种当前Web应用程序用来快速响应请求很流行的方法。 

除了上述（UNPOOLED）的属性之外，还有很多属性可以用来配置POOLED数据源： 

l poolMaximumActiveConnections – 在任意时间存在的活动（也就是正在使用）连接的数量。默认值：10 

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

l poolMaximumCheckoutTime – 在被强制返回之前，池中连接被检查的时间。默认值：20000毫秒（也就是20秒） 

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

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

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

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

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

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

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

和其他数据源配置相似，它也可以通过名为“env.”的前缀直接向初始上下文发送属性。比如： 

l env.encoding=UTF8 

在初始化之后，这就会以值“UTF8”向初始上下文的构造方法传递名为“encoding”的属性。 

3、mappers

既然MyBatis的行为已经由上述元素配置完了，我们现在就要定义SQL映射语句了。但是，首先我们需要告诉MyBatis到哪里去找到这些语句。Java在这方面没有提供一个很好的方法，所以最佳的方式是告诉MyBatis到哪里去找映射文件。映射文件的基本作用就是编写SQL语句，同时给每个SQL语句定义一个唯一的标识（id），在程序中通过此id来调用这条SQL语句。一般一个数据库表定义一个映射文件，便于区分。你可以使用相对于类路径的资源引用，或者字符表示，或url引用的全路径类名（包括file:///URLs）。例如： 

// Using classpath relative resources 

<mappers> 

<mapper resource="cn/com/leadfar/cms/backend/dao/impl/Admin.xml"/> 

<mapper resource="cn/com/leadfar/cms/backend/dao/impl/Article.xml"/> 

<mapper resource="cn/com/leadfar/cms/backend/dao/impl/Channel.xml"/> 

</mappers> 

// Using url fully qualified paths 

<mappers> 

<mapper url="file:///var/sqlmaps/AuthorMapper.xml"/> 

<mapper url="file:///var/sqlmaps/BlogMapper.xml"/> 

<mapper url="file:///var/sqlmaps/PostMapper.xml"/> 

</mappers> 

这些语句简单告诉了MyBatis去哪里找映射文件。其余的细节就是在每个SQL映射文件中了，下面的部分我们来讨论SQL映射文件。