服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > 专题栏目 > IBATIS专题 > 查看文档

简单的iBatis入门例子

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包装不见了,大家的编码风格统一了,可以集中精力进行业务组件的编写!

扫描关注微信公众号