iBATIS教程之快速入门浅析

Quotes: http://developer.51cto.com/art/200907/138286.htm

 

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﹥ 

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

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
;  

    
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总 结：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模式。