blogjava's web log

blogjava's web log
...

夏昕ibatisiBATIS 2.0 开发指南配置文件说明

作者:夏昕 xiaxin(at)gmail.com

ibatis基础代码包括: 
1.  ibatis实例配置 
一个典型的配置文件如下(具体配置项目的含义见后): 
<? xml version="1.0" encoding="UTF-8"  ?>  
<! DOCTYPE sqlMapConfig 
    PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0/
    "http://www.ibatis.com/dtd/sql-map-config-2.dt
 
<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
="com.p6spy.engine.spy.P6SpyDriver" />  
      
< property  name ="JDBC.ConnectionURL"  
value
="jdbc:mysql://localhost/sample" />  
      
< property  name ="JDBC.Username"  value ="user" />  
      
< property  name ="JDBC.Password"  value ="mypass" />  
      
< property  name ="Pool.MaximumActiveConnections"  
value
="10" />  
      
< 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 ="com/ibatis/sample/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 ”); 


 

posted on 2006-05-24 10:47 record java and net 阅读(2865) 评论(4)  编辑  收藏 所属分类: java转载的文章

评论

# 请教您一个问题 2006-08-02 15:31 Big Head

以前我写用的IDE是eclipse 3.2 + 插件MyEclipse 5.0 ,我把ibatis的配置文件放在src目录下一个名为sqlmap的包内,还是我可以正常使用。

后来我把IDE换成JBuilder 2005,我用同样的方法,却不能使用。

请问大虾,在JBuilder中,这个配置文件的路径是不是有什么不同啊??

麻烦您帮我解决这个问题,本人不甚感激!!

我的E-mail是: yuanqijinstar@163.com  回复  更多评论   

# re: 夏昕ibatisiBATIS 2.0 开发指南配置文件说明 2006-08-02 16:06 吴某人-不断地学习

eclipse 会把 src的sqlmap文件 自动拷到 classes 目录下..

JBuilder 好像不会..你再自己手工把配置文件靠到 classes 目录下就可以..  回复  更多评论   

# re: 夏昕ibatisiBATIS 2.0 开发指南配置文件说明 2006-11-23 11:35 Apple[匿名]

请教您个问题:  回复  更多评论   

# re: 夏昕ibatisiBATIS 2.0 开发指南配置文件说明 2006-11-23 11:38 Apple[匿名]

我用struts+ibatis 做insert的时候不知道为什么不读我的struts-config.xml
总是插入不成功, <action
attribute="registerForm"
input="/register.jsp"
name="registerForm"
path="/register"
scope="request"
type="cn.com.test.struts.action.RegisterAction">
<forward
name="wrong"
path="/7.jsp"
redirect="true" />
<forward
name="success"
path="/3.jsp"
redirect="true" />
</action>

请指教!!  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 

导航

常用链接

留言簿(43)

新闻档案

2.动态语言

3.工具箱

9.文档教程

友情链接

搜索

最新评论