iBATIS快速入门之例子

       最近加入的项目，使用的ORM方案是iBATIS,以前用的都是hibernate，于是赶紧开始学习，上网google了下，发现ibatis是一个轻量级的o/r mapping解决方案，上手很快，于是决定不从教程看起了，在网上找了个例子，作为入门用。这个例子讲的简单清楚，很适合快速上手用，如果有需要的朋友也可以看一下。

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，文件名随意，内容如下：

 

﹤?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="sun.jdbc.odbc.jdbcodbcdriver"/﹥  
     ﹤property name="jdbc.connectionurl" value="jdbc:odbc:blog"/﹥  
     ﹤property name="jdbc.username" value="admin"/﹥  
     ﹤property name="jdbc.password" value=""/﹥  
   ﹤/datasource﹥  
﹤/transactionmanager﹥  
﹤sqlmap resource="account.xml" /﹥  
﹤/sqlmapconfig﹥ 
[/pre]

 其他部分你不用管它，我是直接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; }  
} 

 [/pre]
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﹥ 

 [/pre]
我们主要关心以﹤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;  
   try {  
       java.io.reader reader = om.ibatis.common.resources.resources.getresourceasreader ("sql-map-config.xml");  
       sqlmap = sqlmapclientbuilder.buildsqlmapclient(reader);  
   } catch (exception e) {  
       e.printstacktrace();  
} 

 [/pre]
然后就可以异常方便地使用o/r mapping了，比如查询username=admin的account：

 

try {  
      account accout = (account)sqlmap.queryforobject("getaccount", "admin");  
      ...  
  } 

 [/pre]
或者创建一个新的account：

 

try {  
    account account = new account();  
    account.setusername("micheal");  
    account.setpassword("1234");  
    sqlmap.insert("createaccount", account);  
} 

 [/pre]
运行时把两个配置文件和ibatis的3个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模式。