【Ibatis】（一）、sqlMapConfig.xml配置文件详解

1.sqlMapConfig.xml配置文件详解：

Xml代码

1. <?xmlversion="1.0"encoding="UTF-8"?>
2. <!DOCTYPEsqlMapConfig
3. PUBLIC"-//iBATIS.com//DTDSQLMapConfig2.0//EN"
4. "http://www.ibatis.com/dtd/sql-map-config-2.dtd">
5. <sqlMapConfig>
6. <settings
7. cacheModelsEnabled="true"<!--是否启用缓存机制-->
8. lazyLoadingEnabled="true"<!--是否启用延迟加载机制-->
9. enhancementEnabled="true"<!--是否启用字节码增强机制-->
10. errorTracingEnabled="true"<!--是否启用错误处理机制-->
11. maxRequests="32"<!--最大并发请求数-->
12. maxSessions="10"<!--最大Session数-->
13. maxTransactions="5"<!--最大并发事务数-->
14. useStatementNamespaces="true"/><!--是否启用名称空间-->
15. <transactionManagertype="JDBC"><!--定义了ibatis的事务管理器有3中（JDBC,JTA,EXTERNAL）-->
16. <dataSourcetype="SIMPLE"><!--type属性指定了数据源的链接类型，也有3种类型(SIMPLE,DBCP,JNDI)-->
17. <propertyname="JDBC.Driver"value="com.mysql.jdbc.Driver"/>
18. <propertyname="JDBC.ConnectionURL"value="jdbc:mysql://localhost/test"/>
19. <propertyname="JDBC.Username"value="root"/>
20. <propertyname="JDBC.Password"value="wyq"/>
21. <propertyname="Pool.MaximumActiveConnections"value="10"/><!--连接池维持的最大容量-->
22. <propertyname="Pool.MaximumIdleConnections"value="5"/><!--连接池允许挂起的最大连接-->
23. <propertyname="Pool.MaximumCheckoutTime"value="120000"/><!--连接被某个任务所允许占用的最大时间-->
24. <propertyname="TimeToWait"value="500"/><!--线程允许等待的最大时间-->
26. </dataSource>
27. </transactionManager>
28. <sqlMapresource="com/wyq/map/userMap.xml"/>
29. </sqlMapConfig>

<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE sqlMapConfig
PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
"http://www.ibatis.com/dtd/sql-map-config-2.dtd" >
< sqlMapConfig >
   < settings 
    cacheModelsEnabled ="true"  <!--是否启用缓存机制-- >
   lazyLoadingEnabled="true"  <!-- 是否启用延迟加载机制 -->
   enhancementEnabled="true"  <!-- 是否启用字节码增强机制 -->
   errorTracingEnabled="true"  <!-- 是否启用错误处理机制 -->
   maxRequests="32"  <!-- 最大并发请求数 -->
   maxSessions="10"  <!-- 最大Session数 -->
   maxTransactions="5"  <!-- 最大并发事务数 -->
   useStatementNamespaces="true"/>  <!-- 是否启用名称空间 -->
   < transactionManager  type ="JDBC" >   <!-- 定义了ibatis的事务管理器有3中（JDBC,JTA,EXTERNAL） -->
    < dataSource  type ="SIMPLE" >   <!-- type属性指定了数据源的链接类型，也有3种类型(SIMPLE,DBCP,JNDI) -->
        < property  name ="JDBC.Driver"  value ="com.mysql.jdbc.Driver" />
        < property  name ="JDBC.ConnectionURL"  value ="jdbc:mysql://localhost/test" />
        < property  name ="JDBC.Username"  value ="root" />
        < property  name ="JDBC.Password"  value ="wyq" />
        < property  name ="Pool.MaximumActiveConnections"  value ="10"   />   <!-- 连接池维持的最大容量 -->
        < property  name ="Pool.MaximumIdleConnections"  value ="5" />   <!-- 连接池允许挂起的最大连接 -->
        < property  name ="Pool.MaximumCheckoutTime"  value ="120000" />   <!-- 连接被某个任务所允许占用的最大时间 -->
        < property  name ="TimeToWait"  value ="500" />   <!-- 线程允许等待的最大时间 -->
    
    </ dataSource >
  </ transactionManager >
  < sqlMap  resource ="com/wyq/map/userMap.xml" />
</ sqlMapConfig >

一 transactionManager节点

transactionManagerab 定义了ibatis的事务管理器,目前提供了以下几种选择:

1) JDBC
通过传统JDBC Connection.commit/rollback实现事务支持.
2) JTA
使用容器提供的JTA服务实现全局事务管理.
3) EXTERNAL
外部事务管理,如在EJB中使用ibatis,通过EJB的部署配置即可实现自动的事务管理机制.此时ibatis将把所有事务委托给外部容器进行管理.此外,通过Spring等轻量级容量实现事务的配置化管理也是一个不错的选择.

二 dataSource 节点

dataSource 从属于 transactionManager, 用于设定ibatis运行期使用DataSource属性.

type 属性: dataSource 元素的 type 属性指定了 dataSource 的实现类型.可选项目:

1) SIMPLE:

SIMPLE 是 ibatis 内置的 dataSource 实现,其中实现了一个简单的数据库连接池机制,对应 ibatis 实现类为

com.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory.

JDBC 使用 数据库自己的事务（局部事务），connect.beginTranstion(), connect.commit()等.

2) DBCP

基于Apache DBCP连接池组件实现的DataSource封装,当无容器提供DataSource服务时,建议使用该选项,对应ibatis实现类为

com.ibatis.sqlmap.engine.datasource.DbcpDataSourceFactory.

JTA ： 使用jta 事务管理器管理事务（全局事务），使用userTranstion对象.

3) JNDI

使用J2EE容器提供的DataSource实现, DataSource将通过指定的JNDI Name从容器中获取.对应ibatis实现类为

com.ibatis.sqlmap.engine.datasource.JndiDataSourceFactory.

Ibatis 不控制事务，事务交由外部控制，一般在CTM,或spring托管事务中使用.

JNDI的配置大部分都在应用服务器中进行，所以在ibatis中的配置相对简单
(1)jdbc事务控制的JNDI配置

Xml代码

1. <transctionManagertype="JDBC">
2. <dataSourcetype="JNDI">
3. <propertyname="DataSource"value="java:comp/env/jdbc/myDataSource"/>
4. </dataSource>
5. </transctionManager>

< transctionManager  type ="JDBC" >
     < dataSource  type ="JNDI" >
           < property  name ="DataSource"  value ="java:comp/env/jdbc/myDataSource" />
     </ dataSource >
</ transctionManager >

(2)JTA事务控制的JNDI配置

Xml代码

1. <transctionManagertype="JTA">
2. <propertyname="UserTransaction"value="java:/ctx/con/UserTransaction"/>
3. <dataSourcetype="JNDI">
4. <propertyname="DataSource"value="java:comp/env/jdbc/myDataSource"/>
5. </dataSource>
6. </transctionManager>

< transctionManager  type ="JTA" >
     < property  name ="UserTransaction"  value ="java:/ctx/con/UserTransaction" />
     < dataSource  type ="JNDI" >
           < property  name ="DataSource"  value ="java:comp/env/jdbc/myDataSource" />
      </ dataSource >
</ transctionManager >

sqmMap节点指定了映射文件的位置， 配置文件中可以定义多个sqlMap元素,以指定项目内所包含的所有映射文件.