1.关于iBatis

iBatis是"internet"和"abatis"的组合，是Clinton Begin在2002年发起的开源代码项目。

iBatis在2010年被谷歌托管，改名为MyBaits。

iBatis是一个基于SQL映射的半自动化ORM持久层框架，支持JAVA和.NET。

2.iBatis相关jar包

3.SQL Map配置文件

3.1.<properties/>

SQL Map拥有唯一的<properties>元素，用于在配置文件中使用标准的JAVA属性文件，

如：JDBC事务管理连接中连接数据库的值。

<properties name = "JDBC.Driver" value = "${jdbc.driverClassName}" />

注：SQL Map配置文件及每个映射文件都可以使用占位符${}来代替值。

3.2.<setting/>

<setting/>用于配置和优化SqlMapClient实例的各选项，<setting/>本身和它的属性都是可选的。

3.3.<typeAlias/>

<typeAlias/>用于指定别名，更方便使用。

<typeAliais alias = "shortName" type = "com.long.class.path.Class" />

SQL Map预定义的别名：

3.4.<transactionManager></transactionManager>

<transactionManager/>是SQL Map用来配置事务管理服务的，type属性用于指定所需要使用的事务管理器类型。框架中包含的三个事务管理器分别是：JDBC,JTA,EXTERNAL。

3.5.<dataSource></dataSource>

<dataSource></dataSource>是<transactionManager></transactionManager>的一部分，它为SQL Map数据源设置了一部分参数。

<transactionManager type="JDBC">

<dataSource type="SIMPLE">

<property name = "JDBC.Driver" value = "${jdbc.driverClassName}" />

<property name = "JDBC.ConnectionURL" value = "${jdbc.url}" />

<property name = "JDBC.Username" value = "${jdbc.username}" />

<property name = "JDBC.Password" value = "${jdbc.password}" />

</dataSource>

</transactionManager>

3.6.<sqlMap></sqlMap>

<sqlMap></sqlMap>用于包括SQL Map映射文件和其他的SQL Map配置文件。每个SqlMapClient对象使用的SQL Map映射文件都需要在此声明。映射文件作为stream resource从类路径或URL读入。

4.SQL Map XML映射文件

4.1.MappendStatements

MappendStatements是SQL Map的核心，它的作用是维护一条<select | update | delete | insert>封装。比如说将一条<select>语句转换成JAVA类就是一个MappendStatements对象，使用sqlMap.getConfiguration.getMappendStatement(key)方法获取，key由命名空间+sql的ID组成。

sqlMap.getConfiguration.getMappendStatement("

//selectAuthorLinkedHashMap为sql的ID

org.apache.ibatis.domain.blog.mappers.AuthorMapper.selectAuthorLinkedHashMap

");

4.2.CDATA区域

在.xml文件中，一些特殊字符在SQL语句中无法使用，如 > 、< 等，解决这种问题的方法就是将含有特殊字符的语句放在CDATA区域中。

<![CDATA [

select * from test where id > 5; //将CDATA区域中的所有都进行转译

]]>

4.3.<selectKey></selectKey>

<selectKey>用于在插入一条数据成功之后，还需要获得其ID的情况下使用，所以经常配合<insert>语句使用。

<selectKey>有三个属性：1.order：AFTER | BEFORE,这个属性表示<selectKey>语句是在外层<select>语句前/后开始执行（AFTER适合用于自增主键，BEFORE适合用于非自增主键）;2.keyProperty对应的值为model（即insert语句返回的对象类型）中的ID，因为其和数据库中的ID是对应的；3.resultType的值就是主键的类型。

<selectKey>会将执行完的结果直接放入model中，用的时候只需调用对象名.get主键（）即可获取ID值。

<insert id = "insertAndGetkey" parameterType = "com.ibatis.User">

<selectKey order = "AFTER" keyProperty = "uId" resultType = "Integer">

select LAST_INSERT_ID; //LAST_INSERT_ID 是一个函数

</selectKey>

insert into t_user(username,password,create_date) values(#username#,#password#,#crateDate#);

</insert>

获取主键ID：

User user = new User();

user.setUsername("张三");

user.setPassword("123456");

user.setCreateDate(new Date);

int result = dao.insertAndGetkey(user); //result为insert语句执行的结果

System.out.println(user.getId()); //显示执行成功后被插入数据的ID

4.4.<procedure></procedure>

<procedure></procedure>支持存储过程。

<parameterMap id="awapParameters" calss="map">

<parameter property="em1" jdbcType="VARCHAR" javaType="String" mode="INOUT" />

<parameter property="em2" jdbcType="VARCHAR" javaType="String" mode="INOUT" />

</parameterMap>

<procedure id="swapEmailAddresses" parameterMap="awapParameters" >

{call swap_email_address (?,?) }

</procedure>

4.5.parameterClass & parameterMap

parameterClass的作用是指定参数类型的全限定名和优化框架性能。

parameterMap不常用，了解即可。

4.6.resultClass & resultMap

resultClass的作用是指定返回值的类型（JAVA类），它可以通过ResultSetMetaData将其自动映射到JDBC的ResultSet。

resultMap可以用于解决一对多的数据关系（如：用户表中一个用户拥有多个收货地址），resultMap是最为常用和最重要的属性之一。

<resultMap id="getSuerveyScopeDTO" class="com.tapic.claim.dto.SuerveyScopeDTO">

<result property="scopeId" column="scopeId" />

<result property="scopeName" column="scopeName" />

<result property="scopeAge" column="scopeAge" />

</resultMap>

<select id="surveyScope.search"parameterClass="SurveyScopeDTO"resultMap="getSurveyScopeDTO">

......

</select>

5.dynamic动态语句

动态SQL语句查询常用在组合查询中，它们的作用类似于JAVA的if-else等条件判断。

5.1.一元元素

5.2.二元元素

5.3.Iterator遍历元素

<update id="changeSurveyType" parameterClass="java.util.Map">

<![CDATA[

    update T_CLAIM_DUTY t

          set t.delete_flag = '0',t.update_time = sysdate,t.update_by = #updateBy:VARCHAR#

          where t.delete_flag = '1' and

          t.DEPARTMENT_CODE = #departmentCode:VARCHAR# and

          t.USER_TYPE = #userType:VARCHAR# and

          t.TRACK_USER_ID =#trickUserId:VARCHAR# and

          t.CLAIM_CASE_TYPE in

      ]]>

<iterator property="claimCaseTypeList" conjuction="," open="(" close=")" >

<![CDATA[ # claimCaseTypeList[] # ]]>

</iterator>

</update>

6.Ibatis常用方法

6.1.queryForObject

6.2.queryForList

6.3.insert

6.4.delete

6.5.update

iBatis 2.0