作者:夏昕 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
”);