来源:TheAlchemist 链接:www.jianshu.com/p/1c7c7d1bba33
MyBatis作为一个轻量的SQL映射框架,确实很简单,但是知识点挺多,实际使用中还是会有时想不起来某个标签该怎么写,所以整理了这篇文章,以备查询。由于MyBatis如此简单,使得这一篇文章基本把实际使用中常碰到的事情都涵盖了,包括:
MyBatis的架构
在使用MyBatis的项目里,日志中往往会出现很多拼接SQL语句的log,这其实说明了MyBatis底层还是使用JDBC来实现的。在JDBC的基础上,为了性能考虑,所有的语句都是基于SqlSession。顾名思义,维护这个类的实例其实就是维护了一个对于某个数据库的连接的会话,在这个会话里可以有缓存啊什么之类的。
目前多数开发者还是会使用XML来进行MyBatis的配置,包括MyBatis的核心配置和SQL映射配置。其实和注解一样,XML本身只不过是一个元数据的载体,最终起作用的还是MyBatis的核心类。其中有这样几个比较重要的:
实际情况中MyBatis往往是在Spring的环境中使用的,MyBatis本身并不依赖Spring,但是使用Spring可以极大的提高开发效率,由于Spring进行了控制反转,所以其中MyBatis的初始化过程和正常过程稍稍有些不同:
MyBatis本身就是一个简单的ORM框架,提供了SQL语句到方法、关系型数据表到对象的映射。实际使用中与开发者相关的有两个东西:
MyBatis也可以使用注解来实现映射,对于简单的语句,使用注解可能会更加清晰简单,但是其真正强大的地方还是XML。
属性 | 描述 |
---|---|
id | 此命名空间内的标识符 |
parameterType | 参数的类的全名或者alias,可选。默认为空。 |
parameterMap | Deprecated |
resultType | 返回结果的类型全名或alias,如果结果是集合,此类型表示的是集合的成员类型。 |
resultMap | 使用指定的resultMap来映射结果集。resultMap 和 resultType只能二选一。 |
flushCache | 如果为true,每次调用,一级缓存和二级缓存都会回写。select语句中默认为false。 |
useCache | 如果为true,结果将在二级缓存中缓存。select语句中默认为true |
timeout | 设置超时,若超时则抛出异常。 |
fetchSize | 尝试在获取数据时分批获取。 |
statementType | STATEMENT,PREPARED或者CALLABLE. 分别对应JDBC中的Statement,PreparedStatement和CallableStatement respectively。默认PREPARED. |
resultSetType | FORWARD_ONLY,SCROLL_SENSITIVE或者SCROLL_INSENSITIVE。默认为空。 |
databaseId | 使用特定的databaseIdProvider |
resultOrdered | 嵌套查询时使用。 |
resultSets | 多返回集合时使用。 |
这3种语句的属性基本和上边select的一样,INSERT和UPDATE的语句有几个特殊的属性如下:
属性 | 描述 |
---|---|
useGeneratedKeys | 将使用JDBC的getGeneratedKeys方法来获取主键的值。默认为false。 |
keyProperty | 主键。MyBatis会将生成的主键赋给这个列。联合主键使用逗号隔开。 |
keyColumn | 特定数据库需要使用。 |
标签可以定义一段sql语句段,可以在其他语句中引入使用。sql标签可以包含参数。示例如下:
<sql id="userColumns">${alias}.id,${alias}.username,${alias}.password </sql> <select id="selectUsers" resultType="map"> select <include refid="userColumns"><property name="alias" value="t1"/></include>, <include refid="userColumns"><property name="alias" value="t2"/></include> from some_table t1 cross join some_table t2 </select>
参数(property)也可以在refid或者include进来的sql中使用。示例如下:
<sql id="sometable"> ${prefix}Table </sql> <sql id="someinclude"> from <include refid="${include_target}"/> </sql> <select id="select" resultType="map"> select field1, field2, field3 <include refid="someinclude"> <property name="prefix" value="Some"/> <property name="include_target" value="sometable"/> </include> </select>
什么地方都少不了这种小技巧,可以让你少打很多字。
<typeAlias type="com.someapp.model.User" alias="User"/>
6. ResultMap
官方文档上说这个特性是整个MyBatis中最强大的特性(没有之一)。其实它做的就是映射结果集。
MyBatis底层使用JDBC,所以查询出来的结果是ResultSet,如果resultType是一个对象,MyBatis底层就会创建一个resultMap,并根据字段名一一对应上这个对象。如果你有一个查询,它的结果集非常复杂,可以使用resultMap来做映射。
cache和cach-ref
使用cache标签在映射文件内(某命名空间内)实现二级缓存,其所有属性都有缺省值,所以单单一个标签就可以生效。cach-ref可以在两个映射文件之间共享缓存
<cache eviction="LRU"//缓存移除策略 flushInterval="60000"//默认不设置,不定时刷新 size="1024" readOnly="false"/>
条件判断,参数为test
多选一,参数为test
循环集合输出,可以循环数组,Iterable对象,或者Map,如果是Map,则index会是key。
<foreach item="item" index="index" collection="list" open="(" separator="," close=")"> #{item} </foreach>
5. bind
声明一个使用OGNL表达式生成的变量,在sql语句中使用。
--(完)喜欢就转发 --