天天看點

ibatis學習筆記(二)>>>>>>>sqlMapConfig.xml檔案詳解

ibatis基礎代碼包括:

1.    ibatis執行個體配置

一個典型的配置檔案如下(具體配置項目的含義見後):

<? xml version="1.0" encoding="UTF-8"    ?>  

<! DOCTYPE sqlMapConfig 

      PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0/

      "[url]http://www.ibatis.com/dtd/[/url]sql-map-config-2.dt

<sqlMapConfig >  

     < settings 

       cacheModelsEnabled ="true"      

      enhancementEnabled ="true"      

      lazyLoadingEnabled ="true"      

      errorTracingEnabled ="true"      

      maxRequests ="32"           

      maxSessions ="10"           

      maxTransactions ="5"          

      useStatementNamespaces ="false"    

       />  

     < transactionManager    type ="JDBC" >  

     < dataSource    type ="SIMPLE" >  

         < property    name ="JDBC.Driver"    value ="com.p6spy.engine.spy.P6SpyDriver" />  

         < property    name ="JDBC.ConnectionURL"    value ="jdbc:mysql://localhost/sample" />  

         < property    name ="JDBC.Username"    value ="user" />  

         < property    name ="JDBC.Password"    value ="mypass" />  

         < property    name ="Pool.MaximumActiveConnections"    value ="10" />  

         < property    name ="Pool.MaximumIdleConnections"    value ="5" />  

         < property    name ="Pool.MaximumCheckoutTime"    value ="120000" />  

         < property    name ="Pool.TimeToWait"    value ="500" />  

         < property    name ="Pool.PingQuery"    value ="select 1 from ACCOUNT" />  

         < property    name ="Pool.PingEnabled"    value ="false" />  

         < property    name ="Pool.PingConnectionsOlderThan"    value ="1" />  

         < property    name ="Pool.PingConnectionsNotUsedFor"    value ="1" />  

       </ dataSource >  

     </ transactionManager >  

     < sqlMap    resource ="com/ibatis/sample/User.xml" />  

</ sqlMapConfig >

⑴ Settings節點

cacheModelsEnabled 

是否啟用SqlMapClient上的緩存機制。建議設為"true"

enhancementEnabled 

是否針對POJO啟用位元組碼增強機getter/setter的調用效能,避免Reflect所帶來的性能開銷。同時,這也為Lazy Loading帶來提升。建議設為"true"

errorTracingEnabled

是否啟用錯誤日志,在開發期間建議設為"true"以友善調試

lazyLoadingEnabled

是否啟用延遲加載機制,建議設為"true"

maxRequests

最大并發請求數(Statement并發數)

maxTransactions 

最大并發事務數

maxSessions    最大Session數。即目前最大允許的并發SqlMapClient數。

useStatementNamespaces 

是否使用Statement命名空間。

這裡的命名空間指的是映射檔案中,sqlMap節的namespace屬性,如在上例中針對t_use

表的映射檔案sqlMap節點: <sqlMap namespace="User">這裡,指定了此sqlMap節點下定義的操作均屬于"User"命名空間。在useStatementNamespaces="true"的情況下,Statement調用需追加命名空間,如:sqlMap.update("User.updateUser",user);

否則直接通過Statement名稱調用即可,如: sqlMap.update("updateUser",user);但請注意此時需要保證所有映射檔案中,Statement定義無重名。

transactionManager節點

transactionManager節點定義了ibatis的事務管理器,目前提供了以下幾種選擇:

JDBC

通過傳統JDBC Connection.commit/rollback實作事務支援。 

JTA

使用容器提供的JTA服務實作全局事務管理。

EXTERNAL

外部事務管理,如在EJB中使用ibatis,通過EJB的部署配置即可實作自

動的事務管理機制。此時ibatis将把所有事務委托給外部容器進行管理。

dataSource節點

    dataSource從屬于transactionManager節點,用于設定ibatis運作期使用的DataSource屬性。

type屬性:

dataSource節點的type屬性指定了dataSource的實作類型。可選項目:

SIMPLE:

    SIMPLE是ibatis内置的dataSource實作,其中實作了一個簡單的

資料庫連接配接池機制,對應 ibatis實作類為

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

DBCP:

    基于Apache DBCP連接配接池元件實作的DataSource封裝,當無容器提

供DataSource服務時,建議使用該選項,對應ibatis實作類為

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

JNDI:

使用J2EE容器提供的DataSource實作,DataSource将通過指定

的JNDI Name從容器中擷取。對應 ibatis實作類為

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

dataSource的子節點說明(SIMPLE&DBCP):

JDBC.Driver    JDBC 驅動。

如:org.gjt.mm.mysql.Driver.JDBC.ConnectionURL 

資料庫URL。

如:jdbc:mysql://localhost/sample

如果用的是SQLServer JDBC Driver,需要在url後追加SelectMethod=Cursor以獲得JDBC事務的多Statement支援。

JDBC.Username

    資料庫使用者名

JDBC.Password 

資料庫使用者密碼

Pool.MaximumActiveConnections

資料庫連接配接池可維持的最大容量。

Pool.MaximumIdleConnections

資料庫連接配接池中允許的挂起(idle)連接配接數。

JNDI由于大部配置設定置是在應用伺服器中進行,是以ibatis中的配置相對簡單

分别使用JDBC和JTA事務管理的JDNI配置:

使用JDBC事務管理的JNDI DataSource配置

< transactionManager    type ="JDBC"     >  

< dataSource    type ="JNDI" >  

< property    name ="DataSource"     value ="java:comp/env/jdbc/myDataSource" />  

</ dataSource >  

</ transactionManager >  

< transactionManager    type ="JTA"     >  

< property    name ="UserTransaction"     value ="java:/ctx/con/UserTransaction" />  

< dataSource    type ="JNDI" >  

< property    name ="DataSource"     value ="java:comp/env/jdbc/myDataSource" />  

</ dataSource >

sqlMap節點

sqlMap節點指定了映射檔案的位置,配置中可出現多個sqlMap節點,以指定

項目内所包含的所有映射檔案。

ibatis基礎語義

XmlSqlMapClientBuilder

XmlSqlMapClientBuilder是ibatis 2.0之後版本新引入的元件,用以替代1.x

版本中的XmlSqlMapBuilder。其作用是根據配置檔案建立SqlMapClient執行個體。

SqlMapClient

SqlMapClient是ibatis的核心元件,提供資料操作的基礎平台。SqlMapClient

可通過XmlSqlMapClientBuilder建立:

String resource    = " com/ibatis/sample/SqlMapConfig.xml " ; 

Reader reader; 

reader    =    Resources.getResourceAsReader(resource); 

XmlSqlMapClientBuilder xmlBuilder    =   

new    XmlSqlMapClientBuilder(); 

SqlMapClient sqlMap    =    xmlBuilder.buildSqlMap(reader);

"com/ibatis/sample/SqlMapConfig.xml"指明了配置檔案在CLASSPATH

中的相對路徑。XmlSqlMapClientBuilder通過接受一個Reader類型的配置文

件句柄,根據配置參數,建立SqlMapClient執行個體。

SqlMapClient提供了衆多資料操作方法,下面是一些常用方法的示例,具體說明

文檔請參見ibatis java doc,或者ibatis官方開發手冊。

SqlMapClient基本操作示例

以下示例摘自ibatis官方開發手冊,筆者對其進行了重新排版以獲得更好的閱讀效果。

例1:資料寫入操作(insert, update, delete):

sqlMap.startTransaction(); 

Product product    =     new    Product(); 

product.setId ( 1 ); 

product.setDescription (“Shih Tzu”); 

int    rows    =    sqlMap.insert (“insertProduct”, product); 

sqlMap.commitTransaction(); 

例2:資料查詢 (select)

sqlMap.startTransaction(); 

Integer key    =     new    Integer ( 1 ); 

Product product    =    (Product)sqlMap.queryForObject (“getProduct”, key); 

sqlMap.commitTransaction(); 

例3:在指定對象中存放查詢結果(select)

sqlMap.startTransaction(); 

Customer customer    =     new    Customer(); 

sqlMap.queryForObject(“getCust”, parameterObject, customer); 

sqlMap.queryForObject(“getAddr”, parameterObject, customer); 

sqlMap.commitTransaction();

例4:執行批量查詢 (select)

sqlMap.startTransaction(); 

List list    =    sqlMap.queryForList (“getProductList”,    null )

sqlMap.commitTransaction();

例5:關于AutoCommit

// 沒有預先執行startTransaction時,預設為auto_commit模式  

int    rows    =    sqlMap.insert (“insertProduct”, product); 

例6:查詢指定範圍内的資料

sqlMap.startTransaction(); 

List list    =    sqlMap.queryForList (“getProductList”,    null ,    0 ,    40 ); 

sqlMap.commitTransaction();

例7:結合RowHandler進行查詢(select)

    public     class    MyRowHandler    implements    RowHandler     { 

      public     void    handleRow (Object object, List list)    throws  

      SQLException     { 

        Product product    =    (Product) object; 

        product.setQuantity ( 10000 ); 

        sqlMap.update (“updateProduct”, product); 

      }  

}  

sqlMap.startTransaction(); 

RowHandler rowHandler    =     new    MyRowHandler(); 

List list    =    sqlMap.queryForList (“getProductList”,    null , 

rowHandler); 

sqlMap.commitTransaction(); 

// 例8:分頁查詢 (select)

PaginatedList list    =  

sqlMap.queryForPaginatedList (“getProductList”,    null ,    10 ); 

list.nextPage(); 

list.previousPage();

// 例9:基于Map的批量查詢 (select) 

sqlMap.startTransaction(); 

Map map    =    sqlMap.queryForMap (“getProductList”,    null , “productCode”); 

sqlMap.commitTransaction(); 

Product p    =    (Product) map.get(“EST - 93 ”); 

轉載于:https://blog.51cto.com/huangteng/1411795