iBATIS最大的特點是簡單,最新版本2.0(下載),和1.0相比,主要改動在XML配置文件上,不過,只要有SQL基礎,相信你不用教程也能看明白。下面我們看一個最簡單的例子入門。
我們先建一個表Account,包括字段username, varchar(20), pk和password, varchar(20),隨便填入一些數據。然後編寫iBatis必須的配置文件sql-map-config.xml,文件名隨意,內容如下:(配置文件放在src下面)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE sqlMapConfig PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN" "http://www.ibatis.com/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
<settings
cacheModelsEnabled="true"
enhancementEnabled="true"
lazyLoadingEnabled="true"
maxRequests="32"
maxSessions="10"
maxTransactions="5"
useStatementNamespaces="false" />
<transactionManager type="JDBC" >
<dataSource type="SIMPLE">
<property name="JDBC.Driver" value="oracle.jdbc.driver.OracleDriver"/>
<property name="JDBC.ConnectionURL" value="jdbc:oracle:thin:@10.12.1.3:1521:SID"/>
<property name="JDBC.Username" value="username"/>
<property name="JDBC.Password" value="pw"/>
</dataSource>
</transactionManager>
<sqlMap resource="Account.xml" />
</sqlMapConfig>
其他部分你不用管它,我是直接copy的示例配置,只需注意紅色部分,配置好數據源即可。我用的是Oracle,所以用此驅動。如果你用MySQL或其他數據庫,更改相應的屬性。
然後注意到這個配置文件還引用了一個Account.xml(也放在src下面),沒錯,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;
}
}
iBATIS之編寫Account.xml文件:
<?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="Account">
<select id="getAccount" parameterClass="java.lang.String" resultClass="example.Account">
select * from Account where username = #value#
</select>
<insert id="createAccount" parameterClass="example.Account">
insert into Account (username, password) values ( #username#, #password# )
</insert>
</sqlMap>
我們主要關心以﹤select ...﹥爲主,這裏定義了一個查詢方法,名字爲getAccount,傳入參數爲String,返回類型resultClass就是 example.Account類,select語句相信你已經很熟悉了,#value#是我們將要傳進去的String。
﹤insert...﹥ 與之類似,不過注意到#username#和#password#,由於參數是Account類,它們將被Account.getUsername()和 Account.getPassword()替換。所以,只要你會寫SQL,就能非常容易地寫出配置文件。
最後便是如何使用iBatis實現O/R映射。首先初始化iBatis獲得一個SqlMapClient對象:
com.ibatis.sqlmap.client.SqlMapClient sqlMap = null;
Account account = null;
try
{
java.io.Reader reader = com.ibatis.common.resources.Resources.getResourceAsReader ("sql-map-config.xml");
sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
// account = new Account();
// account.setUsername("test");
// account.setPassword("1234");
// sqlMap.insert("createAccount", account);
account = (Account)sqlMap.queryForObject("getAccount", "fun");
if(account!=null)
{
System.out.println("username:"+account.getUsername());
System.out.println("password:"+account.getPassword());
}
else
{
System.out.println("account is null");
}
運行時把兩個配置文件和iBatis的jar包(ibatis-2.3.4.726.jar)放到classpath中,要求jdk1.4版本。
iBATIS總 結:iBATIS確實簡單靈活,上手容易,代碼很少,配置稍嫌複雜。不足之處一是沒有方便的工具來自動生成xml配置文件,二是不管是query還是 insert都只能傳入一個參數,有時不得不把兩個參數包裝成一個類傳進去。另外對常見的1:1,1:N關係的支持不如Hibernate。不過,大多數 時候iBATIS已經完全可以滿足我們的需求。Spring很好的集成了iBATIS,你可以參考Spring的JPetStore示例。需要注意的是使 用iBatis 2.0和1.0有較大區別,主要體現在配置文件上,iBATIS2.0新增了DAO框架,不需要Spring提供的DAO也能很方便地實現DAO模式。
資源下載中有一個項目配置了SSI2,供參考。