Springboot 整合 Mybatis 的完整 Web 案例

摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载，保留摘要，谢谢！

原文：https://www.bysocket.com/?p=1610

推荐一本书《腾讯传》。

Spring Boot 系列文章：《Spring Boot 那些事》
新年第一篇 Springboot 技术文诞生。泥瓦匠准备写写 Springboot 相关最佳实践。一方面总结下一些 Springboot 相关，一方面和大家交流交流 Springboot 框架。

现在业界互联网流行的数据操作层框架 Mybatis，下面详解下 Springboot 如何整合 Mybatis ，这边没有使用 Mybatis Annotation 这种，是使用 xml 配置 SQL。因为我觉得 SQL 和业务代码应该隔离，方便和 DBA 校对 SQL。二者 XML 对较长的 SQL 比较清晰。

一、运行 springboot-mybatis 工程

git clone 下载工程 springboot-learning-example ，项目地址见
GitHub。下面开始运行工程步骤（Quick Start）：
1.数据库准备
a.创建数据库 springbootdb：

b.创建表 city ：(因为我喜欢徒步)

c.插入数据

2. 项目结构介绍
项目结构如下图所示：



org.spring.springboot.controller - Controller 层
org.spring.springboot.dao - 数据操作层 DAO
org.spring.springboot.domain - 实体类
org.spring.springboot.service - 业务逻辑层
Application - 应用启动类
application.properties - 应用配置文件，应用启动会自动读取配置

3.改数据库配置
打开 application.properties 文件， 修改相应的数据源配置，比如数据源地址、账号、密码等。（如果不是用 MySQL，自行添加连接驱动 pom，然后修改驱动名配置。）
4.编译工程
在项目根目录 springboot-learning-example，运行 maven 指令：

5.运行工程

右键运行 Application 应用启动类的 main 函数，然后在浏览器访问：

可以看到返回的 JSON 结果：

如图：

二、springboot-mybatis 工程配置详解

1.pom 添加 Mybatis 依赖

mybatis-spring-boot-starter 工程依赖如图：




整个工程的 pom.xml:

2.在 application.properties 应用配置文件，增加 Mybatis 相关配置

mybatis.typeAliasesPackage 配置为 org.spring.springboot.domain，指向实体类包路径。mybatis.mapperLocations 配置为 classpath 路径下 mapper 包下，* 代表会扫描所有 xml 文件。
mybatis 其他配置相关详解如下：

mybatis.config = mybatis 配置文件名称
mybatis.mapperLocations = mapper xml 文件地址

mybatis.typeAliasesPackage = 实体类包路径
mybatis.typeHandlersPackage = type handlers 处理器包路径
mybatis.check-config-location = 检查 mybatis 配置是否存在，一般命名为 mybatis-config.xml

mybatis.executorType = 执行模式。默认是 SIMPLE

3.在 Application 应用启动类添加注解 MapperScan
Application.java 代码如下：

mapper 接口类扫描包配置注解 MapperScan ：用这个注解可以注册 Mybatis mapper 接口类。
4.添加相应的 City domain类、CityDao mapper接口类

City.java:

CityDao.java:

其他不明白的，可以 git clone 下载工程 springboot-learning-example ，工程代码注解很详细。
https://github.com/JeffLi1993/springboot-learning-example。

三、其他

利用 Mybatis-generator自动生成代码 http://www.cnblogs.com/yjmyzz/p/4210554.html
Mybatis 通用 Mapper3 https://github.com/abel533/Mapper Mybatis 分页插件 PageHelper https://github.com/pagehelper/Mybatis-PageHelper
最后，推荐阅读：《 Spring Boot 之 HelloWorld 详解》