最近查找一个生产问题的原因，需要深入研究 ibatis 框架的源码。虽然最后证明问题的原因与 ibatis 无关，但是这个过程加深了对 ibatis 框架原理的理解。
这篇文章主要就来讲讲 ibatis 框架的原理。
可能现在很多人已不再使用 ibatis 或者说也没听 ibatis，不过肯定了解过 Mybatis。ibatis 就是 Mybatis框架的前身，虽然 ibatis 框架已经比较老，但是其核心功能与 Mybatis 一致。
ibatis 解决的痛点
我们先看一个使用 JDBC 查询的例子。
使用原生 JDBC 查询，存在两个痛点：
1. 使用非常繁琐，且需要处理各种数据库异常，并且还需要关闭各种资源。
2. 数据转化麻烦。查询之前需要从 Java 对象属性值设置到 PreparedStatement 中，查询返回之后又需要从 `ResultSet`获取返回设置到返回对象中。
在 ibatis 中封装这些繁杂数据库连接查询代码，并处理了各类异常以及关闭各种资源。另外 ibatis 自动处理 Java 对象与数据库类型之间的自动转化，让业务代码与 SQL 代码之间做到了解耦。
数据类型转化原理
数据类型转化主要分为两类，一，传入查询的 Java 对象数据转化成 SQL 类型数据。二 查询返回的数据库信息映射到 Java 对象中。
ibatis SQL 需要定义在配置文件中，一个查询 SQL 语句配置如下：
<select id="queryName" parameterClass="com.query.QueryDO" resultClass="com.query.QueryDO" >
select * from TEST_QUERY where ID=#id#
</select>ibatis 框架启动过程将会解析配置文件，生成 MappedStatement 的子类。如 select 配置会生成对应的 SelectStatement 对象。
MappedStatement 相关类图如下。
在 MappedStatement 中将会保存存在两个重要的对象，ParameterMap 与 ResultMap，通过这两个对象将会完成 Java 类型与数据库类型的相互转化。
Java 对象转化成数据库类型
以上面 select 配置为例，我们这里需要做的是从传入的 com.query.QueryDO 对象中获取属性值，然后通过 PreparedStatement.setxx 设置到查询参数中。
ibatis 解析配置中 SQL 语句时，将会获取 # 之间的内容，将其替换成 ?。然后按照顺序保存到一个 ParameterMapping[] 数组中，这个数组将会保存到 ParameterMap 对象中。
ParameterMapping 将会保存解析字段相关信息。
最终解析后的 SQL 为：
select * from TEST_QUERY where ID=?该 SQL 就可以通过 connection.prepareStatement("select * from TEST_QUERY where ID=?"); 生成 PreparedStatement 对象。
接着 ibatis 会根据 ParameterMapping 和 parameterClass 指定的类型创建合适的 dataExchange 和 parameterPlan 对象。
其中 parameterPlan 对象会按照 ParameterMapping 数组中顺序保存了变量的 setter 和 getter 方法数组。
dataExchange 会按照 ParameterMapping 数组中的顺序使用反射获取 parameterPlan getter 方法返回值生成 parameters 数组。
最后循环 ParameterMapping 数组，在 TypeHandler 调用 PreparedStatement.setxx 设置相关值。
TypeHandler 存在很多子类，通过这些子类正确处理了 Java 对象与数据库类型转化。
转化的时序图为：
时序图来源于：https://www.ibm.com/developerworks/cn/java/j-lo-ibatis-principle/index.html
数据库字段映射到 Java 对象
SQL 执行结束之后将会返回查询结果，这里将会使 SQL 查询结果转化为返回结果 com.query.QueryDO。这里需要用到上面提到 ResultMap 对象。
当 SQL 执行结束返回 ResultSet 对象之后，使用 ResultSet.getMetaData() 获取返回信息元数据对象 ResultSetMetaData 。
从 ResultSetMetaData 可以获取返回结果字段名，类型等信息，然后按照顺序存入 ResultMapping 数组中。
然后按照 ResultMapping 数组中使用 TypeHandler调用 ResultSet.getxx 获取实际返回数据，保存到 columnValues 数组中。
在 ResultMap 对象会根据 ResultMapping 与 resultClass指定的类型合适的 dataExchange 和 resultPlan对象。resultPlan对象与上面的 parameterPlan 对象一样也会保存着变量的 setter 和 getter 方法数组。
最后先根据 resultClass 反射生成返回对象，然后使用反射调用 resultPlan setter 方法，依次设置相关值。
映射返回对象时序图为：
时序图来源于：https://www.ibm.com/developerworks/cn/java/j-lo-ibatis-principle/index.html
ibatis 样板代码
上面讲完了 ibatis 数据类型的转化原理，接着我们来看下 ibatis 调用 JDBC 样板代码。
使用 ibatis 执行查询语句时，如 queryForObject ，调用到 SqlMapExecutorDelegate 。在 SqlMapExecutorDelegate 中将会会做一些前提准备，比如准备事务，最后会将 SQL 语句委托给 SqlExecutor 执行。
这里使用委托者模式，接受请求的对象将请求委托给另一个对象来处理。这种模式的优点在于解耦了业务代码与实际执行代码的联系，在于对外隐藏真正执行对象，易于扩展。
在 SqlExecutor#executeQuery 执行过程主要分为以下三步。
第一步，获取 PreparedStatement，使用 conn.prepareStatement(sql) 获取。
第二步调用 PreparedStatement.setxxx 方法设置参数。上文中的 Java 对象类型转化成 SQL 类型在这里完成。
第三步，调用 PreparedStatement.execute() 执行 SQL 语句。
第四步，使用 ResultSet 获取返回值，在这一步将会完成 数据库类型与 Java 类型的转化。
帮助链接
References
[1] 深入分析 iBATIS 框架之系统架构与映射原理: https://www.ibm.com/developerworks/cn/java/j-lo-ibatis-principle/index.html
End
如有收获，请帮忙转发，您的鼓励是作者最大的动力！
我是本周的小编「懿」，现在要隆重地告诉大家一个好消息，对于加入「Java极客技术」知识星球的同学提供基本的福利：
文章有疑问的地方可以提问，其他工作问题都可以提问出来，作者免费作答。
https://t.zsxq.com/Y3fYny7
每周都有大牛分享一些面试题，和面试注意的知识点！
https://t.zsxq.com/2bufE2v
每周由Java极客技术独家编制的设计模式与大家分享！
https://t.zsxq.com/3bUNbEI
每两周还会分享一个话题，和大家一起成长！
https://t.zsxq.com/BI6Unm2
还有Java极客技术团队亲自录制了一套 Spring Boot 视频，这套视频加密，加密后放到云盘上，下载链接加密之后，一机一码，每个星球的用户一个播放授权码。
我们做知识星球的目的和其他星主一样，就是为了帮助大家一起更好的成长，与高手拉近距离，减少差距，其实你也是高手！
前1000人，50元/每年，现在大约还剩407名额。
长按二维码
欢迎长按下图关注公众号Java极客技术，后台回复“资料”，获取作者独家秘制精品资料
Java 极客技术公众号，是由一群热爱 Java 开发的技术人组建成立，专注分享原创、高质量的 Java 文章。如果您觉得我们的文章还不错，请帮忙赞赏、在看、转发支持，鼓励我们分享出更好的文章。
1200
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
