一文带你读懂mybatis中的通用 Mapper

感兴趣可以看看书单：

附Java/C/C++/机器学习/算法与数据结构/前端/安卓/Python/程序员必读书籍书单大全：

书单导航页（点击右侧 极客侠栈 即可打开个人博客）：极客侠栈
①【Java】学习之路吐血整理技术书从入门到进阶最全50+本（珍藏版)
②【算法数据结构+acm】从入门到进阶吐血整理书单50+本（珍藏版)
③【数据库】从入门到进阶必读18本技术书籍网盘吐血整理网盘(珍藏版)
④【Web前端】从HTML到JS到AJAX到HTTP从框架到全栈帮你走更少弯路(珍藏版)   
⑤【python】书最全已整理好（从入门到进阶）(珍藏版)

⑥【机器学习】+python整理技术书（从入门到进阶已经整理好）（珍藏版）
⑦【C语言】推荐书籍从入门到进阶带你走上大牛之路（珍藏版）
⑧【安卓】入门到进阶推荐书籍整理pdf书单整理（珍藏版）

⑨【架构师】之路史诗级必读书单吐血整理四个维度系列80+本书(珍藏版)

⑩【C++】吐血整理推荐书单从入门到进阶成神之路100+本(珍藏)

⑪【ios】IOS书单从入门到进阶吐血整理(珍藏版)

-------------华丽分割线------------------

 

一、通用 Mapper 的用途 ?

我个人最早用 MyBatis 时，先是完全手写，然后用上了 MyBatis 代码生成器（简称为 MBG），在使用 MBG 过程中，发现一个很麻烦的问题，如果数据库字段变化很频繁，就需要反复重新生成代码，并且由于 MBG 覆盖生成代码和追加方式生成 XML，导致每次重新生成都需要大量的比对修改。除了这个问题外，还有一个问题，仅仅基础的增删改查等方法，就已经产生了大量的 XML 内容，还没有添加一个自己手写的方法，代码可能就已经几百行了，内容多，看着比较碍事。

因为很多人都在使用 MBG，MBG 中定义了很多常用的单表方法，为了解决前面提到的问题，也为了兼容 MBG 的方法避免项目重构太多，在 MBG 的基础上结合了部分 JPA 注解产生了通用 Mapper。通用 Mapper 可以很简单的让你获取基础的单表方法，也很方便扩展通用方法。使用通用 Mapper 可以极大的提高你的工作效率。
 

二、快速入门

为了让你更快速的了解通用 Mapper 的优势，这里会更简洁的让你了解整个过程。

首先在 Maven 项目的 pom.xml 中添加通用 Mapper 依赖：

接下来，开始具体的使用。

1. 配置实体类

通过 MBG 配合 专用代码生成器 可以直接生成实体类等基础代码，为了避免信息量过大，这里当作手工编写和配置。

有如下类：

在上面类中，我们给主键添加了 @Id，标记该字段为数据库主键。还有一个通用 Mapper 的特殊注解 @KeySql，配置的 useGeneratedKeys = true 和 MyBatis 中的 useGeneratedKeys 含义相同，意思是说使用 JDBC 的方式获取数据库自增的主键值。

经过上面简单的配置后，相当于就有了 MyBatis 中的  关系映射了，特别注意，这个映射关系只对通用 Mapper 有效，自己手写方法时，需要自己处理映射关系。

2. 创建 Mapper 接口

根据上述实体类，创建对应的 CountryMapper 接口如下：

这里继承了 tk.mybatis.mapper.common.Mapper 接口，在接口上指定了泛型类型 Country。当你继承了 Mapper 接口后，此时就已经有了针对 Country 的大量方法，方法如下：

这些方法中和 MBG 生成的大部分方法都一致，还有一部分 MBG 之外的常用方法。

3. 配置通用 Mapper

为了让上述方法可以直接使用，还需要配置通用 Mapper，让项目在启动的时候，把上述方法都自动生成好，这样在运行时就可以使用上面所有的方法。

根据不同的开发环境，需要不同的配置方式，完整的内容可以 集成通用 Mapper，我们这里以最常见的 Spring 和 MyBatis 集成为例。

在集成 Spring 的环境中使用 MyBatis 接口方式时，需要配置 MapperScannerConfigurer，在这种情况下使用通用 Mapper，只需要修改配置如下：

注意官方的包名和这里 tk 包名的区别：

1.tk.mybatis.spring.mapper.MapperScannerConfigurer
2.org.mybatis.spring.mapper.MapperScannerConfigurer
只有第一部分从 org 换成了 tk。

此时通用 Mapper 最简单的配置就完成了，完整的配置可以看这里 和 Spring 集成。

4. 简单使用

下面是一个简单的测试用例，实际使用中，可以直接注入 CountryMapper。

该测试完整地址：Spring 集成测试用例

通用 Mapper 只是提供了基础的大量方法，遇到没有的方法时，你可以正常按照 MyBatis 的用法手写，和正常用法没有任何区别。

5. 了解更多

上面的简单的介绍已经可以应用到真正的项目中了，但是有很多细节这里都没有涉及，如果你准备加入通用 Mapper，你可以先按上述内容引入项目，然后通过更详细的文档去了解更多的细节，有很多你可能想要但是 MBG 不存在的方法，在这里都有，而且如果你想实现自己的通用方法，可以很轻松的进行扩展。