深入浅出MyBatis：“映射器”全了解

本篇文章是「深入浅出MyBatis：技术原理与实践」书籍的总结笔记。

上一篇总结了MyBatis的配置，详细说明了各个配置项，其中提到了映射器，它是MyBatis最强大的工具，也是使用最多的工具。

通过映射器，可以很容易的进行数据的增删改查操作，我们抽象下进行这些操作的关键点：传递查询参数、组装各种场景下的查询条件、关联查询、将查询结果映射为Java Bean对象或集合等。另外，可以通过延迟加载、缓存提高数据查询的性能。

本篇就按照这个思路进行总结，首先列举下映射器的主要元素，每个元素提供的配置项和作用，然后重点介绍参数、结果映射、延迟加载、缓存、动态SQL等功能。

映射器的主要元素

映射器是由Java接口和XML文件（或注解）共同组成的，Java接口主要定义调用者接口，XML文件是配置映射器的核心文件，包括以下元素：

select 查询语句，可以自定义参数，返回结果集；

insert 插入语句，返回一个整数，表示插入的条数；

update 更新语句，返回一个整数，表示更新的条数；

delete 删除语句，返回一个整数，表示删除的条数；

sql 允许定义一部分SQL，然后再各个地方引用；

resultMap 用来描述从数据库结果集中来加载对象，还可以配置关联关系；

cache 给定命名空间的缓存配置；

增、删、改、查操作

查找

执行select语句前，需要定义参数，执行后，也提供了强大的映射规则或自动映射，将返回的结果集绑定到java bean中。

select元素有很多配置项，下面简单说明下：

paramterType：传入的参数类型，可以是基本类型、map、自定义的java bean；

resultType：返回的结果类型，可以是基本类型、自定义的java bean；

resultMap：它是最复杂的元素，可以配置映射规则、级联、typeHandler等，与ResultType不能同时存在；

flushCache：在调用SQL后，是否要求清空之前查询的本地缓存和二级缓存，主要用于更新缓存，默认为false；

useCache：启动二级缓存的开关，默认只会启动一级缓存；

timeout：设置超时参数，等超时的时候将抛出异常，单位为秒；

fetchSize：获取记录的总条数设定；

比如根据米聊号获取用户信息：

上一篇介绍配置时，有个设置项autoMappingBehavior，默认为自动映射没有定义嵌套结果集映射的结果集；还有设置项mapUnderscoreToCamelCase，设置为true时，会自动将以「下划线」命名的数据库字段名，自动映射为以「驼峰式」命名的POJO。

传递多个参数时，有3种方式：

使用Map参数；

使用注解方式传递；

使用java bean；

使用注解方式如下：

使用Map传递参数，会导致业务可读性丧失，导致以后扩展和维护不方便，不建议；如果参数个数5，建议使用JavaBean方式；

使用resultMap映射结果集，后面会单独介绍。

insert

属性和select大部分都相同， 说下3个不同的属性：

keyProperty：指定哪个列是主键，如果是联合主键可以用逗号隔开；

keyColumn：指定第几列是主键，不能和keyProperty共用；

useGeneratedKeys：是否使用自动增长，默认为false；

当useGeneratedKeys设为true时，在插入的时候，会回填Java Bean的id值，通过返回的对象可获取主键值。

如果想根据一些特殊关系设置主键的值，可以在insert标签内使用selectKey标签，比如：如果t_role没有记录，则需要设置为1，否则取最大id加2：

update和delete

比较简单，就不过多介绍了。

参数

上面已经介绍了参数传递，另外可以指定参数的类型去让对应的typeHandler处理它们。

还可以对一些数值型的参数设置其保存的精度

一般都是传递字符串，设置的参数#大部分情况下，会创建预编译语句，但有时候传递的是SQL语句本身，不是需要的参数，可以通过$符号表示，比如传递参数columns为”col1,col2,col3”，可以写成下面语句：

但要注意sql的安全性，防止sql注入。

sql元素

定义：

使用：

结果映射

元素介绍

resultMap是MyBatis里面最复杂的元素，它的作用是定义映射规则、级联的更新、定制类型转换器等。

由以下元素构成：

有的实体不存在没有参数的构造方法，需要使用constructor配置有参数的构造方法：

id指明主键列，result配置数据库字段和POJO属性的映射规则：

association、collection用于配置级联关系的，分别为一对一和一对多，实际中，多对多关系的应用不多，因为比较复杂，会用一对多的关系把它分解为双向关系。

discriminator用于这样一种场景：比如我们去体检，男和女的体检项目不同，如果让男生去检查妇科项目，是不合理的， 通过discriminator可以根据性别，返回不同的对象。

级联关系的配置比较多，就不在此演示了，可查看文档进行了解。

延迟加载

级联的优势是能够方便地获取数据，但有时不需要获取所有数据，这样会多执行几条SQL，性能下降，为了解决这个问题，需要使用延迟加载，只要使用相关级联数据时，才会发送SQL去取回数据。

在MyBatis的配置中有2个全局的参数 lazyLoadingEnabled 和 aggressiveLazyLoading ，第一个的含义是是否开启延迟加载功能，第二个的含义是对任意延迟加载属性的调用，会使延迟加载的对象完整加载，否则只会按需加载。

再理解下aggressiveLazyLoading属性，比如学生对象的关联对象如下：

当访问学生信息的时候，会根据鉴别器把健康的情况也会查找出来；当访问课程成绩的时候，同时也会把学生证信息查找出来，因为在默认情况下，MyBatis是按层级延迟加载的。 但这不是我们需要的，并不希望在访问成绩的时候，去加载学生证的信息，可以设置aggressiveLazyLoading为false，按需进行延迟加载数据。

上面的2个属性都是全局设置，也可以在association和collection元素上加上属性值fetchType，它有两个取值eager和lazy。

缓存

在没有显示配置缓存时，只开启一级缓存，一级缓存是相对于同一个SqlSession而言的，在参数和SQL完全一样的情况下，使用同一个SqlSession对象调用同一个Mapper的方法，只会执行一次SQL。

如果是不同的SqlSession对象，因为不同SqlSession是相互隔离的，即使用相同的Mapper、参数和方法，还是会再次发送SQL到数据库去执行。

二级缓存是SqlSessionFactory层面上的，需要进行显示配置，实现二级缓存的时候，要求POJO必须是可序列化的，只需要简单配置即可：

这样很多设置是默认的，有如下属性可以配置：

eviction：代表缓存回收策略，可选值有LRU最少使用、FIFO先进先出、SOFT软引用，WEAK弱引用；

flushInterval：刷新间隔时间，单位为毫秒，如果不配置，当SQL被执行时才会刷新缓存；

size：引用数目，代表缓存最多可以存储多少对象，不宜设置过大，设置过大会导致内存溢出；

readOnly：只读，意味着缓存数据只能读取不能修改；

动态SQL

很多时候，需要根据不同的场景组装查询条件，MyBatis提供对SQL语句动态的组装能力。

主要提供以下几种元素：

if：判断语句，但条件分支判断；

choose (when、otherwise)：多条件分支判断；

trim (where、set)：处理一些SQL拼装问题；

foreach：循环语句，在in语句等列举条件常用；

bind：通过OGNL表达式去自定义一个上下文变量，可以方便使用；

trim可以处理and和逗号拼接的问题，举例如下：

另外，可以使用set元素设置更新的字段列表：

下一篇会介绍MyBatis的解析和运行原理。

今天，公司发布新产品 MIX 2S