MyBatis 完全使用指南

来源:TheAlchemist 链接:www.jianshu.com/p/1c7c7d1bba33

MyBatis作为一个轻量的SQL映射框架,确实很简单,但是知识点挺多,实际使用中还是会有时想不起来某个标签该怎么写,所以整理了这篇文章,以备查询。由于MyBatis如此简单,使得这一篇文章基本把实际使用中常碰到的事情都涵盖了,包括:

  1. MyBatis中的一些概念
  2. MyBatis包含的内容
  3. SQL映射
  4. 动态SQL

一、 MyBatis中的一些概念

MyBatis的架构

1. MyBatis是个什么东西

在使用MyBatis的项目里,日志中往往会出现很多拼接SQL语句的log,这其实说明了MyBatis底层还是使用JDBC来实现的。在JDBC的基础上,为了性能考虑,所有的语句都是基于SqlSession。顾名思义,维护这个类的实例其实就是维护了一个对于某个数据库的连接的会话,在这个会话里可以有缓存啊什么之类的。

2. mapper接口是怎么映射成SQL语句的

目前多数开发者还是会使用XML来进行MyBatis的配置,包括MyBatis的核心配置和SQL映射配置。其实和注解一样,XML本身只不过是一个元数据的载体,最终起作用的还是MyBatis的核心类。其中有这样几个比较重要的:

  1. SqlSessionFactoryBuilder,用来创建SqlSessionFactory的实例,之后就没有用了,其生命周期只是在初始化的时候有作用。
  2. SqlSessionFactory,MyBatis最基础的类,用来创建会话(即SqlSession的实例),其生命周期与整个系统的生命周期相同,在系统运行的任何时候都可以使用它查询到当前数据库的配置信息等。
  3. SqlSession,真正的和数据库之间的会话,线程不安全,所以其生命周期和使用它的线程相同。
  4. 各种Mapper,承载了实际的业务逻辑,其生命周期比较短,由SqlSession创建。

3. Spring环境中MyBatis的初始化过程

实际情况中MyBatis往往是在Spring的环境中使用的,MyBatis本身并不依赖Spring,但是使用Spring可以极大的提高开发效率,由于Spring进行了控制反转,所以其中MyBatis的初始化过程和正常过程稍稍有些不同:

  1. Spring发现需要创建SqlSessionFactory实例,会在classpath下找到MyBatis的核心配置文件,使用它来初始化一个SqlSessionFactory实例。当然,这一步完全可以使用代码来完成,或者使用注解,就更加清晰明了。
  2. 往往mapper类也会作为bean注入到代码中去的,那么Spring会使用上一步中的SqlSessionFactory实例来创建SqlSession的实例。
  3. 然后再使用SqlSession尝试创建各个mapper对象。
  4. 于此同时,MyBatis会扫描classpath下的mapper映射XML文件(此路径可以自定义),对于每一个mapper接口,它的「类全名」会作为命名空间,来和映射文件中的mapper标签进行匹配。
  5. 对于每一个映射文件中的一个执行语句标签(如select、delete),MyBatis会把他们映射到SqlSession的方法上,创建mapper接口的一个实现类。
  6. 如果mapper接口和其映射文件一一匹配,则bean创建成功。

二、MyBatis包含的内容

MyBatis本身就是一个简单的ORM框架,提供了SQL语句到方法、关系型数据表到对象的映射。实际使用中与开发者相关的有两个东西:

  1. MyBatis核心配置 缓存、数据源、日志等关系到MyBatis其本身行为的一些配置。
  2. 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" value="sometable"/> </include> </select>

4. #{}和${}的区别

  1. #{}在底层实现上使用?做占位符来生成PreparedStatement,然后将参数传入,大多数情况都应使用这个,它更快、更安全。
  2. ${}将传入的数据直接显示生成在sql中。如:order by ${user_id},如果传入的值是111,那么解析成sql时的值为order by 111, 如果传入的值是id,则解析成的sql为order by id.

5. 类型别名

什么地方都少不了这种小技巧,可以让你少打很多字。

<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"/>

四、动态SQL

1. if

条件判断,参数为test

2. choose (嵌套when,otherwise)

多选一,参数为test

3. trim (where,set)

  • trim标签可以定制其他标签,并且去头去尾;
  • where标签会自动生成where语句,并且可以去除头部的and或者or;
  • set标签可以自动生成set语句,并且可以去除尾部的逗号。

4. foreach

循环集合输出,可以循环数组,Iterable对象,或者Map,如果是Map,则index会是key。

<foreach item="item" index="index" collection="list" open="(" separator="," close=")"> #{item} </foreach>

5. bind

声明一个使用OGNL表达式生成的变量,在sql语句中使用。

--(完)喜欢就转发 --

原文发布于微信公众号 - java思维导图(java-mindmap)

原文发表时间:2018-09-04

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Java帮帮-微信公众号-技术文章全总结

Mybatis框架复习大纲【面试+提高】

Mybatis框架复习大纲【面试+提高】 1.MyBatis面试题汇总 1.1 JDBC编程有哪些不足之处,MyBatis是如何解决这些问题的? ① 数据库链...

56370
来自专栏学习力

《Java从入门到放弃》JavaSE入门篇:JDBC(入门版)

20090
来自专栏蓝天

strerror线程安全分析

答案是NO,但它有个线程安全的版本:strerror_r。借助Linux的man,即可看到详情:

17530
来自专栏JavaQ

高并发编程-CyclicBarrier深入解析

CyclicBarrier是一个同步辅助类,它允许一组线程互相等待,直到所有线程都到达某个公共屏障点(也可以叫同步点),即相互等待的线程都完成调用await方法...

1.3K30
来自专栏FreeBuf

恶意程序分析利器PowerShellArsenal

简介 PowerShellArsenal是一个PowerShell模块,它的功能是帮助逆向工程师来分析.NET恶意软件,PowerShellArsenal的功能...

27290
来自专栏木木玲

Netty 源码解析 ——— 服务端启动流程 (上)

31160
来自专栏闻道于事

JFinal极速开发框架使用笔记

记录第一次使用JFinal,从简单的框架搭建到增删改查,从自带的方法到正常框架习惯的使用方式。  JFinal官网:http://www.jfinal.com/...

55470
来自专栏菩提树下的杨过

基于spring boot 2.x的websocket示例

spring boot 2/spring 5自带了websocket,下面是最基本的示例(包括java服务端、java客户端以及js客户端)

66420
来自专栏orientlu

FreeRTOS 任务调度 任务创建

FreeRTOS 的任务调度在 Source/include/task.c 中实现,包含了任务的创建、切换、挂起、延时和删除等所有功能。涉及到的链表组织见文章 ...

44440
来自专栏全栈架构

Elasticsearch Java API 索引的增删改查(二)

Index API 允许我们存储一个JSON格式的文档,使数据可以被搜索。文档通过index、type、id唯一确定。我们可以自己提供一个id,或者也使用Ind...

40310

扫码关注云+社区

领取腾讯云代金券