MyBatis整体了解

背景资料

　　MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis ^[1]。

^[2]iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAO）

 

简介

　　MyBatis 是支持普通 SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。

　　MyBatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

　　每个MyBatis应用程序主要都是使用SqlSessionFactory实例的，一个SqlSessionFactory实例可以通过SqlSessionFactoryBuilder获得。SqlSessionFactoryBuilder可以从一个xml配置文件或者一个预定义的配置类的实例获得。

　　用xml文件构建SqlSessionFactory实例是非常简单的事情。推荐在这个配置中使用类路径资源（classpath resource)，但你可以使用任何Reader实例，包括用文件路径或file://开头的url创建的实例。MyBatis有一个实用类----Resources，它有很多方法，可以方便地从类路径及其它位置加载资源。

 

总体流程

(1)加载配置并初始化

触发条件：加载配置文件

将SQL的配置信息加载成为一个个MappedStatement对象（包括了传入参数映射配置、执行的SQL语句、结果映射配置），存储在内存中。

(2)接收调用请求

触发条件：调用Mybatis提供的API

传入参数：为SQL的ID和传入参数对象

处理过程：将请求传递给下层的请求处理层进行处理。

(3)处理操作请求 触发条件：API接口层传递请求过来

传入参数：为SQL的ID和传入参数对象

处理过程：

(A)根据SQL的ID查找对应的MappedStatement对象。

(B)根据传入参数对象解析MappedStatement对象，得到最终要执行的SQL和执行传入参数。

(C)获取数据库连接，根据得到的最终SQL语句和执行传入参数到数据库执行，并得到执行结果。

(D)根据MappedStatement对象中的结果映射配置对得到的执行结果进行转换处理，并得到最终的处理结果。

(E)释放连接资源。

(4)返回处理结果将最终的处理结果返回。

 

功能架构

功能架构讲解：

我们把Mybatis的功能架构分为三层：

(1)API接口层：提供给外部使用的接口API，开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。

(2)数据处理层：负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。

(3)基础支撑层：负责最基础的功能支撑，包括连接管理、事务管理、配置加载和缓存处理，这些都是共用的东西，将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑。

 

动态SQL（Dynamic SQL）编辑

MyBatis 最强大的特性之一就是它的动态语句功能。如果您以前有使用JDBC或者类似框架的
　　经历，您就会明白把SQL语句条件连接在一起是多么的痛苦，要确保不能忘记空格或者不要在
　　columns列后面省略一个逗号等。动态语句能够完全解决掉这些痛苦。
　　尽管与动态SQL一起工作不是在开一个party，但是MyBatis确实能通过在任何映射SQL语句中
　　使用强大的动态SQL来改进这些状况。
　　动态SQL元素对于任何使用过JSTL或者类似于XML之类的文本处理器的人来说，都是非常熟悉
　　的。在上一版本中，需要了解和学习非常多的元素，但在MyBatis 3 中有了许多的改进，现在只
　　剩下差不多二分之一的元素。MyBatis使用了基于强大的OGNL表达式来消除了大部分元素。

·if
　　· choose (when, otherwise)
　　· trim (where, set)
　　· foreach

if 元素

　　动态SQL 最常做的事就是有条件地包括where 子句。例如：
　　<select id=”findActiveBlogWithTitleLike”
　　parameterType=”Blog” resultType=”Blog”>
　　SELECT * FROM BLOG
　　WHERE state = ‘ACTIVE’

<if test=”title != null”>
　　AND title like #{title}
　　</if>
　　</select>

这条语句提供一个带功能性的可选的文字。如果您没有传入标题，那么将返回所有激活的
　　Blog。如果您传入了一个标题，那它就会查找与这个标题匹配的Blog（在这种情况下，您的参数
　　值可能需要包括任何masking或者通配符）。
　　如果我们想要可选地根据标题或者作者查询怎么办？首先，我把语句的名称稍稍改一下，使
　　得看起来更直观。然后简单地加上另外一个条件。
　　<select id=”findActiveBlogLike”
　　parameterType=”Blog” resultType=”Blog”>
　　SELECT * FROM BLOG WHERE state = ‘ACTIVE’
　　<if test=”title != null”>
　　AND title like #{title}
　　</if>
　　<if test=”author != null and author.name != null”>
　　AND title like #{author.name}
　　</if>
　　</select>

choose, when, otherwise 元素
　　有时候我们不想应用所有的条件，而是想从多个选项中选择一个。与java 中的switch 语句
　　相似，MyBatis 提供了一个choose 元素。
　　让我们继续使用上面的例子，但这次我们只搜索有提供查询标题的，或者只搜索有提供查询
　　作者的数据。如果两者都没有提供，那只返回加精的Blog (可能是管理员有选择性的查询，而不
　　是返回大量无意义的随机的Blog)。
　　<select id=”findActiveBlogLike”
　　parameterType=”Blog” resultType=”Blog”>
　　SELECT * FROM BLOG WHERE state = ‘ACTIVE’
　　<choose>
　　<when test=”title != null”>
　　AND title like #{title}
　　</when>
　　<when test=”author != null and author.name != null”>
　　AND title like #{author.name}
　　</when>
　　<otherwise>
　　AND featured = 1
　　</otherwise>
　　</choose>
　　</select>

trim, where, set 元素
　　考虑一下我们上面提到的‘if ’的例子中，如果现在我们把‘ACTIVE=1’也做为条件，会发
　　生什么情况。
　　<select id=”findActiveBlogLike”
　　parameterType=”Blog” resultType=”Blog”>
　　SELECT * FROM BLOG
　　WHERE
　　<if test=”state != null”>
　　state = #{state}
　　</if>
　　<if test=”title != null”>
　　AND title like #{title}
　　</if>
　　<if test=”author != null and author.name != null”>
　　AND title like #{author.name}
　　</if>
　　</select>
　　如果我们一个条件都不设置，会发生什么呢？语句最终可能会变成这个样子：
　　SELECT * FROM BLOG
　　WHERE
　　这将会执行失败。如果只有第二个条件满足呢？语句最终会变成这样：
　　SELECT * FROM BLOG
　　WHERE
　　AND title like ‘someTitle’

这同样会执行失败。这个问题仅用条件很难简单地解决，如果您已经这么写了，那您可能以
　　后永远都不想犯这样的错了。
　　MyBatis有个简单的方案能解决这里面90%的问题。如果where没有出现的时候，您可以自定一
　　个。修改一下，就能完全解决：
　　<select id=”findActiveBlogLike”
　　parameterType=”Blog” resultType=”Blog”>
　　SELECT * FROM BLOG
　　<where>
　　<if test=”state != null”>
　　state = #{state}
　　</if>
　　<if test=”title != null”>
　　AND title like #{title}
　　</if>
　　<if test=”author != null and author.name != null”>
　　AND title like #{author.name}
　　</if>

</where>
　　</select>
　　where 元素知道插入“where”如果它包含的标签中有内容返回的话。此外，如果返回的内容
　　以“AND” 或者“OR”开头，它会把“AND” 或者“OR”去掉。
　　如果where 元素的行为并没有完全按您想象的那样，您还可以使用trim 元素来自定义。例
　　如，下面的trim 与where 元素实现相同功能：
　　<trim prefix="WHERE" prefixOverrides="AND |OR ">
　　…
　　</trim>
　　overrides属性使用了管道分隔的文本列表来覆写，而且它的空白也不能忽略的。这样的结果
　　是移出了指定在overrides 属性里字符，而在开头插入prefix属性中指定的字符。

Foreach 元素
　　另一个动态SQL 经常使用到的功能是集合迭代，通常用在IN 条件句。例如：
　　<select id="selectPostIn" resultType="domain.blog.Post">
　　SELECT *
　　FROM POST P
　　WHERE ID in
　　<foreach item="item" index="index" collection="list"
　　open="(" separator="," close=")">
　　#{item}
　　</foreach>
　　</select>

foreach 元素非常强大，允许您指定一个集合，申明能够用在元素体内的项和索引变量。也
　　允许您指定开始和结束的字符，也可以加入一个分隔符到迭代器之间。这个元素的聪明之处在于
　　它不会意外地追加额外的分隔符。
　　􀃖 注意: 您可以把一个List 实例或者一个数组作为一个参数对象传递给MyBatis。如果您
　　这么做，MyBatis 会自动将它包装成一个Map，并以名字作为key。List 实例会以
　　“list”作为key，array 实例会以“ array” 作为key。