ibatis框架中sqlMapConfig.xml详解

ibatis 专栏收录该内容
5 篇文章 0 订阅
[align=center][size=x-large][b][color=red]ibatis框架中sqlMapConfig.xml详解[/color][/b][/size][/align]

[url]http://zhaohe162.blog.163.com/blog/static/382167972010817343888/?suggestedreading&wumii[/url]
[url]http://jun1986.iteye.com/blog/1225238[/url]
[url]http://blog.sina.com.cn/s/blog_74fa15e10100qaf5.html[/url]

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

<!-- ibatis配置文件 -->
<sqlMapConfig>
<!-- 加载连接数据库属性文件 -->
<properties resource="org/ibatis/config/SqlMapConfig.properties"/>

<!--
cacheModelsEnabled: 是否启动SqlMapConfig的缓存机制
enhancementEnabled: 是否针对POJO启用字节码增加机制以提升geter/seter的调用效用,为延迟加载带来了及大的性能提升
lazyLoadingEnabled: 是否启动延迟加载机制
errorTracingEnabled: 是否启用错误日志,在开发期间建议设为"true" 以方便调试
maxRequests: 最大并发请求数(Statement并发数)
maxSession: 最大Session数,即当前最大允许的开发SqlMapClient数
maxTransactions: 最大并发事务数
useStatementNamespaces: 是否使用Statement命名空间。
这里的命名空间指的是映射文件中,sqlMap节的namespace属性
表的映射文件sqlMap节点: <sqlMap namespace="User"> 这里,指定了此sqlMap节点下定义的操作均属于"User"命名空间。
在useStatementNamespaces="true"的情况下,Statement调用需追加命名空间,如:sqlMap.update("User.updateUser",user);
否则直接通过Statement名称调用即可,如: sqlMap.update("updateUser",user); 但请注意此时需要保证所有映射文件中,Statement定义无重名。
-->
<settings
cacheModelsEnabled="true"
enhancementEnabled="true"
lazyLoadingEnabled="true"
errorTracingEnabled="true"
maxRequests="32"
maxSessions="10"
maxTransactions="5"
useStatementNamespaces="false"
/>

<!--
transactionManager: 节点定义了ibatis的事务管理器,目前提供了以下几种选择:
1.JDBC 通过传统JDBC Connection.commit/rollback实现事务支持。
2.JTA 使用容器提供的JTA服务实现全局事务管理。
3.EXTERNAL 外部事务管理,如在EJB中使用ibatis,通过EJB的部署配置即可实现自动的事务管理机制。此时ibatis将把所有事务委托给外部容器进行管理。
-->
<transactionManager type="JDBC">
<!-- 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 type="SIMPLE">
<!-- JDBC驱动 -->
<property name="JDBC.Driver" value="${driver}"/>
<!-- URL -->
<property name="JDBC.ConnectionURL" value="${url}"/>
<!-- 数据库userName -->
<property name="JDBC.Username" value="${userName}"/>
<!-- 数据库password -->
<property name="JDBC.Password" value="${password}"/>
<!-- 数据库连接池可维持的最大容量 -->
<property name="Pool.MaximumActiveConnections" value = "10"/>
<!-- 数据库连接池中允许的挂起(idle)连接数 -->
<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="org/ibatis/hyf/maps/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 ”);
  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 打赏
    打赏
  • 扫一扫,分享海报

©️2022 CSDN 皮肤主题:大白 设计师:CSDN官方博客 返回首页

打赏作者

mohaiyong

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值