7. Spring Boot 与MyBatis集成

Spring Boot 与MyBatis集成

在我们日常的开发过程中，肯定不可避免的会使用到数据库以及 SQL 语句。比如，刚开始学习 Java 的时候可能会遇到 JDBC，它是连接 Java 和数据库的桥梁，我们可以使用 JDBC 来建立与数据库之间的连接并且执行相应的 SQL 语句。虽然 JDBC 的执行效率很高，但是其开发效率比较低。正是如此，市面上出现了一大批 ORM（对象关系映射）框架，例如 Hibernate，iBATIS 以及本文将要介绍的 MyBatis。

MyBatis 简介

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。它避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。因为 MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs (Plain Old Java Objects，普通的 Java 对象)映射成数据库中的记录。
通俗地说，MyBatis 就是我们使用 Java 程序操作数据库时的一种工具，可以简化我们使用 JDBC 时的很多操作，而且还简化了数据库记录与 POJO 之间的映射方式。

为什么要使用 MyBatis

前文提到过，目前市面上 有很多的 ORM 框架，例如 Hibernate，iBATIS 以及 Spring 全家桶的 Spring Data JPA。那么我们为什么要使用 MyBatis 呢？因为使用 MyBatis 有以下优势：

1. 可以简化我们操作数据库的步骤。
2. 相对 Hibernate 来说学习成本较低，Hibernate 还需要学习其 HQL 查询规范。
3. 使用相对广泛。

前提条件

本文将使用开源的数据库连接池 DBCP（DataBase Connection Pool）连接 MySQL 数据库，并在此基础上整合 MyBatis 以及 MyBatis Plus，进而讲解如何使用 MyBatis 和 MyBatis Plus 操作数据库。所以在开始本教程的阅读之前，需要如下准备：
1. 一个 Spring Boot 的 Web 项目，你可以通过 Spring Initializr 页面 生成一个空的 Spring Boot 项目，当然也可以下载 springboot-pom.xml 文件 ，然后使用 Maven 构建一个 Spring Boot 项目。
2. 安装 MySQL 数据库或者一台 MySQL 服务器。

使用 DBCP 连接池

DBCP 数据库连接池是 Apache 上的一个 Java 连接池项目，也是 Tomcat 使用的连接池组件。由于建立数据库连接是一种非常耗时、耗资源的行为，所以通过连接池预先同数据库建立一些连接，放在内存中，应用程序需要建立数据库连接时直接到连接池中申请一个就行，使用完毕后再归还到连接池中。

添加相关依赖

这一步很简单，只需要在 pom.xml 中添加清单 1 的内容即可。

1. 添加相关依赖

<!--连接驱动-->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>6.0.6</version>
    <scope>runtime</scope>
</dependency>

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-dbcp2</artifactId>
   <version>2.5.0</version>
< /dependency>

配置数据源

添加好依赖后，我们需要做的就是配置我们的数据源。首先我们需要在配置文件中添加数据源相关的配置项的值，下面清单代码只给出了部分项，完整内容可以查看 本文源码 ：

2. 数据源配置文件配置项

# 基本属性
spring:
  datasource:
    dbcp2:
      url: jdbc:mysql://localhost:3306/spring_tutorial?serverTimezone=GMT%2B8amp;characterEncoding=utf-8
      username: root
      password: 123456
      driver-class-name: com.mysql.jdbc.Driver

添加好配置项后，我们在 cn.itweknow.sb-mybatis.config 包下新建了 DataSourceConfiguration 类，它是数据源的配置类，其内容如下，可以看到在这个类里面我们配置了数据源。

3. 数据源配置

@Configuration
@ConditionalOnProperty(name = "spring.datasource.dbcp2.url", matchIfMissing = false)
@MapperScan(value = { "cn.itweknow.sbmybatis.mapper" }, sqlSessionFactoryRef = "sqlSessionFactory")
public class DataSourceConfiguration {

    @Bean(name = "dataSource")
    @ConfigurationProperties(prefix = "spring.datasource.dbcp2")
    public DataSource dataSource() {
        return new BasicDataSource();
    }

}

到这一步，如果我们能够正常启动项目就意味着我们的连接池配置成功了。

集成 MyBatis

下面我们来了解如何在 Spring Boot 项目中配置 MyBatis。只需要三大步骤就可以完成这个配置。第一步是添加依赖包，第二步是配置数据库事务和会话工厂，最后一步就是配置 Mapper 的路径。

添加 MyBatis 相关依赖包

我们只需要在 pom.xml 文件的 标签下添加如下内容即可。

清单 4. 添加 MyBatis 依赖包

<!--mybatis-->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId