sqlMapConfig.xml配置文件详解

2023-08-25 10:28:16

sqlMapConfig.xml配置文件详解：
Xml代码
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"  
   errorTracingEnabled="true"  
   maxRequests="32"  
   maxSessions="10"  
   maxTransactions="5"  
   useStatementNamespaces="true"/>  
   < transactionManager  type ="JDBC" >   
    < dataSource  type ="SIMPLE" >   
        < property  name ="JDBC.Driver"  value ="com.mysql.jdbc.Driver" />
        < property  name ="JDBC.ConnectionURL"  value ="jdbc:mysql://localhost/test" />
        < property  name ="JDBC.Username"  value ="root" />
        < property  name ="JDBC.Password"  value ="wyq" />
        < property  name ="Pool.MaximumActiveConnections"  value ="10"   />   
        < property  name ="Pool.MaximumIdleConnections"  value ="5" />   
        < property  name ="Pool.MaximumCheckoutTime"  value ="120000" />   
        < property  name ="TimeToWait"  value ="500" />   

    </ dataSource >
  </ transactionManager >
  < sqlMap  resource ="com/wyq/map/userMap.xml" />
</ sqlMapConfig >
    sqlMap节点指定了映射文件的位置，配置文件中可以定义多个sqlMap元素,以指定项目内所包含的所有映射文件.

   <properties>元素的配置，它提供了允许在主配置文件之外的一个“名值对”列表，可以将其中的配置信息加载进来，而这些配置信息可以放在任何一个地方。使用properties元素，其中有两个属性，分别是：resource和url。
    使用resource属性时，类加载器会从类路径开始定位该资源；而使用url属性时，则是用java.net.URL类来处理的，提供一个有效的URL即可。之前的示例中，我们使用了resource属性来配置数据库连接信息，如：

Java代码
<properties resource="jdbc.properties" />
Java代码
<properties resource="jdbc.properties" />
而在jdbc.properties中，我们配置了数据库的驱动属性，连接url，用户名和密码，这样它们就可以被properties元素加载进来，使用起来非常方便。而properties配置文件中是以“名值对”的方式存储的，那么我们使用名称即可引用，这是很多人都熟悉的语法，比如：${driver}就能获取到com.mysql.jdbc.Driver，

一、 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配置

Xml代码
Xml代码
< transctionManager  type ="JDBC" >
     < dataSource  type ="JNDI" >
           < property  name ="DataSource"  value ="java:comp/env/jdbc/myDataSource" />
     </ dataSource >
</ transctionManager >

(2)JTA事务控制的JNDI配置

Xml代码
Xml代码
< 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 >

<!--
maxRequests
同时执行 SQL 语句的最大线程数。大于这个值的线程将阻塞直到另一个线程执行完成。不同的 DBMS有不同的限制值，但任何数据库都有这些限制。通常这个值应该至少是maxTransactions（参见以下）的 10 倍，并且总是大于 maxSessions 和maxTranactions。减小这个参数值通常能提高性能。

例如：maxRequests=“256”
缺省值：512

maxSessions
同一时间内活动的最大 session 数。一个 session 可以maxSessions是代码请求的显式 session，也可以是当线程使用SqlMapClient 实例（即执行一条语句）自动获得的session。它应该总是大于或等于 maxTransactions 并小于 maxRequests。减小这个参数值通常能减少内存使用。

例如：maxSessions=“64”
缺省值：128

maxTransactions
同时进入 SqlMapClient.startTransaction()的最大线程maxTransactions 数。大于这个值的线程将阻塞直到另一个线程退出。不同的 DBMS 有不同的限制值，但任何数据库都有这些限制。这个参数值应该总是小于或等于maxSessions 并总是远远小于 maxRequests。减小这个参数值通常能提高性能。

例如：maxTransactions=“16”
缺省值：32

cacheModelsEnabled
全局性地启用或禁用 SqlMapClient 的所有缓存cacheModelsEnabled model。调试程序时使用。

例如：cacheModelsEnabled=“true”
缺省值：true（启用）

lazyLoadingEnabled
全局性地启用或禁用SqlMapClient的所有延迟加载。lazyLoadingEnabled 调试程序时使用。
例子：lazyLoadingEnabled=“true”
缺省值：true（启用）

enhancementEnabled
全局性地启用或禁用运行时字节码增强，以优化访enhancementEnabled
问Java Bean属性的性能，同时优化延迟加载的性能。

例子：enhancementEnabled=“true”
缺省值：false（禁用）

useStatementNamespaces
如果启用本属性，必须使用全限定名来引用 mapped useStatementNamespaces
statement。Mapped statement 的全限定名由 sql-map 的名称和 mapped-statement 的名称合成。例如： queryForObject("sqlMapName.statementName");

例如：useStatementNamespaces=“false”
缺省值：false（禁用）

defaultStatementTimeout
此设置值必须为一个整数，作为JDBC连接超时的时间，这个值可以被任意一个映射文件的statement属性来重新设置，
如果没有指明，查询将无超时时间限制除非在映射文件中设置statement属性值。被设置的值以秒为单位等待连接失效

classInfoCacheEnabled
With this setting enabled, iBATIS will maintain a cache of introspected
classes. This will lead to a significant reduction in startup time if many
classes are reused.
例如: classInfoCacheEnabled=“true”
缺省值: true (启用)

statementCachingEnabled (iBATIS 2.3.0以后版本中有)
With this setting enabled, iBATIS will maintain a local cache of
prepared statements. This can lead to significant performance
improvements.
例如: statementCachingEnabled=“true”
缺省值: true (启用)
-->

码农公寓

相关文章