Ibatis学习二. SqlMapConfig.xml文件详细说明

<?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" 

     enhancementEnabled="true"  

     lazyLoadingEnabled="true" 

     errorTracingEnabled="true"  

     errorTracingEnabled="true" 

     maxRequests="32" 

     maxSessions="10" 

     maxTransactions="5"  /> 

    <!-- 是否启用SqlMapClient 上的缓存机制。建议设为"true"  -->

    <!-- 是否针对POJO启用字节码增强机制以提升getter/setter的调用效能，避免使用Java Reflect-->
    <!-- 所带来的性能开销。同时，这也为Lazy Loading带来了极大的性能提升。建议设为"true" -->

    <!-- 是否启用延迟加载机制，建议设为"true" -->

    <!-- 是否启用错误日志，在开发期间建议设为"true"以方便调试 -->

    <!-- 最大并发请求数（Statement 并发数） -->

    <!-- 最大Session 数。即当前最大允许的并发SqlMapClient 数。 -->

    <!-- maxSessions设定必须介于maxTransactions和maxRequests之间，即maxTransactions<maxSessions=<maxRequests -->

    <!-- 最大并发事务数 -->

    <!-- 是否使用Statement命名空间。这里的命名空间指的是映射文件中，sqlMap节点的namespace属性，-->

    <!-- 如在上例中针对t_user表的映射文件sqlMap节点：<sqlMap namespace="User"> -->

    <!-- 这里，指定了此sqlMap节点下定义的操作均从属于"User"命名空间。在useStatementNamespaces="true"-->

    <!-- 的情况下，Statement调用需追加命名空间，如：sqlMap.update("User.updateUser",user);-->

    <!-- 否则直接通过Statement名称调用即可，如：sqlMap.update("updateUser",user);-->

    <!-- 但请注意此时需要保证所有映射文件中，Statement定义无重名。  -->

    <transactionManager type="JDBC">     
    <!-- 定义了ibatis 的事务管理器 type 有三种：JDBC . JTA . EXTERNAL. -->

<!--SIMPLE 的配置用法-->

    <dataSource type="SIMPLE">        
   <!--dataSource的实现类型 

SIMPLE：简单的数据库联接池实现 实现类为 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。

-->

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

    <!-- JDBC 驱动。(SIMPLE,DBCP)  -->

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

    <!-- 数据库URL。(SIMPLE,DBCP) -->

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

    <!-- 数据库用户名(SIMPLE,DBCP) -->

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

    <!-- 数据库密码 (SIMPLE,DBCP)-->

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

    <!-- 数据库连接池可维持的最大容量。(SIMPLE,DBCP) -->

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

    <!-- 数据库连接池中允许的挂起（idle）连接数。(SIMPLE,DBCP) -->

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

    <!-- 数据库联接池中，连接被某个任务所允许占用的最大时间，如果超过这个时间限定，连接将被强制收回。（毫秒）(SIMPLE) -->

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

    <!-- 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用， 许等待的最长时间。（毫秒）(SIMPLE) -->

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

<!-- 数据库连接状态检测语句。某些数据库在连接在某段时间持续处于空闲状态 时会将其断开。而连接池管理器将通过此语句检测池中连接是否可用。

检测语句应该是一个最简化的无逻辑SQL。 如“select 1 from t_user”，如果执行此语句成功， 连接池管理器将认为此连接处于可用状态。(SIMPLE) 

-->

    <property name="Pool.PingEnabled" value="false"/>         
    <!-- 是否允许检测连接状态。(SIMPLE) -->

    <property name="Pool.PingConnectionsOlderThan"value="1"/>           
    <!-- 对持续连接时间超过设定值（毫秒）的连接进行检测 (SIMPLE)-->

    <property name="Pool.PingConnectionsNotUsedFor"value="1"/>   
    <!-- 对空闲超过设定值（毫秒）的连接进行检测。(SIMPLE) -->

</dataSource>

<!--DBCP 的配置用法-->

    <dataSource type="SIMPLE">        

    <property name="JDBC.Driver" value="com.p6spy.engine.spy.P6SpyDriver"/>    
    <!-- JDBC 驱动。(SIMPLE,DBCP)  -->

    <property name="JDBC.ConnectionURL" value="jdbc:mysql://localhost/sample"/>         
    <!-- 数据库URL。(SIMPLE,DBCP) -->

    <property name="JDBC.Username" value="user"/>        
    <!-- 数据库用户名(SIMPLE,DBCP) -->

    <property name="JDBC.Password" value="mypass"/>      
    <!-- 数据库密码 (SIMPLE,DBCP)-->

    <property name="Pool.MaximumActiveConnections"value="10"/>          
    <!-- 数据库连接池可维持的最大容量。(SIMPLE,DBCP) -->

    <property name="Pool.MaximumIdleConnections" value="5"/>              
    <!-- 数据库连接池中允许的挂起（idle）连接数。(SIMPLE,DBCP) -->

    <property name="Pool.MaximumWait" value="1000"/>     
    <!-- 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，此时线程将进入等待状态，
    直到池中出现空闲连接。此参数设定了线程所允许等待的最长时间。（毫秒） -->

    <property naem="Pool.ValidationQuery" value="select 1 fromACCOUNT"/>     
    <!-- 数据库连接状态检测语句。-->   

    <property name="Pool.LogAbandoned" value="false"/>
    <!-- 当数据库连接被废弃时，是否打印日志 -->   

    <property name="Pool.RemoveAbandonedTimeout" value="1000"/>
    <!-- 数据库连接被废弃的最大超时时间 -->     

    <property name="Pool.RemoveAbandoned" value="true"/> 
    <!-- 当连接空闲时间超过RemoveAbandonedTimeout时，是否将其废弃。-->

</dataSource>

<!--JNDI 的配置用法-->

    <dataSource type="JNDI">        

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

    </dataSource>

    <!-- 使用容器提供的JTA服务实现全局事务管理的设置-->

    <!-- 

    <transactionManager type="JTA" >

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

    <dataSource type="JNDI">

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

    </dataSource>

    </transactionManager>

    -->

    </transactionManager>

    <!-- sqlMap 节点指定了映射文件的位置，配置中可出现多个sqlMap 节点，以指定项目内所包含的所有映射文件。 -->

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


</sqlMapConfig>

 

 示例：

    <?xml version="1.0" encoding="UTF-8" ?>    
    <!DOCTYPE sqlMapConfig          
        PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"          
        "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">    
    <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="oracle.jdbc.driver.OracleDriver"/>    
          <property name="JDBC.ConnectionURL" value="jdbc:oracle:thin:@..."/>    
          <property name="JDBC.Username" value="..."/>    
          <property name="JDBC.Password" value="..."/>    
           <property name="JDBC.DefaultAutoCommit" value="true"/>    
            <!-- 数据库连接池可维持的最大容量。缺省值: 10 -->    
          <property name="Pool.MaximumActiveConnections" value="10"/>    
            <!-- 数据库连接池中允许的挂起（idle）连接数。缺省值: 5 -->    
          <property name="Pool.MaximumIdleConnections" value="5"/>    
              <!--       
                数据库联接池中，连接被某个任务所允许占用的最大时间，      
                如果超过这个时间限定，连接将被强制收回（单位：毫秒）。      
                缺省值: 20000       
            -->      
          <property name="Pool.MaximumCheckoutTime" value="180000"/>    
            <!--       
                当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，      
                此时线程将进入等待状态，直到池中出现空闲连接。      
                此参数设定了线程所允许等待的最长时间（单位：毫秒）缺省值: 10       
            -->    
          <property name="Pool.TimeToWait" value="10000"/>    
            <!--      
                数据库连接状态检测语句。      
                某些数据库在连接在某段时间持续处于空闲状态时会将其断开。      
                而连接池管理器将通过此语句检测池中连接是否可用。      
                它对性能的影响较大，应小心使用。检测语句应该是一个最简化的无逻辑SQL，      
                如：select 1 from dual缺省值: N/A      
            -->           
          <property name="Pool.PingQuery" value="select 1 from dual"/>    
              <!-- 是否允许检测连接状态。缺省值: false -->      
          <property name="Pool.PingEnabled" value="true"/>    
              <!-- 对持续连接时间超过设定值（毫秒）的连接进行检测。缺省值: 0  不检查-->      
          <property name="Pool.PingConnectionsOlderThan" value="0"/>    
              <!-- 对空闲超过设定值（毫秒）的连接进行检测。缺省值: 0  不检查-->    
          <property name="Pool.PingConnectionsNotUsedFor" value="3600000"/>    
          <property name="Pool.QuietMode" value="true"/>    
        </dataSource>      
        
         <!--<dataSource type="JNDI">    
            <property name="DataSource" value="WXPTDataSource"/>       
          </dataSource>-->    
        
      </transactionManager>    
           <!-- frame -->    
           <sqlMap resource=".../login.xml"/>    
           ......          
    </sqlMapConfig>