阅读本文约需要5分钟
大家好，我是你们的导师，我每天都会在这里给大家分享一些干货内容(当然了，周末也要允许老师休息一下哈)。上次老师跟大家分享了Spring Boot 中的AOP处理，今天给大家分享下Spring Boot 中集成 MyBatis。
MyBatis 介绍
大家都知道，MyBatis 框架是一个持久层框架，是 Apache 下的顶级项目。Mybatis 可以让开发者把主要精力放在 SQL 上，通过 Mybatis 提供的映射方式，自由灵活地生成满足需要的 SQL 语句。使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs 映射成数据库中的记录，在国内可谓是占据了半壁江山。
本文给大家讲解 Spring Boot 集成 MyBatis 的两种方式，重点讲解基于注解的方式。该方式更为简洁，省去了很多 XML 的配置过程，所以在实际项目中也较常使用。当然这也不是绝对的，有些项目组中也在使用 XML 方式。
MyBatis 的配置
1. 依赖导入
Spring Boot 集成 MyBatis，需要导入 mybatis-spring-boot-starter 和 MySQL 的依赖，这里我们使用的版本是 1.3.2，代码如下：
我们点开 mybatis-spring-boot-starter 依赖，可以看到很多之前使用过、较为熟悉的依赖，就像课程开始介绍的那样，Spring Boot 致力于简化编码，使用 starter 系列将相关依赖集成在一起，开发者不需要关注繁琐的配置，非常方便。
2. properties.yml 配置
我们再来看一下，集成 MyBatis 时需要在 properties.yml 配置文件中做哪些基本配置，代码如下：
我们简单介绍下上面这些配置。数据库的相关配置，这里就不详细解说了，相信大家已经非常熟练了，主要是配置用户名、密码、数据库连接等，本文使用的连接池是 Spring Boot 自带的 Hikari，感兴趣的朋友可以去百度或者谷歌搜索，了解一下。
这里着重说明一下 map-underscore-to-camel-case:true， 它用来开启驼峰命名规范，比较好用，比如数据库中字段名为 user_name， 那么在实体类中定义名为 userName 的属性，甚至是 username，都会自动匹配到驼峰属性。如果不这样配置，当字段名和属性名不同时，就无法实现映射。
基于 XML 的整合
使用原始的 XML 方式，需要新建 UserMapper.xml 文件。在上面的 application.yml 配置文件中，我们已经定义了 XML 文件的路径：classpath:mapper/*.xml，接下来我们在 resources 目录下新建一个 mapper 文件夹，然后创建一个 UserMapper.xml 文件。
这和整合 Spring 一样，namespace 中指定的是对应的 Mapper， 中指定对应的实体类，即 User，在内部指定表的字段和实体的属性相对应即可。这里我们写一个根据用户名查询用户的 SQL。
实体类中有 id、username 和 password，我不在这贴代码，大家可以下载源码查看。UserMapper.java 文件中写一个接口即可：
User getUserByName(String username);
中间省略了 service 的代码，我们写一个 Controller 来测试一下：
这里需要注意一下：Spring Boot 是如何知道这个 Mapper 的呢？一种方法是在 mapper 层对应的类上添加 @Mapper 注解即可，但这种方法有个弊端，当我们有很多个 mapper 时，每一个类上都得添加 @Mapper 注解。另一种比较简便的方法是在 Spring Boot 启动类上添加 @MaperScan 注解，用来扫描某个包下的所有 mapper。代码如下：
这样的话，com.itcodai.course10.dao 包下的所有 mapper 都会被扫描到了。
基于注解的整合
基于注解的整合就不需要 XML 配置文件了，MyBatis 主要提供了 @Select 、@Insert、@Update、Delete 四个注解。这四个注解用得比较多，也很简单，注解后面跟上对应的 SQL 语句即可，我们举个例子：
这与 XML 文件中写 SQL 语句是一样的，不再需要 XML 文件。有人可能会问，如果是两个参数呢？两个参数的话，我们需要使用 @Param 注解来指定每一个参数的对应关系，如下：
可以看出，@Param 指定的参数要和 SQL 中 #{} 取的参数名相同，不同则取不到。可以在 Controller 中自行测试一下，接口都在源码中，文章中就不再粘贴测试代码和结果了。
有个问题请大家注意：表字段设计完成后，我们多会使用自动生成工具生成实体类，这时实体类的名称要与表字段的名称相对应，最起码也要符合驼峰对应。上面实例中，我们在配置文件中开启了驼峰的配置，所以字段都能很好地相对应。万一有对不上的呢？我们也有解决办法，即使用 @Results 注解。
@Results 中的 @Result 注解用来指定每一个属性和字段的对应关系，这样就解决了该问题。
当然，我们也可以将 XML 和注解结合使用，实际项目中也多采用混用的方式。因为有时采用 XML 方式方便，有时候则使用注解方式更方便，比如上面这个问题，如果我们定义了上面的 UserMapper.xml，则完全可以使用 @ResultMap 注解来替代 @Results 注解，如下：
@ResultMap 注解中的值来自哪里呢？对应的是 UserMapper.xml 文件中 的 id 属性值，如下：
XML 和注解结合使用的情况很常见，借助自动生成工具生成 XML 文件，更是减少了大量的代码，也省去了人为手动输入。
总结
本文系统讲解了 Spring Boot 集成 MyBatis 的过程，主要分为基于 XML 和基于注解两种形式。通过实际配置详细说明了 Spring Boot 中 MyBatis 的使用方式，及常见问题的解决方案，有很强的实战意义。在实际项目中，建议根据实际情况确定使用哪种方式，XML 和注解都可使用。
