(点击
上方公众号
,可快速关注)
来源:TheAlchemist
链接:www.jianshu.com/p/1c7c7d1bba33
MyBatis作为一个轻量的SQL映射框架,确实很简单,但是知识点挺多,实际使用中还是会有时想不起来某个标签该怎么写,所以整理了这篇文章,以备查询。由于MyBatis如此简单,使得这一篇文章基本把实际使用中常碰到的事情都涵盖了,包括:
-
MyBatis中的一些概念
-
MyBatis包含的内容
-
SQL映射
-
动态SQL
一、 MyBatis中的一些概念
MyBatis的架构
1. MyBatis是个什么东西
在使用MyBatis的项目里,日志中往往会出现很多拼接SQL语句的log,这其实说明了MyBatis底层还是使用JDBC来实现的。在JDBC的基础上,为了性能考虑,所有的语句都是基于SqlSession。顾名思义,维护这个类的实例其实就是维护了一个对于某个数据库的连接的会话,在这个会话里可以有缓存啊什么之类的。
2. mapper接口是怎么映射成SQL语句的
目前多数开发者还是会使用XML来进行MyBatis的配置,包括MyBatis的核心配置和SQL映射配置。其实和注解一样,XML本身只不过是一个元数据的载体,最终起作用的还是MyBatis的核心类。其中有这样几个比较重要的:
-
SqlSessionFactoryBuilder,用来创建SqlSessionFactory的实例,之后就没有用了,其生命周期只是在初始化的时候有作用。
-
SqlSessionFactory,MyBatis最基础的类,用来创建会话(即SqlSession的实例),其生命周期与整个系统的生命周期相同,在系统运行的任何时候都可以使用它查询到当前数据库的配置信息等。
-
SqlSession,真正的和数据库之间的会话,线程不安全,所以其生命周期和使用它的线程相同。
-
各种Mapper,承载了实际的业务逻辑,其生命周期比较短,由SqlSession创建。
3. Spring环境中MyBatis的初始化过程
实际情况中MyBatis往往是在Spring的环境中使用的,MyBatis本身并不依赖Spring,但是使用Spring可以极大的提高开发效率,由于Spring进行了控制反转,所以其中MyBatis的初始化过程和正常过程稍稍有些不同:
-
Spring发现需要创建SqlSessionFactory实例,会在classpath下找到MyBatis的核心配置文件,使用它来初始化一个SqlSessionFactory实例。当然,这一步完全可以使用代码来完成,或者使用注解,就更加清晰明了。
-
往往mapper类也会作为bean注入到代码中去的,那么Spring会使用上一步中的SqlSessionFactory实例来创建SqlSession的实例。
-
然后再使用SqlSession尝试创建各个mapper对象。
-
于此同时,MyBatis会扫描classpath下的mapper映射XML文件(此路径可以自定义),对于每一个mapper接口,它的「类全名」会作为命名空间,来和映射文件中的mapper标签进行匹配。
-
对于每一个映射文件中的一个执行语句标签(如select、delete),MyBatis会把他们映射到SqlSession的方法上,创建mapper接口的一个实现类。
-
如果mapper接口和其映射文件一一匹配,则bean创建成功。
二、MyBatis包含的内容
MyBatis本身就是一个简单的ORM框架,提供了SQL语句到方法、关系型数据表到对象的映射。实际使用中与开发者相关的有两个东西:
-
MyBatis核心配置
缓存、数据源、日志等关系到MyBatis其本身行为的一些配置。
-
mapper接口的映射
针对于具体业务逻辑的SQL映射。
三、SQL映射
MyBatis也可以使用注解来实现映射,对于简单的语句,使用注解可能会更加清晰简单,但是其真正强大的地方还是XML。
1. select
属性
|
描述
|
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
|
多返回集合时使用。
|
2. 修改语句(insert,update,DELETE)
这3种语句的属性基本和上边select的一样,INSERT和UPDATE的语句有几个特殊的属性如下:
属性
|
描述
|
useGeneratedKeys
|
将使用JDBC的getGeneratedKeys方法来获取主键的值。默认为false。
|
keyProperty
|
主键。MyBatis会将生成的主键赋给这个列。联合主键使用逗号隔开。
|
keyColumn
|
特定数据库需要使用。
|
3. SQl语句段(sql标签)
标签可以定义一段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"