ibatis入门详细教程(结合案例)

0.0 2004.8.1 夏昕第一版

1.0 2004.9.1 夏昕补充 ibatis in Spring 部分

OpenDoc 版权说明

本文档版权归原作者所有。

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

如需部分或者全文引用，请事先征求作者意见。

如果本文对您有些许帮助，表达谢意的最好方式，是将您发现的问题和文档改进意见及时

反馈给

准备工作.......................................................................................................... 5

构建 ibatis 基础代码.................................................................................... 5

ibatis 配置........................................................................................................... 11

ibatis 基础语义...................................................................................................... 16

XmlSqlMapClientBuilder................................................................... 16

SqlMapClient ........................................................................................... 16

SqlMapClient 基本操作示例.......................................................... 16

OR 映射........................................................................................................... 19

ibatis 高级特性...................................................................................................... 26

数据关联........................................................................................................ 26

基于 JTA 的事务管理机制................................................................... 36

外部事务管理......................................................................................... 38

Cache .............................................................................................................. 39

MEMORY 类型 Cache 与 WeakReference ........................................ 40

LRU 型 Cache ....................................................................................... 42

FIFO 型 Cache ...................................................................................... 43

OSCache................................................................................................. 43

ibatis 开发指南

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

自动化”的 ORM 实现。

套映射机制。程序员往往只需定义好了 POJO 到数据库表的映射关系，即可通过 Hibernate

或者 OJB 提供的方法完成持久层操作。程序员甚至不需要对 SQL 的熟练掌握，

Hibernate/OJB 会根据制定的存储逻辑，自动生成对应的 SQL 并调用 JDBC 接口加以执

行。

大多数情况下（ 特别是对新项目，新系统的开发而言）

，这样的机制无往不利，大有一

统天下的势头。但是，在一些特定的环境下，这种一站式的解决方案却未必灵光。

在笔者的系统咨询工作过程中，常常遇到以下情况：

面对这样的需求，再次举起 Hibernate 大刀，却发现刀锋不再锐利，甚至无法使用，

奈何？恍惚之际，只好再摸出 JDBC 准备拼死一搏……，说得未免有些凄凉，直接使用

进行数据库操作实际上也是不错的选择，只是拖沓的数据库访问代码，乏味的字段读取操

令人厌烦。

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

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

ORM 实现而言，“全自动”ORM 实现了 POJO 和数据库表之间的映射，以及 SQL 的自动

生成和执行。而 ibatis 的着力点，则在于 POJO 与 SQL 之间的映射关系。也就是说，ibatis

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

得别具意义。

ibatis Quick Start

准备工作

1. 下载 ibatis 软件包（http://www.ibatis.com）。

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

. id(int)

. name(varchar)

. sex(int) 。

3. 为了在开发过程更加直观，我们需要将 ibatis 日志打开以便观察 ibatis 运作的细节。

log4j.rootLogger=DEBUG, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=%c{1} -%m%n

log4j.logger.java.sql.PreparedStatement=DEBUG

构建 ibatis 基础代码

ibatis 基础代码包括：

1． ibatis 实例配置

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

<property name=

value="10"/>

value="120000"/>

<property name="Pool.TimeToWait" ="500"/>

<property name="Pool.PingQuery" ="select 1 from

<property name="Pool.PingEnabled" ="false"/>

<property name=

value="1"/>

<property name=

value="1"/>

</dataSource>

</transactionManager>

<sqlMap resource="com/ibatis/sample/User.xml"/>

</sqlMapConfig>

valuevalue"Pool.MaximumActiveConnections"

"Pool.MaximumIdleConnections"

"Pool.MaximumCheckoutTime"

private Integer sex;

/** default constructor */

public User() {

}

public Integer getId() {

return this.id;

}

public void setId(Integer id) {

this.id = id;

}

public String getName() {

return this.name;

}

public Integer getSex() {

public void setSex(Integer sex) {

this.sex = sex;

}

3． 映射文件

针对上面 POJO 的映射代码如下：

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

<!DOCTYPE sqlMap

PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"

"http://www.ibatis.com/dtd/sql-map-2.dtd">

<sqlMap namespace="User">

<typeAlias alias="user" type="com.ibatis.sample.User"/>

<select id="getUser"

parameterClass="java.lang.String"

where name = #name#

</select>

<update id="updateUser"

parameterClass="user">

<![CDATA[

UPDATE t_user

SET

name=#name#,

sex=#sex#

WHERE id = #id#

]]>

</update>

<insert id="insertUser"

name,

sex)

#sex#

)

</insert>

parameterClass="java.lang.String">

delete from t_user

where id = #value#