iBATIS学习01：iBATIS概览+iBATIS十分钟快速上手操练

iBATIS概览+iBATIS十分钟快速上手操练

【iBATIS概览】

iBATIS是一个持久框架，可用来配置 Java 类的属性和 RDBMS 内的表列之间的映射。在配置时，此框架负责处理 JDBC 连接和分配。可以使用 XML 文件配置 iBATIS。

iBATIS 主要的设计目的是为了让我们执行 SQL 时对输入输出的数据管理更加方便，所以如何方便的让我们写出 SQL 和方便的获取 SQL 的执行结果才是 iBATIS 的核心竞争力。
iBATIS 通过 SQL Map 将 Java 对象两者结合映射成 一条SQL 语句，反过来也可将结果集转化成 Java 对象，与其他 ORM 框架相比，它不但解决了 Java 对象与输入参数的映射、java对象和结果集的映射，而且还让用户方便的手写使用 SQL 语句。
在iBATIS中，SqlMapSession 负责创建数据库的连接（即要想获得Connection，得先取得SqlMapSession对象），包括对事务的管理（SqlMapSession中已经设置了事务管理器）（ 图示），iBATIS 对管理事务既可以自己管理也可以由外部管理，iBATIS 自己管理是通过共享 SqlMapSession 对象实现的，多个 Statement 的执行时共享一个 SqlMapSession 实例，而且都是线程安全的。如果是外部程序管理就要自己控制 SqlMapSession 对象的生命周期。
iBATIS中关于sql语句说明：
1：iBATIS 会把 SqlMap 配置文件解析成一个个 Statement，其中每一个Statement包括 ParameterMap、ResultMap，以及解析后的 SQL对象。
2：ibatis 中的sql语句和标准的 SQL 语句不同的是，参数的赋值是“#“包裹的变量名。如何解析这个变量就是 iBATIS 要完成的工作。当然 SQL 的表达形式还有很多其他的形式如动态 SQL 等。iBATIS 会根据“#”分隔符取出合法的变量名并依此来构建参数对象数组，数组的顺序就是 SQL 中变量出现的顺序。
iBATIS的数据映射流程：
1：组合运行时SQL语句的流程
a) 当 iBATIS 构建好 RequestScope 执行环境后，根据Statement中的SQL语句，解析出其中参数，并按参数出现的顺序保存在ParameterMap对象中。接着 iBATIS 会根据SQL中的变量和 parameterClass 指定的类型创建合适的 DataExchange 和 parameterPlan 对象。parameterPlan 对象中按照前面的顺序保存了变量的 setter 和 getter 方法列表。
b) 用合适的数据交换类DataExchange,用它来根据前面解析的ParameterMap，用ParameterPlan中的getter方法利用反射获取传递过来的JAVA对象的相应属性值组装成参数实参数组，这个数组的顺序就是对应于 SQL 中参数的顺序。
c) 根据返回的实参数组调用对应的类型处理器（TypeHandler）用返回的实参数组来调用 preparedStatement.setXXX(i, parameter) 提交参数到PrepareStatement对象，并执行该preparedStatement语句。
2：结果集转换成JAVA对象的流程
a) 根据ResquestScope对象获取执行结果ResultMap对象。
b) 根据目标JAVA对象获取其所有可写的属性数组（含有setter方法的），然后根据返回的ResultSet中的列名和获取到的属性数组做一个匹配，形成一个映射列表resultMappingList。
c) 选择 DataExchange 类型、AccessPlan 类型为后面的真正的数据交换提供支持。
d) 根据resultMappingList中每个属性的值选择合适的类型处理器（TypeHandler）,并调用该处理器到ResultSet中获取到对应的结果值。处理完resultMappingList后，相应的结果值保存在一个columnValues数组中，这个数组的顺序就是 SQL 中对应列名的顺序。
e) 通过DataExchange来调用AccessPlan中对应字段的setter方法利用反射将属性值设置到JAVA对象的相应属性中。并返回java对象。
总体来说 iBATIS 的系统结构还是比较简单的，它主要完成两件事情：
a) 根据 JDBC 规范建立与数据库的连接
b) 通过反射打通 Java 对象与数据库参数交互之间相互转化关系

【iBATIS十分钟快速上手教程】

1:准备ibatis环境
搭建环境：导入相关包：（数据库的驱动包，ibatis的包）
ibatis相关包：ibatis.jar
配置文件
jdbc连接属性文件（文本文件）
包含driver,url,username,password四项内容即可
iBATIS的总配置文件（xml文件：一般文件名约定为SqlMapConfig.xml）
<sqlMapConfig>
<properties resource="前面配置的数据库文件地址"/>
<transactionMamager type="JDBC">
<dataSource type="SIMPLE">
<property value="${driver}" name="JDBC.Driver">
...
</dataSource>
</transactionMamager>
<sqlMap resource="Student.xml"/>
...
</sqlMapConfig>
每个实体的映射(map)文件（XML文件）:映射实体和数据库表,对应实体的sql语句可以写在这个配置文件的<sqlMap>标签中。区别于Hibernate的配置文件，里面没有字段映射，因为ibatis是基于sql语句的。
程序中读取配置文件方式
Reader reader = com.ibatis.common.resources.Resources.getResourceAsReader("ibatis的总配置文件")；
private static SqlMapClient sqlMapClient = com .ibatis.sqlmap.client.SqlClientBuilder.buildSqlMapClient(reader);
reader.close();
ibatis中的CRUD操作可以借助于SqlMapClient的queryForObject、queryForList、insert、delete、update等方法实现，这些方法通过传入sql语句的id值来调用写在配置文件中的sql语句完成操作。
2:查询所有对象（用select标签，用sqlMapClient的queryForList方法）
typealias:[注意：定义了别名之后，后面在标签中就可以直接使用别名了。]
<typealias alias="Student" type="package1.package2.Student">
select:
<select id="sql语句id" resultClass="返回类型[如果是集合就是集合元素的类型]" parameterClass="参数类型">
sql语句
</select>
e.g: <select id="selectAllStudents" resultClass="Student">
select * from Student
</select>

3：查询指定id的对象（用select标签，用sqlMapClient的queryForObject方法）
e.g：<select id="selectStudent" resultClass="Student" parameterClass="int">
select * from student where  sid=#sid# (#夹在中间表示占位符)
</select>

4:插入一个实体对象（用insert标签，用sqlMapClient的insert方法）
e.g：<insert id="insertStudent"  parameterClass="Student"> 
insert into Student(id,name) values （#id#,#name# [注意：顺序必须和前面对应，且必须和对象的属性字段的get方法对应，而且是赋给前面对应的位置的变量。]）
</insert>

5：删除指定ID的对象（用delete标签，用sqlMapClient的delete方法）
e.g：<delete id="deleteStudent"  parameterClass="int"> 
delete from student where id=#id# [注意：此时的#id#中的id仅仅是占位符，可以随便写比如#sid#]
</delete>

6：修改实体对象（用update标签，用sqlMapClient的update方法）[默认修改除了主键之外的所有字段都会更改，和hibernate一样。]
e.g：<update id="updateStudent"  parameterClass="Student[此处不区分大小写]"> 
update student set name = #name# where id=#id# 
</update>

7:模糊查询实体（用select标签，用sqlMapClient的select方法）
[注意：ibatis中的是sql语句，语句指向表名而不是类名，区别于Hibernate中的hql。]
e.g:<select id="selectStudentByName" parameterClass="String" resultClass="Student">
select id ,name where name like  '%$name$%' [注意：模糊查询用的$符号！]
</select>

8：主键生成
e.g:MySql会自增
e.g:Oracle
<insert id="insertStudentBySequence" parameterClass="Student">
<selectKey resultClass="int" keyProperty="id[注意：赋给对象的那个字段]">
select 序列.nextVal from 虚表
</selectKey>
insert into Student(id,name) values （#id#,#name#)
</insert>
[注意：ibatis会调用类的无参构造方法，所以，对JavaBean的最优实践就是都添加一个无参构造方法]

9：ibatis优缺点总结
优点
简单
减少代码量
是对JDBC的包装，无需自己开启事务等
架构级性能增强
sql语句与程序代码分离
简化项目分工
增强了移植性
缺点：
Sql语句自己写
调用的时候，参数数量只能一个。


参考资料：：https://www.ibm.com/developerworks/cn/java/j-lo-ibatis-principle/