Ibatis—sqlMapConfig.xml配置文件詳解

1. <? xml version="1.0" encoding="UTF-8" ?>  
2. <! DOCTYPE sqlMapConfig   
3. PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.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.    < transactionManager  type ="JDBC" >   <!-- 定義了ibatis的事務管理器有3中（JDBC,JTA,EXTERNAL） -->  
16.     < dataSource  type ="SIMPLE" >   <!-- type屬性指定了數據源的鏈接類型，也有3種類型(SIMPLE,DBCP,JNDI) -->  
17.         < property  name ="JDBC.Driver"  value ="com.mysql.jdbc.Driver" />  
18.         < property  name ="JDBC.ConnectionURL"  value ="jdbc:mysql://localhost/test" />  
19.         < property  name ="JDBC.Username"  value ="root" />  
20.         < property  name ="JDBC.Password"  value ="wyq" />  
21.         < property  name ="Pool.MaximumActiveConnections"  value ="10"   />   <!-- 連接池維持的最大容量 -->  
22.         < property  name ="Pool.MaximumIdleConnections"  value ="5" />   <!-- 連接池允許掛起的最大連接 -->  
23.         < property  name ="Pool.MaximumCheckoutTime"  value ="120000" />   <!-- 連接被某個任務所允許佔用的最大時間 -->  
24.         < property  name ="TimeToWait"  value ="500" />   <!-- 線程允許等待的最大時間 -->  
25.        
26.     </ dataSource >  
27.   </ transactionManager >  
28.   < sqlMap  resource ="com/wyq/map/userMap.xml" />  
29. </ 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配置

1. < transctionManager  type ="JDBC" >  
2.      < dataSource  type ="JNDI" >  
3.            < property  name ="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配置

1. < transctionManager  type ="JTA" >  
2.      < property  name ="UserTransaction"  value ="java:/ctx/con/UserTransaction" />  
3.      < dataSource  type ="JNDI" >  
4.            < property  name ="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元素,以指定項目內所包含的所有映射文件.