Spring Boot干货系列：（九）数据存储篇-SQL关系型数据库之MyBatis的使用

前言

上篇我们介绍了Spring Boot对传统JdbcTemplate的集成，这次换一下，介绍下Spring Boot中如何集成MyBatis。这里分别介绍注解方式以及XML方式的整合。喜欢哪种方式自己选择。

正文

项目框架还是跟上一篇一样使用Spring Boot的ace后端模板，你可以基于它来跟着博主一起来调整代码，如果没看过上一篇，那就下载本篇源码研究吧。跟上篇一样先添加基础的依赖和数据源。

添加依赖

这里需要添加mybatis-spring-boot-starter依赖跟mysql依赖

这里不引入spring-boot-starter-jdbc依赖，是由于mybatis-spring-boot-starter中已经包含了此依赖。博主开始整理的时候发现

mybatis-spring-boot-starter

有新版本了，这里就集成最新的，匹配Spring Boot1.5版本。


MyBatis-Spring-Boot-Starter依赖将会提供如下：
自动检测现有的DataSource

将创建并注册SqlSessionFactory的实例，该实例使用SqlSessionFactoryBean将该DataSource作为输入进行传递

将创建并注册从SqlSessionFactory中获取的SqlSessionTemplate的实例。

自动扫描您的mappers，将它们链接到SqlSessionTemplate并将其注册到Spring上下文，以便将它们注入到您的bean中。

就是说，使用了该Starter之后，只需要定义一个DataSource即可（application.properties中可配置），它会自动创建使用该DataSource的SqlSessionFactoryBean以及SqlSessionTemplate。会自动扫描你的Mappers，连接到SqlSessionTemplate，并注册到Spring上下文中。

数据源配置

在src/main/resources/application.properties中配置数据源信息。

自定义数据源

spring-boo
4000
t-starter-jdbc 默认使用tomcat-jdbc数据源，如果你想使用其他的数据源，比如这里使用了阿里巴巴的数据池管理,你应该额外添加以下依赖：

修改Application.java

ok这样就算自己配置了一个DataSource，Spring Boot会智能地选择我们自己配置的这个DataSource实例。

脚本初始化

注解方式跟XML配置方式共同的模块编码

不管是注解方式还是XML配置的方式，以下代码模块都是一样的

实体对象

Controller层

controller代码太多了，这里就只截取部分方法，具体的可以下载源码查看

Service层

实现类

Mybatis集成

接下来，我们分别来介绍下注解方式以及XML配置方式。

方案一：注解方式

Mybatis注解的方式好简单，只要定义一个dao接口，然后sql语句通过注解写在接口方法上。最后给这个接口添加@Mapper注解或者在启动类上添加@MapperScan("com.dudu.dao")注解都行。如下：



需要注意的是，简单的语句只需要使用@Insert、@Update、@Delete、@Select这4个注解即可，但是有些复杂点需要动态SQL语句，就比如上面方法中根据查询条件是否有值来动态添加sql的，就需要使用@InsertProvider、@UpdateProvider、@DeleteProvider、@SelectProvider等注解。这些可选的 SQL 注解允许你指定一个类名和一个方法在执行时来返回运行 允许创建动态 的 SQL。 基于执行的映射语句, MyBatis 会实例化这个类,然后执行由 provider 指定的方法. 该方法可以有选择地接受参数对象.(In MyBatis 3.4 or later, it's allow multiple parameters) 属性: type,method。type 属性是类。method 属性是方法名。 注意: 这节之后是对 类的 讨论,它可以帮助你以干净,容于阅读 的方式来构建动态 SQL。

方案二：XML配置方式

xml配置方式保持映射文件的老传统，优化主要体现在不需要实现dao的是实现层，系统会自动根据方法名在映射文件中找对应的sql，具体操作如下：编写Dao层的代码
新建LearnMapper接口，无需具体实现类。


修改application.properties 配置文件


添加LearnMapper的映射文件
在src/main/resources目录下新建一个mapper目录，在mapper目录下新建LearnMapper.xml文件。通过mapper标签中的namespace属性指定对应的dao映射，这里指向LearnMapper。


更多mybatis数据访问操作的使用请参考：mybatis官方中文参考文档

分页插件

上面我有使用到物理分页插件pagehelper，用法还算简单，配置如下
pom.xml中添加依赖


然后你只需在查询list之前使用PageHelper.startPage(int pageNum, int pageSize)方法即可。pageNum是第几页，pageSize是每页多少条。


分页插件PageHelper项目地址： https://github.com/pagehelper/Mybatis-PageHelper最终项目效果如下,增删改查分页一个都不少：

总结

到此为止，Spring Boot与Mybatis的初步整合就完成了，项目不仅整合了bootstrap模板框架，还包含了登录、拦截器、日志框架logback等前面介绍的功能。麻雀虽小，五脏俱全。想要查看更多Spring Boot干货教程,可前往：Spring Boot干货系列总纲

源码下载

(￣︶￣)↗[相关示例完整代码]chapter9==》Spring Boot干货系列：（九）数据存储篇-SQL关系型数据库之MyBatis-注解方式

chapter9-2==》Spring Boot干货系列：（九）数据存储篇-SQL关系型数据库之MyBatis-XML配置方式

想要ace模板源码的话，在博主公众号回复关键字：ace一直觉得自己写的不是技术，而是情怀，一篇篇文章是自己这一路走来的痕迹。靠专业技能的成功是最具可复制性的，希望我的这条路能让你少走弯路，希望我能帮你抹去知识的蒙尘，希望我能帮你理清知识的脉络，希望未来技术之巅上有你也有我,希望大爷你看完打赏点零花钱给我。博主最近发起了《嘟爷电子书互惠组》计划，里面包含了Spring Boot相关书籍在内的至少60多本Java相关的电子书，也有博主花钱买的电子书哦
有时间可以看看，文章最下面有介绍: Java后端2017书单推荐http://tengj.top/2017/04/20/javabook/