iBatis是一个O/R Mapping解决方案, iBatis最大的特点就是小巧,上手很快。如果你不需要太多复杂的功能,iBatis是能满足你的要求又足够灵活的最简单的解决方案。下面我们看一个最简单的入门例子,是《ibatis 开发指南》上的例子改的,不过上面讲的不仔细,我开始学的时候搞了一个晚上才把那个例子跑起来的,相信一些朋友也和我一样,在入门的时候有一点小郁闷,我把整个工程项目打包了供朋友下载,工具是eclipse3.2+myeclipse5.0,导入即可运行,数据库用的是MySQL。也可以改用别的数据库!
先建数据库和表吧;sql语句我导出来了:
/* SQLyog 企业版 - MySQL GUI v4.1 主机 - 5.0.7 -beta-nt : 数据库 - sample ********************************************************************* 服务器版本 : 5.0.7 -beta-nt create database if not exists `sample`; USE `sample`; /*数据表 `t_user` 的表结构*/ drop table if exists `t_user`; CREATE TABLE `t_user` ( `id` int(11) NOT NULL auto_increment, `name` varchar(50) default NULL, `sex` int(11) default NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=latin1; /*数据表 `t_user` 的数据*/ insert into `t_user` values (1,'zhupan',1),(2,'zhupan',2),(3,'3',3),(4,'4',4),(5,'5',5);
|
整个工程目录结构如下:
lib包下面的文件:
下面开始编写每个文件:
编写iBatis必须的配置文件SqlMapConfig.xml,放在包com.ctgusec.zhupan.maps下,文件名可以任意改,内容如下:
<?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" errorTracingEnabled="true" maxRequests="32" maxSessions="10" maxTransactions="5" useStatementNamespaces="false" />
<transactionManager type="JDBC"> <dataSource type="SIMPLE"> <property name="JDBC.Driver" value="com.mysql.jdbc.Driver" /> <property name="JDBC.ConnectionURL" value="jdbc:mysql://localhost/sample" /> <property name="JDBC.Username" value="root" /> <property name="JDBC.Password" value="" /> <property name="Pool.MaximumActiveConnections" value="10" /> <property name="Pool.MaximumIdleConnections" value="5" /> <property name="Pool.MaximumCheckoutTime" value="120000" /> <property name="Pool.TimeToWait" value="500" /> <property name="Pool.PingQuery" value="select 1 from sample" /> <property name="Pool.PingEnabled" value="false" /> <property name="Pool.PingConnectionsOlderThan" value="1" /> <property name="Pool.PingConnectionsNotUsedFor" value="1" /> </dataSource> </transactionManager> <sqlMap resource="com/ctgusec/zhupan/maps/User.xml" /> </sqlMapConfig> |
如果不用mysql数据库,需要重新配置数据源(红色加粗字体标出),更改相应的属性即可。
然后注意到这个配置文件还引用了一个User.xml, iBatis把每个需要O/R Mapping的Java对象关联到一个xml配置文件,我们需要把t_user表映射到一个User类:
package com.ctgusec.zhupan.model; import java.io.Serializable;
public class User implements Serializable {
/** * @author zhupan */ private static final long serialVersionUID = 1L ;
private Integer id;
private String name;
private Integer sex;
public User() { }
public Integer getId() { return this.id; }
public void setId(Integer id) { this.id = id; }
public String getName() { return this.name; }
public void setName(String name) { this.name = name; }
public Integer getSex() { return this.sex; }
public void setSex(Integer sex) { this.sex = sex; } } |
编写User.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="User">
<typeAlias alias="user" type="com.ctgusec.zhupan.model.User" /> <select id="getUser" parameterClass="java.lang.String" resultClass="user"> <![CDATA[ select name, sex from t_user where name = #name# ]]> </select>
<select id="getAllUser" resultClass="user"> <![CDATA[ select name, sex from t_user ]]> </select>
<update id="updateUser" parameterClass="user"> <![CDATA[ UPDATE t_user SET name=#name#, sex=#sex# WHERE id = #id# ]]> </update>
<insert id="insertUser" parameterClass="user"> INSERT INTO t_user ( name, sex) VALUES ( #name#, #sex# )</insert>
<delete id="deleteUser" parameterClass="java.lang.String"> delete from t_user where id=#value# </delete> </sqlMap> |
通过<insert>、<delete>、<update>、<select>节点,分别定义了针对 TUser 对象的增删改查操作。在这些节点中,我们指定了对应的 SQL 语句:ID 指定了操作 ID,之后我们可以在代码中通过指定操作 id 来执行此节点所定义的操作,如: sqlMap.update("updateUser",user); ID设定使得在一个配置文件中定义两个同名节点成为可能(两个update节点,以不同id区分) parameterClass 指定 了 操 作 所 需的 参 数 类型 , 此例 中 update 操 作 以com.ctgusec.zhupan.model.User 类型的对象作为参数,目标是将提供的 User实例更新到数据库。 parameterClass="user"中,user为“com.ctgusec.zhupan.model.User”类的别名,别名可通过typeAlias节点指定,如示例配置文件中的:<typeAlias alias="user" type="com.ctgusec.zhupan.model.User"/>“#name#”在运行期会由传入的user对象的name属性填充。 “#sex#”,将在运行期由传入的 user 对象的sex属性填充。“#id#”,将在运行期由传入的user对象的id属性填充。
只要你会写SQL,就能非常容易地写出配置文件。
最后便是如何使用iBatis实现O/R映射,测试给个例子:
package com.ctgusec.zhupan;
import java.sql.SQLException; import java.util.List;
import com.ctgusec.zhupan.model.User; import com.ibatis.sqlmap.client.SqlMapClientBuilder;
/** * * @author zhupan */ public class ExampleMain {
public static void update() { //首先初始化iBatis获得一个SqlMapClient对象 String resource = "com/ctgusec/zhupan/maps/SqlMapConfig.xml"; com.ibatis.sqlmap.client.SqlMapClient sqlMap = null; try { java.io.Reader reader = com.ibatis.common.resources.Resources.getResourceAsReader(resource); sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader); } catch (Exception e) { e.printStackTrace(); } // sqlMap系统初始化完毕,开始执行update操作 try { sqlMap.startTransaction(); User user = new User(); user.setId(new Integer(1)); user.setName("zhupan"); user.setSex(new Integer(1)); sqlMap.update("updateUser", user); sqlMap.commitTransaction(); } catch (SQLException e) { System.out.println(e.getMessage()); } finally { try { sqlMap.endTransaction(); } catch (SQLException e) { e.printStackTrace(); } } } public static List getUser() { // 首先初始化iBatis获得一个SqlMapClient对象 String resource = "com/ctgusec/zhupan/maps/SqlMapConfig.xml"; com.ibatis.sqlmap.client.SqlMapClient sqlMap = null; List user=null; try { java.io.Reader reader = com.ibatis.common.resources.Resources.getResourceAsReader(resource); sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader); } catch (Exception e) { e.printStackTrace(); } // sqlMap系统初始化完毕,开始执行getAllUser操作 try { sqlMap.startTransaction(); user=sqlMap.queryForList("getAllUser", null); sqlMap.commitTransaction(); } catch (SQLException e) { System.out.println(e.getMessage()); } finally { try { sqlMap.endTransaction(); } catch (SQLException e) { e.printStackTrace(); } } return user; } public static void main(String[] args) { update(); List user=getUser(); for(int i=0;i<user.size();i++) { System.out.println(((User)user.get(i)).getName()); } } } |
运行时把lib包下的所有.jar构建到路径中,操作如下:
点击
找到.jar文件全部选中,确认即可
总结:iBatis确实简单灵活,上手容易,代码很少,配置稍嫌复杂。动态SQL的确是个强点,熟悉后感觉很不错。iBatis中所有的DAO方法都只传一个值对象,复杂查询当然也不例外。另外对常见的1:1,1:N关系的支持不如Hibernate。使用iBatis 2.0和1.0有较大区别,主要体现在配置文件上,iBatis 2.0新增了DAO框架,不需要Spring提供的DAO也能很方便地实现DAO模式。持久层使用了iBatis后,团队中以前乱七八糟的jdbc包装不见了,大家的编码风格统一了,可以集中精力进行业务组件的编写!
有个帮助文档格式的,要的话联系gujuny@126.com