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数据源设置了一部分参数。
<!-- 使用JDBC事务管理器 --->
<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