Ibatis学习总结2--SQL Map XML 配置文件

<transationManager>元素让您为 SQL Map 配置事务管理服务。属性 type 指定所使用的 事务管理器类型。这个属性值可以是一个类名，也可以是一个别名。包含在框架的三个事务 管理器分别是：JDBC，JTA 和 EXTERNAL。

¤ JDBC：通过常用的 Connection commit()和 rollback()方法，让 JDBC 管理事务。

¤ JTA：本事务管理器使用一个 JTA 全局事务，使 SQL Map 的事务包括在更大的事 务范围内，这个更大的事务范围可能包括了其他的数据库和事务资源。这个配置需 要一个 UserTransaction 属性，以便从 JNDI 获得一个 UserTransaction。

¤ EXTERNAL：这个配置可以让您自己管理事务。您仍然可以配置一个数据源，但 事务不再作为框架生命周期的一部分被提交或回退。这意味着 SQL Map 外部应用 的一部分必须自己管理事务。这个配置也可以用于没有事务管理的数据库（例如只读数据库）。

• <datasource>元素

  <datasource>是<transactionManager>的一部分，为 SQL Map 数据源设置了一系列参数。 目前 SQL Map 架构只提供三个 DataSource Factory，但您也可以添加自己的实现。下面详细 地讨论 DataSourceFactory 的三个实现及其例子。

  SimpleDataSourceFactory

  SimpleDataSourceFactory 为 DataSource 提供了一个基本的实现，适用于在没有 J2EE 容 器提供 DataSource 的情况。它基于 iBatis 的 SimpleDataSource 连接池实现。

   1 <transactionManager type="JDBC">
   2 <dataSource type="SIMPLE">
   3 <property name="JDBC.Driver" value="org.postgresql.Driver"/>
   4 <property name="JDBC.ConnectionURL" value="jdbc:postgresql://server:5432/dbname"/>
   5 <property name="JDBC.Username" value="user"/>
   6 <property name="JDBC.Password" value="password"/>
   7 <!-- OPTIONAL PROPERTIES BELOW -->
   8 <property name="Pool.MaximumActiveConnections" value="10"/>
   9 <property name="Pool.MaximumIdleConnections" value="5"/>
  10 <property name="Pool.MaximumCheckoutTime" value="120000"/>
  11 <property name="Pool.TimeToWait" value="10000"/>
  12 <property name="Pool.PingQuery" value="select * from dual"/>
  13 <property name="Pool.PingEnabled" value="false"/>
  14 <property name="Pool.PingConnectionsOlderThan" value="0"/>
  15 <property name="Pool.PingConnectionsNotUsedFor" value="0"/>
  16 </dataSource>
  17 </transactionManager>

  DbcpDataSourceFactory

  DbcpDataSourceFactory 实现使用 Jakarta DBCP（Database Connection Pool）的 DataSource API 提供连接池服务。适用于应用/Web 容器不提供 DataSource 服务的情况，或执行一个单 独的应用。DbcpDataSourceFactory 中必须要配置的参数例子如下：

   1 <transactionManager type="JDBC">
   2 <dataSource type="DBCP">
   3 <property name="JDBC.Driver" value="${driver}"/>
   4 <property name="JDBC.ConnectionURL" value="${url}"/>
   5 <property name="JDBC.Username" value="${username}"/>
   6 <property name="JDBC.Password" value="${password}"/>
   7 <!-- OPTIONAL PROPERTIES BELOW -->
   8 <property name="Pool.MaximumActiveConnections" value="10"/>
   9 <property name="Pool.MaximumIdleConnections" value="5"/>
  10 <property name="Pool.MaximumWait" value="60000"/>
  11 <!-- Use of the validation query can be problematic. If you have difficulty, try without it. -->
  12 <property name="Pool.ValidationQuery" value="select * from ACCOUNT"/>
  13 <property name="Pool.LogAbandoned" value="false"/>
  14 <property name="Pool.RemoveAbandoned" value="false"/>
  15 <property name="Pool.RemoveAbandonedTimeout" value="50000"/>
  16 </datasource>
  17 </transactionManager>

  JndiDataSourceFactory

  JndiDataSourceFactory 在应用容器内部从 JNDI Context 中查找 DataSource 实现。当使用 应用服务器，并且服务器提供了容器管理的连接池和相关 DataSource 实现的情况下，可以 使用 JndiDataSourceFactory。使用 JDBC  DataSource  的标准方法是通过 JNDI  来查找。 JndiDataSourceFactory 必须要配置的属性如下：

  1 <transactionManager type="JDBC" >
  2 <dataSource type="JNDI">
  3 <property name="DataSource" value="java:comp/env/jdbc/jpetstore"/>
  4 </dataSource>
  5 </transactionManager>

  以上配置使用了常用的 JDBC 事务管理。但对于容器管理的资源，您可能需要象下面的 例子一样配置，让它能和全局事务一起工作：

  1 <transactionManager type="JTA" >
  2 <property name="UserTransaction" value="java:/ctx/con/UserTransaction"/>
  3 <dataSource type="JNDI">
  4 <property name="DataSource" value="java:comp/env/jdbc/jpetstore"/>
  5 </dataSource>
  6 </transactionManager>

  注意，UserTransaction 属性指向 UserTransaction 实例所在的 JNDI 位置。JTA 事务管理 需要它，以使 SQL Map 能够参与涉及其他数据库和事务资源的范围更大的事务。

• <sqlMap>元素

  <sqlMap> 元素用于包括 SQL  Map  映射文件和其他的 SQL  Map  配置文件。每个 SqlMapClient  对象使用的所有 SQL  Map  映射文件都要在此声明。映射文件作为 stream resource 从类路径或 URL 读入。您必须在这里指定所有的 SQL Map 文件。例子如下：

  1 <!-- CLASSPATH RESOURCES -->
  2 <sqlMap resource="com/ibatis/examples/sql/Customer.xml" />
  3 <sqlMap resource="com/ibatis/examples/sql/Account.xml" />
  4 <sqlMap resource="com/ibatis/examples/sql/Product.xml" />
  5 <!-- URL RESOURCES -->
  6 <sqlMap url="file:///c:/config/Customer.xml " />
  7 <sqlMap url="file:///c:/config/Account.xml " />
  8 <sqlMap url="file:///c:/config/Product.xml" />

  后面将总结SQL Map XML 映射文件的结构。