---
title: "iBatis：又一个O/R Mapping解决方案"
author: "mmdev"
date: "2004-09-29T22:04:00Z"
tags: []
slug: "ibatis-o-r-mapping"
draft: false
lastmod: "2004-09-29T22:04:00Z"
id: 1006671
url: "https://mmdev.iteye.com/blog/1006671"
---

iBatis是又一个O/R Mapping解决方案，j2ee的O/R方案真是多，和Hibernate相比，iBatis最大的特点就是小巧，上手很快。如果你不需要太多复杂的功能，iBatis是能满足你的要求又足够灵活的最简单的解决方案。

iBatis最大的特点是简单，最新版本2.0（[下载](http://www.ibatis.com/common/download.html)），和1.0相比，主要改动在XML配置文件上，不过，只要有SQL基础，相信你不用教程也能看明白。下面我们看一个最简单的例子入门。

我们先建一个表Account，包括字段username,varchar(20), pk和password, varchar(20)，随便填入一些数据。然后编写iBatis必须的配置文件sql-map-config.xml，文件名随意，内容如下：

&lt;?xml version="1.0" encoding="UTF-8" ?&gt;  
&lt;!DOCTYPE sqlMapConfig  
PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"  
"[http://www.ibatis.com/dtd/sql-map-config-2.dtd](http://www.ibatis.com/dtd/sql-map-config-2.dtd)"&gt;  
&lt;sqlMapConfig&gt;  
&lt;settings  
cacheModelsEnabled="true"  
enhancementEnabled="true"  
lazyLoadingEnabled="true"  
maxRequests="32"  
maxSessions="10"  
maxTransactions="5"  
useStatementNamespaces="false"  
/&gt;  
&lt;transactionManager type="JDBC" &gt;  
&lt;dataSource type="SIMPLE"&gt;  
&lt;property name="JDBC.Driver" value="sun.jdbc.odbc.JdbcOdbcDriver"/&gt;  
&lt;property name="JDBC.ConnectionURL" value="jdbc:odbc:Blog"/&gt;  
&lt;property name="JDBC.Username" value="admin"/&gt;  
&lt;property name="JDBC.Password" value=""/&gt;  
&lt;/dataSource&gt;  
&lt;/transactionManager&gt;  
&lt;sqlMap resource="Account.xml" /&gt;  
&lt;/sqlMapConfig&gt;

其他部分你不用管它，我是直接copy的示例配置，只需注意红色部分，配置好数据源即可。我用的是Access，所以用JdbcOdbc驱动。如果你用MySQL或其他数据库，更改相应的属性。

然后注意到这个配置文件还引用了一个Account.xml，没错，iBatis把每个需要O/R Mapping的Java对象关联到一个xml配置文件，我们需要把一个Account表映射到一个Account类：

package example;  
public class Account {  
private String username;  
private String password;

public String getUsername() { return username; }  
public void setUsername(String username) { this.username=username; }

public String getPassword() { return password; }  
public void setPassword(String password) { this.password=password; }  
}

编写Account.xml文件：

&lt;?xml version="1.0" encoding="UTF-8" ?&gt;  
&lt;!DOCTYPE sqlMap  
PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"  
"[http://www.ibatis.com/dtd/sql-map-2.dtd](http://www.ibatis.com/dtd/sql-map-2.dtd)"&gt;  
&lt;sqlMap namespace="Account"&gt;

&lt;select id="getAccount" parameterClass="java.lang.String" resultClass="example.Account"&gt;  
select * from Account whereusername = #value#  
&lt;/select&gt;

&lt;insert id="createAccount" parameterClass="example.Account"&gt;  
insert into Account (username, password)  
values ( #username#, #password# )  
&lt;/insert&gt;  
&lt;/sqlMap&gt;

我们主要关心红色部分。以&lt;select ...&gt;为例，这里定义了一个查询方法，名字为getAccount，传入参数为String，返回类型resultClass就是example.Account类，select语句相信你已经很熟悉了，#value#是我们将要传进去的String。

&lt;insert...&gt;与之类似，不过注意到#username#和#password#，由于参数是Account类，它们将被Account.getUsername()和Account.getPassword()替换。所以，只要你会写SQL，就能非常容易地写出配置文件。

最后便是如何使用iBatis实现O/R映射。首先初始化iBatis获得一个SqlMapClient对象：

com.ibatis.sqlmap.client.SqlMapClient sqlMap = null;  
try {  
java.io.Reader reader = om.ibatis.common.resources.Resources.getResourceAsReader ("sql-map-config.xml");  
sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);  
} catch (Exception e) {  
e.printStackTrace();  
}

然后就可以异常方便地使用O/R Mapping了，比如查询username=admin的Account：

try {  
Account accout = (Account)sqlMap.queryForObject("getAccount", "admin");  
...  
}

或者创建一个新的Account：

try {  
Account account = new Account();  
account.setUsername("micheal");  
account.setPassword("1234");  
sqlMap.insert("createAccount", account);  
}

运行时把两个配置文件和iBatis的3个jar包放到classpath中，要求jdk1.4版本。

总结：iBatis确实简单灵活，上手容易，代码很少，配置稍嫌复杂。不足之处一是没有方便的工具来自动生成xml配置文件，二是没有办法看到生成的SQL语句（还是我没有正确配置？），调试比较麻烦。另外对常见的1:1，1:N关系的支持不如Hibernate。不过，大多数时候iBatis已经完全可以满足我们的需求。Spring很好的集成了iBatis，你可以参考Spring的JPetStore示例。需要注意的是使用iBatis 2.0和1.0有较大区别，主要体现在配置文件上，iBatis 2.0新增了DAO框架，不需要Spring提供的DAO也能很方便地实现DAO模式。