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>