iBATIS的中级教程

i 南本。

在免费、且无任何附加条件的前提下，可在网络媒体中自由传播。 如作者意见。

如见及时反馈给 作ib ibatis Qui (5)

准 (5)

构 (5)

ib ib Xm S S OR ibati 数一一延动事基基于外部事务C M LR FI O i 相种“半 BATIS 2.0 开发指

文档版权归原作者所有需部分或者全文引用，请事先征求果本文对您有些许帮助，表达谢意的最好方式，是将您发现的问题和文档改进意者。

atis 开发指南

ck Start 备工作..................................................................建ibatis 基础代码...............................................atis 配置.. (11)

atis 基础语义 (16)

lSqlMapClientBuilder (16)

qlMapClient (16)

qlMapClient 基本操作示例 (16)

映射 (19)

(26)

s 高级特性........................................据关联.. (26)

对多关联 (26)

对一关联 (28)

迟加载 (30)

态映射 (31)

务管理 (35)

于JDBC 的事务管理机制 (35)

JTA 的事务管理机制 (36)

管理 (38)

ache (39)

EMORY 类型Cache 与WeakReference (40)

U 型Cache (42)

FO 型Cache (43)

SCache .................................................................................................43 batis 开发指南

对Hibernate 和Apache OJB 等“一站式”ORM 解决方案而言，ibatis 是一

自动化”的ORM 实现。

所点生涩。纵观目前主流的ORM ，无论Hibernate 还是 Ap 套或Hi 行大多数是对新项目，新系统的开发而言），这样的机制无往不利，大有一 统天下在笔者1．条予公开。

2．存通3．度统性能设计指标。

面对这却发现刀锋不再锐利，甚至无法使用，

奈何？进字段读取操作 令“这O “全自动”ORM 实现了POJO 和数据库表之间的映射，以及SQL 的自动生成和并不会射使is 提供的ORM 机制，对业务逻辑实现人员而言，面对的是纯粹的Java 对象， 这会“__设得别具IBATIS Devel Se ib 准备工作

1. 2. 创建测试数据库，并在数据库中创建一个t_user 表，其中包含三个字段：

谓“半自动”，可能理解上有ache OJB ，都对数据库结构提供了较为完整的封装，提供了从POJO 到数据库表的全

映射机制。

程序员往往只需定义好了POJO 到数据库表的映射关系，即可通过Hibernate 者OJB 提供的方法完成持久层操作。程序员甚至不需要对SQL 的熟练掌握， bernate/OJB 会根据制定的存储逻辑，自动生成对应的SQL 并调用JDBC 接口加以执 。

情况下（特别的势头。但是，在一些特定的环境下，这种一站式的解决方案却未必灵光。 的系统咨询工作过程中，常常遇到以下情况：

系统的部分或全部数据来自现有数据库，处于安全考虑，只对开发团队提供几 Select SQL （或存储过程）以获取所需数据，具体的表结构不开发规范中要求，所有牵涉到业务逻辑部分的数据库操作，必须在数据库层由 储过程实现（就笔者工作所面向的金融行业而言，工商银行、中国银行、交

银行，都在开发规范中严格指定）

系统数据处理量巨大，性能要求极为苛刻，这往往意味着我们必须通过经过高 优化的SQL 语句（或存储过程）才能达到系样的需求，再次举起Hibernate 大刀，恍惚之际，

只好再摸出JDBC 准备拼死一搏……，说得未免有些凄凉，直接使用JDBC 行数据库操作实际上也是不错的选择，

只是拖沓的数据库访问代码，乏味的人厌烦。

半自动化”的ibatis ，却刚好解决了这个问题。

里的“半自动化”，是相对Hibernate 等提供了全面的数据库封装机制的“全自动化” RM 实现而言，

执行。而ibatis 的着力点，则在于POJO 与SQL 之间的映射关系。也就是说，ibatis 行期自动生成SQL 行。具体的 需要程序员编写，然后通过映 为程序员在运执SQL 配置文件，将SQL 所需的参数，以及返回的结果字段映射到指定POJO 。

用ibat 一层与通过Hibernate 实现ORM 而言基本一致，而对于具体的数据操作，Hibernate 自动生成SQL 语句，而ibatis 则要求开发者编写具体的SQL 语句。相对Hibernate 等 全自动”ORM 机制而言，ibatis 以SQL 开发的工作量和数据库移植性上的让步，为系_________统

计提供了更大的自由空间。作为“全自动”ORM 实现的一种有益补充，ibatis 的出现显 意义。

oper’s sion 1.0

Guide Ver ptember 2, 2004 So many open source projects. Why not Open your Doc uments?

atis Quick Start

下载ibatis 软件包（https://www.doczj.com/doc/0417432175.html, ）。

id(int)

nam e(varchar)

sex(int)。

3. 加直观，我们需要将ibatis 日志打开以便观察ibatis 运作的细节。 为了在开发过程更ibatis 采用Apache common_logging ，并结合Apache log4j 作为日志输出组件。在 CL lo lo .ConsoleAppender

lo lo lo 构ib 1．一配置项目的含义见后）：

"h ">

la bled ="true"

er ma ma ma us />

g4j.rootLogger =DEBUG , stdout

g4j.appender.stdout =org .apache .log4j https://www.doczj.com/doc/0417432175.html,yout =org .apache .log4j .PatternLayout

https://www.doczj.com/doc/0417432175.html,yout.ConversionPattern =%c {1} - %m %n

g4j.logger.java.sql.PreparedStatement =DEBUG

建ibatis 基础代码

atis 基础代码包括：

ibatis 实例配置

个典型的配置文件如下（具体xml version ="1.0" enco DOCTYPE sqlMapConfig

BLIC "-//https://www.doczj.com/doc/0417432175.html,//DTD SQL Map Config 2.0//ttp://https://www.doczj.com/doc/0417432175.html,/dtd/sql-map-config-2.dtd qlMapConfig >

ettings

cheModelsEnabled ="true"

hancementEnabled ="zyLoadingEna rorTracingEnabled ="true"

xRequests ="32"

xSessions ="10"

xTransactions ="5"

eStatementNamespaces ="false"

ransactionManager ty ataSource type ="SIMPLE"roperty name ="JDBC.Driver"

"com.p6spy.engine.spy.P6SpyDrive lue =roperty name ="JDBC.ConnectionURL"

e"/>

lue ="jdbc:mysql://localhost/sampl roperty name ="https://www.doczj.com/doc/0417432175.html,ername" valu roperty name ="JDBC.Password" valu roperty name ="Pool.MaximumActiveConnections"

lue ="10"/>

roperty name ="Pool.MaximumIdleConnections" value roperty name ="Pool.MaximumCheckoutTime"

lue ="120000"/>

roperty name ="Pool.TimeToWait" value ="500"/>

va

roperty name ="Pool.PingQuery" value ="select 1 from

COUNT"/>

roperty name =roperty name ="Pool.PingConnectionsOlderThan"

lue ="1"/>

roperty name ="lue ="1"/>

dataSource > transactionManag

pu ble {

pr pr pr pr w HashSet();

/*/

pu }

Pu re }

pu th }

pu re }

pu c void setName(String name) {

th }

pu re }

pu ger sex) {

th sex;

}

}

3．射文件

与atis 的映射文件一般采

用想象中的麻烦）。

针如下：

qlMap resource ="com/ibatis sqlMapConfig >

POJO （P lain Ordinary J ava O bject ）

面是我们用作示例的一个blic class User implements Serializa ivate Integer id;

ivate String name;

ivate Integer sex;

ivate Set addresses = ne t constructor ** defaul blic User() {

blic Integer getId() {

turn this .id;

blic void setId(Integer id) {

is .id = id;

blic String getName() {

turn this .name;

bli is .name = name;

blic Integer getSex() {

turn this .sex;

blic void setSex(Inte is .sex = 映Hibernate 不同。因为需要人工编写SQL 代码，ib aste ，手工编写映射文件也并没手动编写（通过Copy/P 面POJO 的映射代码对上

"h

xml version ="1.0" encoding ="UTF-8"?>

DOCTYPE sqlMap

BLIC "-//https://www.doczj.com/doc/0417432175.html,/ttp://https://www.doczj.com/doc/0417432175.html,/dtd/sql-map-2.dtd">

qlMap namespace ="User">

ypeAlias alias ="user" type ="co

parameterClass ="https://www.doczj.com/doc/0417432175.html,ng.String"

re

[CDATA[

Se er where name = #name#

]]

pa ="user">

]]

pa "

>

IN na se VA S (

#n #s )

pa ="https://www.doczj.com/doc/0417432175.html,ng.String">

de om t_user

wh id = #value#

、、

四SQL 语句，以update 节点为例：

…lect name,sex from t_us >

select >

pdate rameterClass [CDATA[

DATE t_user

T

me=#name#,

x=#sex#

ERE i >

update >

nsert id ="insertUser"erClass ="user ramet SERT INTO t_user (

me,

x)

LUE ame#,

ex#

insert >

"d elete id =Class rameter lete fr ere delete >

sqlMap >

上面的映射文件可以看出，通过、四个节点，我们分别个节点中，我们指定了对应的…

pa

WH # ⑺

]]

义如：

sq ID 件中定义两个同名节点成为可能（两te 节

点，以不⑵pdate id ="updateUser" rameterClass ="user">⑵

[CDATA[ ⑶

DATE t_user ⑷

T (

⑸

me=#nam x=#sex# ⑹

ER >

E id = #id update >

…

ID

定了操作的操作，lMap.update("updateUser ",user);

个upda 设定使得在一个配置文同id 区分） parameterClass

指定了操作所需的参数类型，此例中update 操作以

co 类型的对象作为参数，目标是将提供的User https://www.doczj.com/doc/0417432175.html,er 实例更新到数据库。

pa https://www.doczj.com/doc/0417432175.html,er ”rameterClass ="user"中，user 为“com.ibatis.samp

类的别名，别名可通过typeAlias 节点指定，如示例配置文件中的：

type

⑶通XM ⑷ib 执行。

⑸属⑹se ⑺填对batis 在运行期会读取为“updateUser ”的update 节点

的属数进行填充后提交数据库执行。

此St source ="com/ibatis/sample/SqlMapConfig.xml";

Re re Xm ypeAlias alias ="user"

过节点，可以避QL 中与XML 规范相冲突的字符对

免S 响。

L 映射文件的合法性造成影执行更新操作的SQL ，这里的SQL 即实际数据库支持的SQL 语句，将由

atis 填入参数后交给数据库SQL 中所需的用户名参数，“#name#”在运行期会由传入的user 对象的name

性填充。

SQL 中所需的用户性别参数“#sex#”，将在运行期由传入的user 对象的

x 属性填充。

需SQL 中所的条件参数“#id#”，将在运行期由传入的user 对象的id 属性

充。

于这个示例，i id SQL 定义，并调用指定的user 对象的对应getter 方法获取属性值，并用此

性值，对SQL 中的参例对应的应用级代码如下，其中演示了ibatis SQLMap 的基本使用方法：

ring re ader reader;

ader = Resources.getResourceAsReader(resource);

qlMa mlBui lS pClientBuilder x lder =

ne Sq //tr sq tartTransaction();

Us us us us sq sq fi sq }

其心，所有操作均通过SqlMapClient

实例完成可以看出中烦杂的加清晰简数出而L 可配置化，使得我们可以控制最终的数据操作方式，通过

SQ 机以实现的。

ib 结合上面

PU https://www.doczj.com/doc/0417432175.html,//DTD SQL Map Config 2.0//EN"

"h

ma ma ma us />⑶

w XmlSqlMapClientBuilder();

lMapClient sqlMap = xmlBuilder.buildSqlMap(reader);

sqlMap 系统初始化完毕，开始执行update 操作

y{

lMap.s er user = new User();

er.setId(new Integer(1));

er.setName("Erica");

er.setSex(new Integer(1));lMap.update("u eUser",us pdat er);

https://www.doczj.com/doc/0417432175.html,mitTransaction();

nally{

lMap.endTransaction();

中，SqlMapClient 是ibatis 运作的核。

，对于应用层而言，程序员面对的是传统意义上的数据对象，而非JDBC

esultSet ，这使得上层逻辑开发人员的工作量大大减轻，同时代码更

R 洁。

据库操作在映射文件中加以定义，从而将数据存储逻辑从上层逻辑代码中独立

来。

底层数据操作的SQ L 的优化获得最佳的数据库执行效能，这在依赖SQL 自动生成的“全自动”ORM

制中是所难atis 配置

示例中的配置文件。下面是对配置文件中各节点的说明：

ibatis xml version ="1.0" encodin DOCTYPE sqlMapConf BLIC "-//iBA ttp://https://www.doczj.com/doc/0417432175.html,/dtd/sql-map-config-2.dtd">

qlMapConfig >

ettings ⑴

cheModelsEnabled ="true"

hancementEnabled ="true"

"true"

zyLoadingEnabled =rorTracingEnabled =xRequests ="32"

xSessions ="10"

xTransactions ="5"

eStatementNamespaces ="false"

⑵

ransactionManager ty ataSource type ="SIMP

⑷

ge 能，避免使用Java

Re 同了极大的性能

提建er 发期间建议设为"true"

以la 为"true"

ma ts 最大并发请求数（Statement 并发数）

ma 并发事务数

ma Sq m roperty name ="JDBC.Driver"

lue ="com.p6spy.engine.spy.P6SpyDriver"/>

roperty name ="JDBC.ConnectionURL"

lue ="jdbc:mysql://localhost/sample"/>

roperty name ="https://www.doczj.com/doc/0417432175.html,ername" value ="user"/>

roperty name ="JDBC.Password" value ="mypass"/>

roperty name ="Pool.MaximumActiveConnections"

lue ="10"/>

ool.MaximumIdleConnections" value ="5"/>roperty name ="P roperty name ="Pool.MaximumCheckoutTime"

lue ="120000"/>

roperty name ="Pool.TimeToWait" value ="500"/>

roperty name ="Pool.P COUNT"/>

roperty name ="Pool.PingEnabled" value ="false"/>

"Pool.PingConnectionsOlderThan"

roperty name =lue ="1"/>

roperty name ="Pool.PingConnectionsNotUsedFor"

lue ="1"/>

dataSource >

TIS Developer ’s Guide Version 1.0

ptember 2, 2004 So man transactionManag qlMap resource ="com/ibatis/sam qlMap resource ="com/ibatis/sample/Address.xml"/>

sqlMapConfig >

节点

Settings 数描述

cheModelsEnabled 是否启用SqlMapClient 上的缓存机制。

议设为"true"

hancementEnabled tter/setter 的调用效flect 所带来的性能开销。

ing 带来时，这也为Lazy Load 升。

议设为"true"

gEnabled 是否启用错误日志，在开rorTracin 方便调试

zyLoadingEnabled 是否启用延迟加载机制，建议设xReques xTransactions 最大xSessions 最大Session 数。即当前最大允许的并发

lMapClient 数。

axSessions 设定必须介于

maxTransactions 和maxRequests 之间，即

ma ma us spaces 是否使用Statement 命名空间。

这的表

属在况名空间，如：

sq r)否sq 但请注意Stat ⑵tr 务管理器，目前提供了以下几

种 通 使JTA 服务实现全局事务管理。

外部事务动机制。此时atis 将把所有事务委托给外部容器进行管理。

此也是一个不错的选

择事务管理，参见“高级特性”中的描述。

⑶da 用ty

可 SI 数 实现类为

co 基池组件实现的DataSource 封装，当无容器提

供co rceFactory。

：

xTransactions

S xRequests

eStatementName 里的命名空间指的是映射文件中，sqlMap 节点

namespace 属性，如在上例中针对t_user

的映射文件sqlMap 节点：

qlMap namespace ="User">

里，指定了此sqlMap 节点下定义的操作均于"User"命名空间。

useStatementNamespaces="true"的情

下，Statement 调用需追加命lMap.update("User.updateUser",use

;

则直接通过Statement 名称调用即可，如：

update("updateUser",user);

lMap.此时需要保证所有映射文件中，

重名。

ement 定义无transactionManager 节点

ansactionManager 节点定义了ibatis 的事选择：

JDBC

过传统JDBC https://www.doczj.com/doc/0417432175.html,mit/rollback 实现事务支持。

JTA

用容器提供的TERNA EX L

，如在EJB 中使用ibatis ，通过EJB 的部署配置即可实现自

管理的事务管理ib 外，通过Spring 等轻量级容器实现事务的配置化管理。关于结合容器实现dataSource 节点

taSource 从属于transactionManager 节点，用于设定ibatis 运行期使

的DataSource 属性。

pe 属性：dataSource 节点的type 属性指定了dataSource 的实现类型。选项目：

IMPLE ：

S MPLE 是ibatis 内置的dataSource 实现，其中实现了一个简单的

据库连接池机制，对应ibatis m.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory。

DBCP:

于Apache DBCP 连接DataSource 服务时，建议使用该选项，对应ibatis 实现类为

m.ibatis.qlmap.engi bcpDa s ne.datasource.D taSou JNDI

使用容器提供的实现，将通过指定

的JN co eFacto

ry da ce 的子节点说明（SIMPLE&DBCP ）：

参JD BC 驱动。

如JD 如：如在JD JD JD Po ec 数Po 数允许的挂起（idle ）连接数。

以分别针对SIMPLE 和DBCP 模式的

Da SI 参Po me 数，连接被某个任务所允许占用的

最大时间将被强

制Po eToWait 当线程试图从连接池中获取连接时，连接池中无

可直许秒）

Po 某时会将其测检QL 。

如成Po Po de 对持续连J2EE DataSource DataSource Name 从容器中获取。对应ibatis 实现类为

DI m.ibatis.sqlmap.engine.datasource.JndiDataSourc 。

taSour 数描述

JD BC.Driver ：org.gjt.mm.mysql.Driver

BC.ConnectionURL 数据库URL 。

bc:mysql://localhost/sample

jd 果用的是SQLServer JDBC Driver ，需要

url 后追加SelectMethod=Cursor 以获得

BC 事务的多Statement 支持。

https://www.doczj.com/doc/0417432175.html,ername 数据库用户名

BC.Password 数据库用户密码

ol.MaximumActiveConn

tions

据库连接池可维持的最大容量。

ol.MaximumIdleConnections

据库连接池中上子节点适用于SIMPLE 和DBCP 模式，taSource 私有配置节点如下：

MPLE:

数描述

ol.MaximumCheckoutTi

据库联接池中，如果超过这个时间限定，连接收回。（毫秒）

ol.Tim 用连接可供使用，此时线程将进入等待状态，

到池中出现空闲连接。此参数设定了线程所允

等待的最长时间。（毫ol.PingQuery 数据库连接状态检测语句。

些数据库在连接在某段时间持续处于空闲状态

断开。而连接池管理器将通过此语句检

池中连接是否可用。

测语句应该是一个最简化的无逻辑S “select 1 from t_user ”，如果执行此语句

功，连接池管理器将认为此连接处于可用状态。

ol.PingEnabled 是否允许检测连接状态。

ol.PingConnectionsOl

rThan

接时间超过设定值（毫秒）的连接进行

检测。

Po tU 对（毫秒）的连接进行检测。

DB 参Po mWait 当线程试图从连接池中获取连接时，连接池中无

可直数设定了线程所允

许等待的Po 某空闲状态

时测检如如果执行此语句

成功，连Po 打印日志。

Po me 数Po 时间超过

Re ndonedTimeout 时，是否将其废

弃JN 置相对简单，下面 是使rce

va

sedFor

空闲超过设定值CP:

数描述

ol.Maximu 用连接可供使用，此时线程将进入等待状态，

到池中出现空闲连接。此参最长时间。（毫秒）

ol.ValidationQuery 数据库连接状态检测语句。

些数据库在连接在某段时间持续处于会将其断开。而连接池管理器将通过此语句检

池中连接是否可用。

测语句应该是一个最简化的无逻辑SQL 。

“select 1 from t_user ”，接池管理器将认为此连接处于可用状态。

接被废弃时，是否ol.LogAbandoned 当数据库连ol.RemoveAbandonedTi

out

据库连接被废弃的最大超时时间

ol.RemoveAbandoned 当连接空闲moveAba 。

DI 由于大部分配置是在应用服务器中进行，因此ibatis 中的配分别使用JDBC 和JTA 事务管理的JDNI 配置：

用JDBC 事务管理的JNDI DataSou 配置

ransac ataSource type ="JNDI">

roperty name ="DataSource"

lue ="java:comp/env/jdbc/myDataSource"/>

dataSource >

transactionManager >

ransactionManager type ="JTA" >

roperty name ="UserTransaction"

on/UserTransaction"/>

lue ="java:/ctx/c ataSource type ="JNDI">

roperty name ="DataSource"lue ="java:comp/env/jdbc/myDataSource"/>dataSource >

ATIS Developer ’s Guide Version 1.0

. Why not your u ptember 2, 2004 So many open source projects transactionManager >

sqlMap 节点

sq 节点指定了映射文件的位置，配置中可出现多个节点，以指定

项ibatis 基础语义

Xm

Xm 2.0之后版本新引入的组件，用以替代1.x 版Sq Sq ，提供数据操作的基础平台。Sq 可ent r 创建:

St Re re Xm er xmlBuilder =

ne Sq "c 文件在CLASSPATH

中件Sq 文Sq 以例sq Pr pr pr in tProduct ”, product);

sq 例sq In Pr (“sq 例

sq Cu sq ust ”, parameterObject, customer); sq rameterObject, customer); sq 例sq lMap sqlMap 目内所包含的所有映射文件。

lSqlMapClientBuilder lSqlMapClientBuilder 是ibatis 本中的XmlSqlMapBuilder 。其作用是根据配置文件创建SqlMapClient 实例。 lMapClient

是is 的核心组件lMapClient lMapClient ibat 通过XmlSqlMapCli Builde ring resource ="com/ibatis/sample/SqlMapConfig.xml";

ader reader;

ader = Resources.getResourceAsReader(resource);

lSqlMapClientBuild w XmlSqlMapClientBuilder();

p(reader);

lMapClient sqlMap = xmlBuilder.buildSqlMa "指明了配置om/ibatis/sample/SqlMapConfig.xml 的相对路径。通XmlSqlMapClientBuilder 过接受一个Reader 类型的配置文

句柄，根据配置参数，创建SqlMapClient 实例。

lMapClient 提供了众多数据操作方法，下面是一些常用方法的示例，具体说明

档请参见ibatis java doc ，或者ibatis 官方开发手册。

lMapClient 基本操作示例

下示例摘自ibatis 官方开发手册，笔者对其进行了重新排版以获得更好的阅读效果。 1: 数据写入操作(insert, update, delete):

lMap.startTransaction();

oduct product = new Product();

oduct.setId (1);

uct tion (“Shih Tzu ”);

od .setDescrip t rows = sqlMap.insert (“inser https://www.doczj.com/doc/0417432175.html,mitTransaction();

2: 数据查询(select)

lMap.startTransaction();

teger key = new Integer (1);

queryForObject

oduct product = (Product)sqlMap.”getProduct , key);

https://www.doczj.com/doc/0417432175.html,mitTransaction();

3: 在指定对象中存放查询结果(select)lMap.startTransaction();

stomer customer = new Customer();

lMap.queryForObject(“getC lMap.queryForObject(“getAddr ”, pa https://www.doczj.com/doc/0417432175.html,mitTransaction();

4: 执行批量查询(select)

lMap.startTransaction();

Li “”sq 例//on 时，默认为auto_commit 模式

in 例sq Li “getProductList ”, null , 0, 40); sq 例pu ts RowHandler {

pu list) throws

SQ Pr pr (10000);

sq }

}

sq Ro ndler rowHandler = new MyRowHandler();

Li list = sqlMap.queryForList (“getProductList ”, null ,

ro sq IB Se n y 例Pa sqlMap.queryFo ginatedList (“getProductList ”, null , 10);

li li 例t)

sq Ma ForMap (getProductList , null ,

“sq Pr ST-93”);

O 相而言，ibatis 的映射配置更为简洁直接，下面是一

个

https://www.doczj.com/doc/0417432175.html,mitTransaction();

5: 关于AutoCommit

没有预先执行startTransacti t rows = sqlMap.insert (“insertProduct ”, product);

6:查询指定范围内的数据

lMap.startTransaction();

st list = sqlMap.queryForList (https://www.doczj.com/doc/0417432175.html,mitTransaction();

7: 结合RowHandler 进行查询(select)

blic class MyRowHandler implemen blic void handleRow (Object object, List LException {

oduct product = (Product) object;

oduct.setQuantity lMap.update (“updateProduct ”, product);

lMap.startTransaction();

wHa st wHandler);

https://www.doczj.com/doc/0417432175.html,mitTransaction();

ATIS Developer ’s Guide Version 1.0

open source projects. Why not Ope our Doc uments?

ptember 2, 2004 So many 8: 分页查询(select)

ginatedList list =

rPa st.nextPage();

st.previousPage();

9: 基于Map 的批量查 (selec lMap.startTransaction();

“”p map = sqlMap.query productCode ”);

lM comm nsaction ap.itTra ();

oduct p = (Product) map.get(“E R 映射

对Hibernate 等ORM 实现典型的配置文件。

DOCTYPE sqlMap

"-//https://www.doczj.com/doc/0417432175.html,//DTD SQL Map 2.0//EN"

BLIC ttp://www.ib qlMap namespace ="User">

re ca >

]]

UP SE na se WH d = #id#

模---->

ypeAl as ="u ias ali ser" type ="https://www.doczj.com/doc/0417432175.html,er"/>

acheModel id ="userCache" type ="LRU">

lushInterval hours ="24"/>

lushOnExecute statement =" update roperty name ="size" value ="1000" />

cacheModel >

>

—Statement 配置--e elect id ="getUs r"

rameterClass ="https://www.doczj.com/doc/0417432175.html,ng.sultClass ="user"

cheModel ="userCache"

[CDATA[

lec >

select >

id ="updateUser"

pdate rameterClass DATE t_user

T

me=#name#,

x=#sex#

ERE i update >

sqlMap >

以看到，映射文件主要分为块配置包括： 点：

typeAlias 节定的别名，以避免过长变量值的反复书写，此例中通过

义了本映射文件中typeAlias 节点为类"https://www.doczj.com/doc/0417432175.html,er"定义了一个别名"user"，

这他部分，需要引用"https://www.doczj.com/doc/0417432175.html,er"类时，

样在本配置文件的其只 定

St

cacheModel 节点

义了本映射文件中使用的Cache 机制:

acheModel id Cache" type ="LRU">

lushInterval hours ="24"/>

lushOnExecute statemen roperty name ="size" cacheModel >

里申明了一个名为"userCache"的cacheModel ，之后可以在atement 申明中对其进行引用：

elect id ="getUser"

rameterClass ="https://www.doczj.com/doc/0417432175.html,ng.String"

re ca >

这表明对通过id 为"getUser"的Select statement 获取的数据，使用

ca 进ca 设定值，则将此CacheModel 的缓存清空。

本 cute ：

指ser 操作将更

新缓存中的数据对象与数据库中的实际

数关St St

其最为通用，它可以替代其余的所有节点。除statement 之外

的L 中的同名操作（procedure 对应存储过程）。

使用有操作固然可以达成目标，但缺乏直观性，建议在实际

开选用对应的节点名加以申明。一方面，使得配置文件

更配各in 主st

[r [p rameterMap"]

[r fResultMap"]

[c >

se ertyName#]

or

cheModel ="userCache"

cheModel "userCache"进行缓存。之后如果程序再次用此Statement

行数据查询，即直接从缓存中读取查询结果，而无需再去数据库查询。

cheModel 主要有下面几个配置点：

flushInterval ：

定缓存有效期，如果超过此设size ：

CacheModel 中最大容纳的数据对象数量。

flushOnExe 定执行特定Statement 时，将缓存清空。如updateU 数据库中的用户信息，这将导致据发生偏差，因此必须将缓存清空以避免脏数据的出现。

于Cache 的深入探讨，请参见“高级特性”中的相关章节。

atement 配置：

了数个与相关的节点，分别为：atement 配置包含SQL Statement atement

st insert

delete

update

select

procedure

中，statement 节点各自对应了SQ 定statement 义所发中根据操作目的，各自加直观，另一方面，也可_____借助DTD 对节点申明进行更有针对性的检查，以避免 置上的失误。

种类型的Statement 配置节点的参数类型基本一致，区别在于数量不同。如

sert 、update 、delete 节点无需返回数据类型定义（总是int ）。

要的配置项如下：

atement:

tatement id ="statementName"

lass ="some.c arameterC las esultClass ="https://www.doczj.com/doc/0417432175.html,"]

arameterMap ="nameOfPa esultMap ="nameO acheModel ="nameOfCache"]

lect * from t_user where sex = [?|#prop der by [$simpleDynamic$]

statement >

se

se |#propertyName#]

or

[p s ="https://www.doczj.com/doc/0417432175.html,"]

[p

>

in (n va ([opertyName#])

[p "nameOfParameterMap"]

>

UP SE na se ?|#propertyName#]

WH pertyName#]

De

de t_user

wh

elect id ="statementName"

arameterClass ="https://www.doczj.com/doc/0417432175.html,"]

esultClass ="https://www.doczj.com/doc/0417432175.html,"]

arameterMap ="nameOfParameterMap"]

esultMap ="nameOfResultMap"]

acheModel ="nameOfCache"]

lect * from t_user where sex = [?der by [$simpleDynamic$]

select >

sert:

nsert id ="st arameterClas arameterMap ="nameOfParameterMap"]sert into t_user

e,sex)

am lues

?|#propertyName#],[?|#pr insert >

date ：

pdate id ="statementName"

arameterClas p =arameterMa DATE t_user

T

me=[?|#propertyName#],

x=[ERE id = [?|#pro updat lete ：

elete id ="statementName"

arameterClass ="https://www.doczj.com/doc/0417432175.html,"]

"nameOfParameterMap"]

arameterMap =lete from ere id = [?|#propertyName#]

delete >

中以“[]”包围的部分为可能出现的配置栏目。

述 数描pa 了参数的完整类名（包括包路径）。

可rameterClass 参数类。指定通过别名避免每次重复书写冗长的类名。

re 结果类。指定结果类型的完整类名（包括包路径）

可sultClass 通过别名避免每次重复书写冗长的类名。

pa 点对映射

关对atement 而言，建议使用

pa 免re 加以定义ca 对，尽量使用parameterClass ，即直接将POJO 作为

sta 的属性作为参数加以

设

UP SE na se WH d = #id#

我opertyName #对POJO 的属性进行引用。如上例

中SE 运行期，应的参如果String 、

In 我

re rameterMap 参数映射，需结合parameterMap 节系加以定义。

于存储过程之外的st rameterClass 作为参数配置方式，一方面避

了参数映射配置工作，另一方面其性能表现也更加出色。

结果映射，sultMap 需结合resultMap 节点对映射关系

。

cheModel statement 对应的Cache 模块。

于参数定义而言tement 的调用参数，这样在SQL 中可以直接将POJO 定，如：

pdate id ="updateUser"

rameterClass DATE t_user

T

me=#name#,

x=#sex#

ERE i update >

里将com.ibati 们即可在SQL 中通过#pr 的：

T name=#name#, sex=#sex# WHERE id=#id#

batis 调用Us i 将通过er 对象的getName 、getSex 和getId 方法获得相

数值，并将其作为SQL 的参数。

parameterClass 中设定的是jdk 的中的简单对象类型，如teger ，ibatis 会直接将其作为SQL 中的参数值。

们也可以将包含了参数数据的Map 对象传递给Statement ，如：

pdate id ="updateUser"

rameterClass ="java.util.Map">

DATE t_user

T

me=#name#,

x=#sex#

ERE id = #id#

update >

里传入取对应的参数值。

样的原理，我们elect id ="getUser"

="java rameterClass sultClass ="java.util.Map">

返字段名为key 保存在Map 对象中返回。

在SE id 对：

wh ]]

值例中，ibatis 会调用setName ，setSex 方法将Select 语句返回的数据赋

予例。

有希的如（假设我们的书库中对应用户名的字段为

xi se xi xi fr wh #id#

ib 行属性映射（即调用POJO 的setName 方法而

不

IBA Version 1.0

Se source projects. Why not Open your Doc uments?

pa 一

jd

lect id,name,sex from t_user

ere id = #id#

>

selec 回的结果将以各SQL 中设定参数名时，可以同时指定参数类型，如：

T name=#name:VARCHAR #,sex=#sex:NUMERIC # WHERE

=#id:NUMERIC #

于返回结果是select 语句，建议也采用resultClass 进行定义，如而言，如果elect id ="getUser"

rameterClass ="https://www.doczj.com/doc/0417432175.html,ng.String"

sultClass ="user">

[CDATA[

lect name,sex from t_us name#

ere name = #>

select >

atis 会自动根据select 语句中的字，如上相应的POJO 实些时候，数据库表中的字段名过于晦涩，而为了使得代码更易于理解，我们

望字段映射到POJO 时，采用比较易读的属性名，此时，我们可以通过Select

as 字句对字段名进行转义，ngming ，对应性别的字段为xingbie ）：

lect

ngming as name,

bie sex

ng as om t_user

ere id =atis 会根据转义后的字段名进是setXingming 方法）。TIS Developer ’s Guide ptember 2, 2004 So many open 和rameterMap resultMap 实现了POJO 到数据库字段的映射配置，下面是

个例子：

esultMap id ="get_user_re esult property ="name" column bcType ="VARCHAR" javaType ="https://www.doczj.com/doc/0417432175.html,ng.String"/>

esult property ="sex" column ="xingbie"

bcType ="int esult property ="id" column ="id"

bcType ="int" javaType ="https://www.doczj.com/doc/0417432175.html,ng.Integer"/>

resultMap >

nu />

jd ja nu />

之对其进行引用，如：

{c

pa >

{c sex#)}

Se 处由于存储过程相对而言比较封闭（很多情况下需要调用现有 的并as 子句进行字段名转义，无法使其自动与POJO 中映射 关类型ibati 上ib 数据关联

至我们常常遇到关联数 据的情况，如User 对象拥有若干Address 对象，每个Address 对象描述了对应User 的 一应该如何处理？

arameterMap id ="update_user_para" class ="redemption" >

arameter property ="name"

bcType ="VARCHAR"

vaType ="https://www.doczj.com/doc/0417432175.html,ng.String llValue =""

aramet bcType ="int"

.Integer"

vaType ="https://www.doczj.com/doc/0417432175.html,ng llValue =""

parameterMap >

ramet 后我们即可在statement 申明中rocedure id ="getUserList"

sultMap ="get_user_result"

all sp_getUserList()}

procedure >

roc rameterMap ="update_user_para"

all sp_doUserUpdate(#id#,#name#,#procedure >

言，对于insert 、update 、delete 、select 语句，优先采用resultClass 。

较少，而resultMap 则大多用于嵌套查询rameterMap 使用TIS Developer ’s Guide V ptember 2, 2004 So many open source projects. Why not Open your Doc uments?

理，之所以这样，原因是存储过程，其参数命名和返回的数据字段命名往往不符合Java 编程中的命名习惯， 且由于我们难以通过Select SQL 的的属性名相匹配）。此时，使用resultMap 建立字段名和POJO 属性名之间的系就显得非___________常有效。另一方面，由于通过resultMap 指定了字段名和字段，

无需再通过来动态获取字段信息，在一定程度 s JDBC ResultSetMetaData 也提升了性能表现。

atis 高级特性

此，我们讨论的都是针对独立数据的操作。在实际开发中，个联系地址，这种情况下，我们

通过单独的State 实现（通过Statement 工繁ib 联数 据ment 操作固然可以 用于读取用户数据，再手调用另外一个Statement 根据用户ID 返回对应的Address 信息）。不过这样未免失之 琐。下面我们就看看在ibatis 中，如何对关联数据进行操作。

atis 中，提供了Statement 嵌套支持，通过Statement 嵌套，我们即可实现关的操作。

一下们首选读取t_user 表中的所有用户记录，然后获取每个用户对应 的所有配置文

面的例子中，我地址信息。

件如下：

qlMap namespace ="U ypeAlias alias =ypeAlias alias ="address" type =esultMap id ="get-user-result" class ="user">

esult property ="id" column ="id"/>

esult property ="name" column ="name"/>

esult property ="sex" column ="sex"/>

esult property ="addresses" column ="id"

se

//resultMap >

实现了关联

elect id ="getUsers"

rameterClass ="https://www.doczj.com/doc/0417432175.html,ng.String"

sultMap ="get-us [CDATA[

lect id,name,sex from t_user

ere id = #id#

>

select >

Re reader;

re rces.getResourceAsReader(resource);

Xm tBuilder xmlBuilder = new XmlSqlMapClientBuilder(); sq ilder.buildSqlMap(reader);

//Li elect id ="getAddressByUserId"

rameterClass ="int"

sultC [CDATA[

lect address,zipcodefrom t_address

ere user_id = #userid#

>

select >

sqlMap >

应代码：

ring resource ="com/ibatis/sa ader ader = Resou lSqlMapClien lMap = xmlBu sqlMap 系统初始化完毕

Map.queryForList("User.getUsers", "");

st userList = sql

相关主题

文本预览

相关文档

最新文档

• 幼儿园小班科学《小动物过冬》PPT课件教案
• 2021年春新青岛版(五四制)科学四年级下册 20.《露和霜》教学课件
• 自然教育课件
• 小学语文优质课火烧云教材分析及课件
• (超详)高中语文知识点归纳汇总
• 高中语文基础知识点总结(5篇)
• 高中语文基础知识点总结(最新)
• 高中语文知识点整理总结
• 高中语文知识点归纳
• 高中语文基础知识点总结大全
• 超详细的高中语文知识点归纳
• 高考语文知识点总结高中
• 高中语文知识点总结归纳
• 高中语文知识点整理总结
• 高中语文知识点归纳
• 高中语文知识点归纳(大全)
• 高中语文知识点总结归纳(汇总8篇)
• 高中语文基础知识点整理
• 化工厂应急预案
• 化工消防应急预案(精选8篇)