ibatis学习二入门之配置文件

       继续学习ibatis，还是代码+注释+说明的简单方式。

        ibatis的SqlMapConfig.xml文件的配置

<?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>  
    
    <!-- cacheModelsEnabled: 是否启用SqlMapClient上的缓存机制。 建议设为"true" -->
    <!-- enhancementEnabled: 是否针对POJO启用字节码增强机制以提升getter/setter的调用效能，避免Reflect所带来的性能开销。同时，这也为Lazy Loading带来提升。 建议设为"true"  -->
    <!-- lazyLoadingEnabled: 是否使用延迟加载机制，建议设置true -->
    <!-- errorTracingEnabled: 是否启用错误日志，在开发时设置为"true"可方便调试 -->
    <!-- maxRequests: 最大并发请求数（Statement并发数） -->
    <!-- maxSessions: 最大Session数。即当前最大允许的并发SqlMapClient数  -->
    <!-- maxTransactions: 最大并发事物数，应满足  maxTransactions < maxSessions < maxRequests -->
    <!-- useStatementNamespaces: 是否使用Statement命名空间。 这里的命名空间指的是映射文件中，sqlMap节的namespace属性，如在上例中针对user表的映射文件sqlMap节点： <sqlMap namespace="User"> 
                              这里指定了此sqlMap节点下定义的操作均属于"User"命名空间。 在useStatementNamespaces="true"的情况下，Statement调用需追加命名空间，如：sqlMap.update("User.findUserById", 1); 
                            否则直接通过Statement名称调用即可，如： sqlMap.update("findUserById",1); 但请注意此时需要保证所有映射文件中，Statement定义无重名。 -->
    <settings
        cacheModelsEnabled="true"  
        enhancementEnabled="true"
        lazyLoadingEnabled="true"
        errorTracingEnabled="true"
        maxRequests="30"
        maxSessions="10"
        maxTransactions="5"
        useStatementNamespaces="false"
    />
    
    <!-- transactionManager 节点定义了ibatis 的事务管理器，目前提供了以下几种选择：JDBC、JTA、EXTERNAL -->
    <!-- JDBC: 通过传统JDBC Connection.commit/rollback实现事务支持 -->
    <!-- JTA: 使用容器提供的JTA服务实现全局事务管理 -->
    <!-- EXTERNAL: 外部事务管理，如在EJB中使用ibatis，通过EJB的部署配置即可实现自动的事务管理机制。此时ibatis 将把所有事务委托给外部容器进行管理。
                               此外，通过Spring 等轻量级容器实现事务的配置化管理也是一个不错的选择 -->
    <properties resource="jdbc.properties" />
    <transactionManager type="JDBC">
        <!-- type: dataSouce的实现类型。可选值： SIMPLE、DBCP、JNDI -->
        <!-- 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 type="SIMPLE">  
            <property name="JDBC.Driver" value="${jdbc.driverClassName}" />
            <property name="JDBC.ConnectionURL" value="${jdbc.url}" />
            <property name="JDBC.Username" value="${jdbc.username}" />  
            <property name="JDBC.Password" value="${jdbc.password}" />  
            

            <!-- 数据库连接池可维持的最大容量 -->
            <property name="Pool.MaximumActiveConnections" value="10"/>
            <!-- 数据库连接池中允许的挂起（idle）连接数 -->
            <property name="Pool.MaximumIdelConnections" value="5"/>
            <!-- 数据库联接池中，连接被某个任务所允许占用的最大时间，如果超过这个时间限定，连接将被强制收回。（毫秒） -->
            <property name="Pool.MaximumCheckoutTime" value="12000"/>
            <!-- 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，此时线程将进入等待状态，直到池中出现空闲连接。此参数设定了线程所允许等待的最长时间。（毫秒） -->
            <property name="Pool.TimeToWait" value="600"/>
            <!-- 数据库连接状态检测语句。某些数据库在连接在某段时间持续处于空闲状态时会将其断开。而连接池管理器将通过此语句检测池中连接是否可用。
                                                           检测语句应该是一个最简化的无逻辑SQL。如“select 1 from t_user”，如果执行此语句成功，连接池管理器将认为此连接处于可用状态 -->
            <property name="Pool.PingQuery" value="select 1 from USER"/>
            <!-- 是否允许检测连接状态 -->
            <property name="Pool.PingEnabled" value="true"/>
            <!-- 对持续连接时间超过设定值（毫秒）的连接进行检测 -->
            <property name="Pool.PingConnectionsOlderThan" value="1"/>
            <!-- 对空闲超过设定值（毫秒）的连接进行检测 -->
            <property name="Pool.PingConnectionsNotUsedFor" value="1"/>
        </dataSource>
    </transactionManager>
    
    <!-- sqlMap 节点指定了映射文件的位置，配置中可出现多个sqlMap 节点，以指定项目内所包含的所有映射文件 -->
    <sqlMap resource="com/si/sqlMap/User.xml" />  
</sqlMapConfig>  

       上面的dataSource为type=“SIMPLE”时的配置。type为DBCP时

<!-- 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，此时线程将进入等待状态，直到池中出现空闲连接。此参数设定了线程所允许等待的最长时间。（毫秒） -->
            <property name="Pool.MaximumWait" value="5000"/>
            <!-- 数据库连接状态检测语句 -->
            <property name="Pool.ValidationQuery" value="10"/>
            <!-- 当数据库连接被废弃时，是否打印日志 -->
            <property name="Pool.LogAbandoned" value="10"/>
            <!-- 数据库连接被废弃的最大超时时间 -->
            <property name="Pool.RemoveAbandonedTimeout" value="10"/>
            <!-- 当连接空闲时间超过RemoveAbandonedTimeout时，是否将其废弃 -->
            <property name="Pool.RemoveAbandoned" value="10"/>

      type为JNDI时

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