IBatis入門配置

iBATIS教程要從iBATIS的概念開始,它是又一個O/R Mapping解決方案,j2ee的O/R方案真是多,和Hibernate相比,iBATIS最大的特點就是小巧,上手很快。如果你不需要太多複雜的功能,iBATIS是能滿足你的要求又足夠靈活的最簡單的解決方案。

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,供參考。

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章