MyBatis从入门到精通

 

本书中从一个简单的MyBatis查询入手，搭建起学习MyBatis的基础开发环境。通过全面的示例代码和测试讲解了在MyBatis XML方式和注解方式中进行增、删、改、查操作的基本用法，介绍了动态SQL在不同方面的应用以及在使用过程中的*实践方案。针对MyBatis高级映射、存储过程和类型处理器提供了丰富的示例，通过自下而上的方法使读者更好地理解和掌握MyBatis的高级用法，同时针对MyBatis的代码生成器提供了详细的配置介绍。此外，本书还提供了缓存配置、插件开发、Spring、Spring Boot集成的详细内容。*后通过介绍Git和GitHub让读者了解MyBatis开源项目，通过对MyBatis源码和测试用例的讲解让读者更好掌握MyBatis。

刘增辉，资深Java工程师，热爱技术研究，乐于分享心得，活跃于CSDN和开源中国网站。对MyBatis源码有着深入研究，同时热衷于开源项目，在GitHub和开源中国网站上发布了多个开源项目，是MyBatis官方推荐的分页插件PageHelper和通用Mapper的原作者，所发布项目受到了数千人的关注。博客：http://blog.csdn.net/isea533MyBatis技术网站：http://mybatis.tk

第1章 MyBatis入门 1
1.1 MyBatis简介 2
1.2 创建Maven项目 3
1.3　简单配置让MyBatis跑起来 7
1.3.1　准备数据库 8
1.3.2 配置MyBatis 8
1.3.3 创建实体类和Mapper.xml文件 10
1.3.4 配置Log4j以便查看MyBatis操作数据库的过程 11
1.3.5 编写测试代码让MyBatis跑起来 12
1.4 本章小结 14
第2章 MyBatis XML方式的基本用法 15
2.1 一个简单的权限控制需求 16
2.1.1 创建数据库表 16
2.1.2 创建实体类 19
2.2 使用XML方式 21
2.3 select用法 23
2.4 insert用法 35
2.4.1 简单的insert方法 35
2.4.2 使用JDBC方式返回主键自增的值 38
2.4.3 使用selectKey返回主键的值 40
2.5 update用法 42
2.6 delete用法 45
2.7 多个接口参数的用法 47
2.8 Mapper接口动态代理实现原理 50
2.9 本章小结 51
第3章 MyBatis注解方式的基本用法 53
3.1 @Select注解 54
3.1.1 使用mapUnderscoreToCamelCase配置 55
3.1.2 使用resultMap方式 55
3.2 @Insert注解 58
3.2.1 不需要返回主键 58
3.2.2 返回自增主键 58
3.2.3 返回非自增主键 59
3.3 @Update注解和@Delete注解 59
3.4 Provider注解 60
3.5 本章小结 61
第4章 MyBatis动态SQL 63
4.1 if用法 64
4.1.1 在WHERE条件中使用if 64
4.1.2 在UPDATE更新列中使用if 68
4.1.3 在INSERT动态插入列中使用if 70
4.2 choose用法 72
4.3 where、set、trim用法 75
4.3.1 where用法 75
4.3.2 set用法 76
4.3.3 trim用法 77
4.4 foreach用法 78
4.4.1 foreach实现in集合 78
4.4.2 foreach实现批量插入 81
4.4.3 foreach实现动态UPDATE 84
4.5 bind用法 86
4.6 多数据库支持 86
4.7 OGNL用法 89
4.8 本章小结 90
第5章 Mybatis代码生成器 91
5.1 XML配置详解 92
5.1.1 property标签 95
5.1.2 plugin标签 96
5.1.3 commentGenerator标签 97
5.1.4 jdbcConnection标签 99
5.1.5 javaTypeResolver标签 100
5.1.6 javaModelGenerator标签 101
5.1.7 sqlMapGenerator标签 102
5.1.8 javaClientGenerator标签 103
5.1.9 table标签 104
5.2 一个配置参考示例 109
5.3 运行MyBatis Generator 111
5.3.1 使用Java编写代码运行 111
5.3.2 从命令提示符运行 113
5.3.3 使用Maven Plugin运行 115
5.3.4 使用Eclipse插件运行 117
5.4 Example介绍 119
5.5 本章小结 124
第6章 MyBatis高级查询 125
6.1 高级结果映射 126
6.1.1 一对一映射 126
6.1.2 一对多映射 140
6.1.3 鉴别器映射 156
6.2 存储过程 159
6.2.1 个存储过程 162
6.2.2 第二个存储过程 164
6.2.3 第三个和第四个存储过程 166
6.2.4 在Oracle中使用游标参数的存储过程 168
6.3 使用枚举或其他对象 170
6.3.1 使用MyBatis提供的枚举处理器 170
6.3.2 使用自定义的类型处理器 172
6.3.3 对Java 8日期（JSR-310）的支持 175
6.4 本章小结 176
第7章 MyBatis缓存配置 177
7.1 一级缓存 178
7.2 二级缓存 181
7.2.1 配置二级缓存 181
7.2.2 使用二级缓存 184
7.3 集成EhCache缓存 187
7.4 集成Redis缓存 190
7.5 脏数据的产生和避免 191
7.6 二级缓存适用场景 194
7.7 本章小结 194
第8章 MyBatis插件开发 195
8.1 拦截器接口介绍 196
8.2 拦截器签名介绍 198
8.2.1 Executor接口 198
8.2.2 ParameterHandler接口 200
8.2.3 ResultSetHandler接口 201
8.2.4 StatementHandler接口 202
8.3 下画线键值转小写驼峰形式插件 203
8.4 分页插件 206
8.4.1 PageInterceptor拦截器类 207
8.4.2 Dialect接口 212
8.4.3 MySqlDialect实现 216
8.5 本章小结 220

第9章 Spring集成MyBatis 221
9.1 创建基本的Maven Web项目 222
9.2 集成Spring和Spring MVC 227
9.3 集成MyBatis 232
9.4 几个简单实例 234
9.4.1 基本准备 235
9.4.2 开发Mapper层（Dao层） 235
9.4.3 开发业务层（Service层） 238
9.4.4 开发控制层（Controller层） 240
9.4.5 开发视图层（View层） 242
9.4.6 部署和运行应用 245
9.5 本章小结 246
第10章 Spring Boot集成MyBatis 247
10.1 基本的Spring Boot项目 248
10.2 集成MyBatis 251
10.3 MyBatis Starter配置介绍 253
10.4 简单示例 255
10.4.1 引入simple依赖 255
10.4.2 开发业务（Service）层 258
10.4.3 开发控制（Controller）层 259
10.4.4 运行应用查看效果 259
10.5 本章小结 260
第11章 MyBatis开源项目 261
11.1 Git入门 262
11.1.1 初次运行配置 262
11.1.2 初始化和克隆仓库 263
11.1.3　本地操作 265
11.1.4 远程操作 267
11.2 GitHub入门 269
11.2.1 创建并提交到仓库 269
11.2.2 Fork仓库并克隆到本地 272
11.2.3 社交功能 275
11.3 MyBatis源码讲解 278
11.4 MyBatis测试用例 290
11.5 本章小结 293
附录 类型处理器（TypeHandler） 295

前言

自2013年起，我开始带领团队开发项目，公司此前使用的是一套深度集成的Spring、Struts和Hibernate框架，这套重量级框架显然已经不适合用在全新的项目中。当时使用的Hibernate还是较早的版本，在项目的业务层需要拼接大量的SQL和HQL才能进行数据库操作。综合多方面因素，我决定选择其他持久化框架进行项目开发。因为MyBatis SQL和代码分离的方式以及动态SQL的强大功能，加之其在对查询结果进行映射处理等方面具有显著优点，因此，我与MyBatis开始结缘。

为了提高查询效率，通常会采用物理分页，然而MyBatis只能支持内存分页。若想让MyBatis支持物理分页，只能通过基于拦截器的插件来实现。当时，已有的MyBatis分页插件都不适用于公司已经开发了大半的项目，因此我有了自己写一个分页插件的想法。完成后的分页插件（PageHelper）能很方便地实现对MyBatis查询方法的分页。后来，我在CSDN和开源中国的博客中分享了代码，并且详细说明了实现原理。在后续更新插件的一篇博客评论中，红薯（开源中国创始人）说：“应该把代码放到git.oschina.net中，放网盘很不专业哦！”因为这句话，我便踏入了开源的世界。

由于PageHelper分页插件有越来越多人使用，因而有很多网友通过留言、私信、邮件等方式和我讨论MyBatis的相关问题。为了解决网友的问题以及完善分页插件的功能，我深入学习了MyBatis的源码，通过不断的学习，不仅从深层次了解了各种问题的产生原因，对MyBatis的理解也逐渐加深。2014年11月，我利用闲暇时间又开发了一个新的开源项目：MyBatis通用Mapper，它实现了MyBatis单表增、删、改、查的基本方法，能够帮助开发人员节省大量时间。

这几年来，我一直在博客上面和大家分享MyBatis的相关内容，在这期间和网友交流解决的问题有很多是重复的，也有很多都是基础的。现在已有的MyBatis学习途径提供给大家的知识，有一些比较深奥不适合初学者，有一些比较基础却不全面。为了让读者比较容易地全面掌握MyBatis的相关知识，这本书得以诞生，本书将通过全面完整的大量示例，让读者轻松且全面地掌握MyBatis。

我和作者在开源中国社区上认识，源于我当时开源了Tiny开发框架
，我们就框架中的各个部分展开了热烈的讨论，作者也就框架的发展提出了大量有益的建议，做出非常大的贡献。后来了解到作者也开源了很多自己编写的项目，其中尤以MyBatis扩展组件PageHelper*为突出。作者是一位对技术十分执着的探索者，拥抱开源、乐于分享，将自己多年来在MyBatis领域的研究心得和实践经验汇集在了这本书中。本书由浅入深，引领新手快速入门，带领老手逐步精通，也能为精通者提供参考，是一本值得拥有的MyBatis专著。结识这样一位志同道合的朋友我感到非常荣幸，也希望大家通过本书结识他。

《企业级Java EE架构设计精深实践》作者、Tiny开源框架发起者，罗果

 

MyBatis的前身是iBATIS，它以接近JDBC的性能优雅地实现Java代码与SQL语句的分离，让开发者将数据操作专注点转移到SQL语句上，进而使代码维护变得更加容易。历经10多年的发展，MyBatis日臻成熟，现已成为Java持久化框架中的佼佼者被广泛应用。但是MyBatis也有一些不完美的地方，例如物理分页问题、缓存问题，对于这些问题，作者在本书中给出了自己的解决方案。本书通俗易懂，妙趣横生，通过实例全面深入讲解了MyBatis的关键技术，是MyBatis开发中一本不可多得的好书，在这里隆重推荐给各位读者！

互联网金融公司CTO，熔岩

 

“万物之始，大道至简，衍化至繁”！MyBatis正是循“至简之道”至今，须臾不离，方有今日的繁荣！放眼于Java框架丛林，十数载以来，无人问津者有之，而后放逐者有之，谩骂者有之，束之高阁者有之，恩泽九州者亦有之……窃以为，MyBatis当属“恩泽九州”者，何也？始终秉持“简单”这一设计理念；架构体系开放；外围插件百花齐放，这其中尤为突出者当属作者的PageHelper。PageHelper经刘兄数载打磨，已广泛应用于诸多项目。得知刘兄MyBatis新作历经持续打磨即将面世，甚为欣喜。刘兄是PageHelper的铸造者，也是国内MyBatis方面不争的权威专家，强烈建议大家持卷品读！

资深Java开发工程师，杨新伦