《一》、iBatis框架的基本介绍：

      Ibatis是开源软件组织Apache推出的一种轻量级的对象关系映射(ORM)框架，和Hibernate、Toplink等在java编程的对象持久化方面深受开发人员欢迎。

对象关系映射(ORM)：简单原理是通过面向对象方式操作关系型数据库，目前存储数据最常用最流行的工具是关系型数据库，其操作方式是通过SQL语句操作数据库的表，但是对于Java面向对象编程语言中，所有的操作对象都是对象，因此对象关系映射就是把数据库表和java编程语言中的对象对 应起来，把表的列同java对象中的字段对应起来，程序员在程序开发过程中不再是使用原始SQL语句去直接操作数据库，而是通过ORM提供的查询语句操作 普通的java对象，ORM将其提供的对普通java对象的查询语句翻译成SQL语句来操作数据库，从而屏蔽了不同数据库SQL语句的差别，简化了程序开 发工作，提高了程序的可移植性。

一、为啥使用iBatis？
在 Hibernate、JPA 这样的一站式对象 / 关系映射（O/R Mapping）解决方案盛行之前，iBaits 基本是持久层框架的不二选择。即使在持久层框架层出不穷的今天，iBatis 凭借着易学易用、轻巧灵活等特点，也仍然拥有一席之地。尤其对于擅长 SQL 的开发人员来说，iBatis 对 SQL 和存储过程的直接支持能够让他们在获得 iBatis 封装优势的同时而不丧失 SQL 调优的手段，这是 Hibernate/JPA 所无法比拟的。具体而言，使用 iBatis 框架的主要优势主要体现在如下几个方面：
首先，iBatis 封装了绝大多数的 JDBC 样板代码，使得开发者只需关注 SQL 本身，而不需要花费精力去处理例如注册驱动，创建 Connection，以及确保关闭 Connection 这样繁杂的代码。
其次，iBatis 可以算是在所有主流的持久层框架中学习成本最低，最容易上手和掌握的框架。虽说其他持久层框架也号称门槛低，容易上手，但是等到你真正使用时会发现，要想掌握并用好它是一件非常困难的事。在工作中我需要经常参与面试，我曾听到过很多位应聘者描述，他们所在的项目在技术选型时选择 Hibernate，后来发现难以驾驭，不得不将代码用 JDBC 或者 iBatis 改写。

二、iBATIS 是什么？

   iBatis是一个持久层框架，它能够自动在java、.NET和Ruby on Rails中与SQL数据库和对象之间的映射。映射是从应用程序逻辑封装在XML配置文件中的SQL语句脱钩。

iBatis是一个轻量级的框架和持久性API适合持久化的POJO（普通Java对象）。

iBatis是被称为一个数据映射和映射需要的类的属性和数据库中的表的列之间的参数和结果。

iBatis和其他持久化框架，如Hibernate之间的显著区别在于，iBATIS强调使用SQL，而其他的框架通常使用一个自定义的查询语言，具有Hibernate查询语言（HQL）或Enterprise JavaBeans的查询语言（EJB QL）。

三.iBatis的设计理念：

四.iBatis的优点

iBatis 自从在 Apache 软件基金会网站上发布至今，和他的明星兄弟们（Http Server，Tomcat，Struts，Maven，Ant 等等）一起接受者万千 Java 开发者的敬仰。在 Apache 寄居六年之后，iBatis 将代码托管到 Google Code。在声明中给出的主要理由是，和 Apache 相比，Google Code 更有利于开发者的协同工作，也更能适应快速发布。于此同时，iBatis 更名为 MyBatis。

从 iBatis 到 MyBatis，不只是名称上的变化，MyBatis 提供了更为强大的功能，同时并没有损失其易用性，相反，在很多地方都借助于 JDK 的泛型和注解特性进行了简化。iBatis 确实该退休了，因为一个更为出色的继任者经过 10 个 Beta 版本的蜕变已然出现在我们的面前。

《二》、 Ibatis的基本操作

1、Ibatis开发的准备工作：

(1).将Ibaits相关的jar包添加到工程的类路径下。

(2).Ibatis工程的主要配置文件为：

a.Ibatis的总配置文件SqlMapConfig.xml。

b.Ibatis的实体映射文件。

2、Ibatis总配置文件sql-map-config.xml：

Ibatis的总配置文件主要是配置数据库连接相关信息，和Ibatis实体映射文件。其写法示例如下：

<? xml version=”1.0” encoding=”UTF-8” ?>  
<! DOCTYPE sqlMapConfig public “-//ibatis.apache.org//DTD SQL Map Config 2.0//EN”  “http://ibatis.apache.org//dtd//sql-map-config-2.dtd”>  
<sqlMapConfig>  
  <transactionManager type=”JDBC” commitRequired=”false”>  
    <dataSource type=”SIMPLE”>  
      <property name= “JDBC.Driver” value=”数据库的jdbc驱动”/>  
      <property name=”JDBC.ConnectionURL” value=”数据库的url”/> 
      <property name=”JDBC.Username” value=”数据库用户名”/>  
      <property name=”JDBC.Password” value=”数据库的密码”/>  
      ……  
    </dataSource>  
  </transactionManager>  
  <sqlMap resource=”Ibatis的实体映射文件”/>  
  ……  
</sqlMapConfig>

3、 Ibatis实体映射文件user.xml的写法示例：

Ibatis的实体映射文件是Ibatis框架的核心，起作用是将Java的持久化实体对象和关系型数据库映射起来，其内容主要是包括java实体各种增删改查操作对应的数据库语句。其写法示例如下：

<? xml version=”1.0” encoding=”UTF-8” ?>  
<! DOCTYPE sqlMap public “-//ibatis.apache.org//DTD SQL Map 2.0//EN”  “http://ibatis.apache.org//dtd//sql-map-2.dtd”>  
<sqlMap namespace=”Ibatis命名空间”>  
  <typeAlias alias=”实体类类别名” type=”实体类全路径”/>  
  <!--restultMap主要是用于Ibatis对数据增删改查操作的返回值结果对于java对象的映射，一般用于所返回的对象可能包含的是一个以上java对象的字段，如果是一个java对象中的字段一般使用resultClass-->  
  <resultMap id=”结果集id” class=”实体类别名”>  
    <result property=”java实体类中的属性名” column=”数据库表中的列名”/>  
    ……  
  </resultMap>  
  ……  
</sqlMap>

4、   读取Ibatis的总配置文件得到SqlMapClient：

private static SqlMapClient sqlMapClient = null;  
static{  try{  
    Reader reader = com.ibatis.common.resource.Resources.getResourceAsReader(“Ibatis总配置文件路径”);  
    sqlMapClient = com.ibatis.sqlMap.client.SqlMapClientBuilder.builderSqlMapClient(reader);  
    reader.close();  }catch(IOException e){  
    异常处理…….  }  
}

5、   Ibatis的SQL Map：

(1).Ibatis的SQL Map的核心概念是Mapped Statement。Mapped Statement可以使用任意的SQL语句，并拥有 parameterMap/parameterClass(输入参数)和resultMap/resultClass(输出结果)。

(2). <statement>元素是个通用的声明，可以用于任何类型的SQL语句，但是通常使用具体的<statement>类型， 如：查询使用<select>，添加使用<insert>，更新使用<update>，删除使 用<delete>。

6、  Ibatis的增删改查操作简单例子：

(1).实体类必须遵循JavaBean的规范，提供一个无参数的构造方法，字段必须提供get和set方法。

(2).在Ibatis对应的实体映射文件的<sqlMap>标签元素添加如下：

7、Ibatis添加：

<insert id=”Ibatis添加实体操作Id” parameterClass=”参数类型”>  insert into 实体对应数据库中的表名(实体字段对应的表的列名1, 实体字段对应的表的列名2,……) values(#实体类字段1#,#实体类字段2#......);  
</insert>

8、Ibatis删除：

<delete id=”Ibatis删除实体操作Id” parameterClass=”参数类型”>  delete from 实体对应数据库中的表名 where 列名=#列名对应的实体字段名#;  
</delete>

9、 Ibatis更新：

<update id=”Ibatis更新实体操作Id” parameterClass=”参数类型”>  update 实体对应数据库的表名 set 列名1=#字段1#，列名2=#字段2#，…….where ….;  
</update>   

10、  Ibatis查询

<select id=”Ibatis查询实体操作Id” resultClass=”查询结果类型” >  select * from 实体对应的表名;  
</select>

11、  在java对象中使用Ibatis的statement操作：

(1).根据Ibatis总配置文件得到SqlMapClient对象，具体方法参见“5. 读取Ibatis的总配置文件得到SqlMapClient”。

(2).使用SqlMapClient对象的 queryForObject()，queryForList()，insert()，delete()，update()方法 。这些方法都需要一个传递一个参数： 在实体映射文件中定义的操作statementId ，如果这些定义的操作还需要输入参数，则还需要传递输入参数对象。简单用法如下：

实体对象类型 对象= sqlMapClient.queryForObject(“实体映射文件命名空间.statementId”, “查询条件参数”); 
例如：
user = (User) sqlMapClient.queryForObject("querybyid",id);
list = sqlMapClient.queryForList("queryAll",user);
sqlMapClient.update("update", user);
sqlMapClient.delete("delete",id);
sqlMapClient.insert("insert", user);
user = (User)sqlMapClient.queryForObject("login", u);

12、  Ibatis主键自动生成：

通过使用 <select>的子元素<selectkey>来支持自动生成主键 。对于不同的数据库主键自动生成机制是不同的，Oracle是通过自增序列欲生成的，MS-SQL Server是通过Identity后生成的。这里以Oracle数据库为例简单讲述一下主键自动生成的方法：

(1).首先在Oracle数据库中创建一个自增的序列：

create Sequence 序列名
start with 1
increment 1;

(2).在insert标签中插入selectkey子标签：

<insert id=”添加实体操作Id” parameterClass=”输入参数类型”>  <selectkey resultClass=”int” keyProperty=”自定义主键名称”>  select 序列名.nextval from dual;  </selectkey>  insert into 表名(主键,列名1,列名2,……)  values(#自定义主键名称#,#字段1#,#字段2#,…….);  
</insert>

13、 Ibatis的内嵌参数：

所谓内嵌参数是指，使用Ibatis时，当没有给定参数传递值时，Ibatis会使用默认的值代替。

语法为：#参数值：数据库中数据类型：内嵌参数#

一个简单的例子如下：

<statement id=”insertProduct” parameterClass=”Product”>  Insert into Product(PRD_ID,PRD_DESC)  values(#id:Number:-999999#,#desc:varchar:noEntry#);  
</statement>

14、 Ibatis对象之间的关系：

Ibatis的输入参数和输出参数只能是一个，因此，当输入参数在一个实体对象时，使用 parameterClass ，当输入对象也只在一个实体对象中时，使用 resultClass 。

但是有很多时候输入参数和输出参数可能包含在几个实体对象中，我们不能为了只传递一个参数而专门为这些输入和输出参数组合专门创建类，因此就需要使用 parameterMap和resultMap 来组合多个实体对象中的字段。

以resultMap为例，使用方法如下：

<resultMap id=”resultMapId”>  <result property=”……” column=”…….” select=”实体映射文件中的StatementId”/>  ……  
</resultMap>   

<sqlMap><typeAlias alias="User" type="com.pojo.User" /><resultMap id="UserResult" class="User"><result property="id" column="ID" />
     <result property="username" column="USERNAME" />
     <result property="password" column="PASSWORD" />
   </resultMap>
    
   <select id="login" resultMap="UserResult" parameterClass="User">
     select * from USER where USERNAME=#username# and PASSWORD=#password#
   </select>
  
   <insert id="insert" parameterClass="User">
    insert into USER(ID,USERNAME,PASSWORD)values(#id#,#username#,#password#)
   </insert>
  
  <delete id="delete" parameterClass="int">delete from USER where ID = #id#</delete>
  
  <update id="update" parameterClass="User">update USER set USERNAME=#username#,PASSWORD=#password# where ID = #id#</update>
  
  <select id="querybyid" parameterClass="int" resultClass="User">select * from USER where ID = #id#</select> <select id="queryAll" parameterClass="User" resultClass="User">select * from USER</select>
</sqlMap>

15、  Ibatis的SQL Map通过<procedure>标签元素调用存储过程：

存储过程是数据库将一组完成特定功能的Sql语句进行编译，每次调用时不必重新编译，因此执行速度和效率都比直接使用Sql语句有很大优势。在 Ibatis中通过<procedure>标签元素 可以直接调用数据库的存储过程，其过程如下：

(1).定义存储过程所需输入/输出参数，如：

<parameterMap id=”存储过程参数” class=”map”>  <parameter property=”email1” jdbcType=”varchar” javaType=”java.lang.String” mode=”INOUT”/>  <parameter property=”email2” jdbcType=”varchar” javaType=”java.lang.String” mode=”INOUT”/>  
</parameterMap>   

(2).调用存储过程，如：

<procedure id=”Ibatis调用存储过程” parameterMap=” 存储过程参数”>  {call 存储过程名(?,?)}  
</procedure>   

注意：Ibatis调用存储过程时，要确保始终只使用JDBC标准的存储过程语法。

16、  Ibatis与Spring集成：

现在Java Web开发中，SSH(Spring,Sturts,Hibernate)三个开源框架组合非常流行，对于一些对Hibernate不熟悉或者怀疑 Hibernate性能的人，也可以使用Ibatis代替Hibernate框架，即SSI(Spring,Struts,Ibatis)。Spring 和Struts的集成这里不多说了，具体说一下Spring和Ibatis的集成。

(1).对Ibatis工程引入Spring支持，即将Spring相关的jar包加入到类路径中，在/src目录下创建spring配置文件，在web.xml文件中指定spring配置文件并添加spring的WebContext启动监听器。

(2).将对数据库的连接信息放交由spring管理，在spring配置文件中添加数据库连接信息：

<bean id=”dataSource” class=”org.apache.commons.dbcp.BasicDataSource” destroy-method=”close”>  <property name=”driverClassName” value=”数据库驱动类”/>  <property name=”url” value=”数据库连接URL”/>  <property name=”username” value=”数据库连接用户名”/> <property name=”password” value=”数据库连接密码”/>  
</bean>   

(3).在spring配置文件中添加对Ibatis的支持：

<bean id=”sqlMapClient” class=”org.springframework.orm.ibatis.SqlMapClientFactoryBean”>  <property name=”configLocation” value=”Ibatis总配置文件路径”/>  <!--为Spring创建的SqlMapClient对象指定数据源-->  <property name=”dataSource” ref=”dataSource”/>  
</bean>

<bean id="sqlMapClient" class="org.springframework.orm.ibatis.SqlMapClientFactoryBean"><property name="dataSource"><ref bean="dataSource"/></property><property name="configLocation"><value>/WEB-INF/sql-map-config.xml</value></property></bean>

(4).在Ibatis总配置文件中移除关于数据库连接的信息，只需在Ibatis总配置文件中配置实体映射文件即可。

至此，Spring和Ibatis就无缝集成起来，在使用时Spring会读取创建SqlMapClient对象，并为其注入数据源，直接通过spring获得SqlMapClient对象就可以直接使用。