Spring Boot 中的 MyBatis 集成 —— 让数据库操作变得简单又高效！

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

@TOC

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

前言 ✨

嘿，亲爱的朋友们！今天我们来聊聊 Spring Boot 中的 MyBatis 集成。你是否曾经为数据库操作写过一大堆复杂的 SQL 语句，心想能不能有个简单高效的解决方案呢？别担心，MyBatis 就是你需要的工具！而且，结合 Spring Boot 这对黄金搭档，简直是打怪升级的绝配！

在这篇文章中，我会带你一起走进 MyBatis 的世界，看看如何把它和 Spring Boot 搭配使用，让你的数据库操作变得又快又爽！当然，理论讲解和实际操作都不会少。为了让你更清楚理解，我还会提供一些具体的演示案例。准备好了吗？让我们一起开始吧！

📖 目录

1. 什么是 MyBatis？ 🤔
2. Spring Boot 和 MyBatis 的优势 ⚡
3. 如何将 MyBatis 集成到 Spring Boot 中 🛠️
4. 配置文件详解 📝
5. 创建 DAO 和 Mapper 文件 💻
6. 演示案例：增、删、改、查的实现 📊
7. 常见问题与解决方案 ⚠️
8. 总结 🎉

1. 什么是 MyBatis？ 🤔

MyBatis 是一个流行的 Java 持久层框架，它通过映射数据库操作与 Java 对象之间的关系来简化数据库访问。与传统的 JDBC 相比，MyBatis 提供了一个更加高效和灵活的方式来执行 SQL 操作。MyBatis 的核心思想是将 SQL 映射到 Java 对象，让我们可以通过自定义 SQL 来执行数据库查询、插入、更新和删除操作。

相比 JPA 和 Hibernate，MyBatis 并不是全自动化的 ORM 框架，它不像 JPA 那样自动生成 SQL。相反，它允许开发者手动编写 SQL 语句，提供了更高的灵活性。对于那些需要复杂 SQL 查询、数据库操作频繁且精细控制的应用，MyBatis 是一个非常适合的选择。

MyBatis 特点：

• 灵活性：你可以完全控制 SQL，支持写复杂的查询逻辑。
• 性能：由于没有复杂的 ORM 映射，所以性能上比全自动化的 ORM 更有优势。
• 易用性：MyBatis 提供了简洁的接口和 XML 配置文件，使得开发者容易上手。

2. Spring Boot 和 MyBatis 的优势 ⚡

在现代开发中，Spring Boot 和 MyBatis 是两大常见的技术栈。Spring Boot 提供了快速开发的环境，而 MyBatis 则让数据库操作变得更简单、更高效。

为什么选择 Spring Boot 和 MyBatis 组合？

• 自动配置：Spring Boot 的自动配置机制非常强大，它能根据你添加的依赖自动配置相关服务。而且，Spring Boot 提供的默认配置基本能满足绝大多数项目需求，极大减少了配置的复杂度。

• 扩展性强：MyBatis 让你可以非常方便地控制 SQL 执行，避免了 ORM 框架给你带来的“不透明”操作。Spring Boot 通过插件和配置文件，可以轻松支持 MyBatis 的各种需求，包括事务管理、连接池配置等。

• 开发效率高：Spring Boot 可以帮助我们快速搭建 Web 应用，而 MyBatis 提供的简单映射操作方式，使得数据库交互变得清晰、简洁，开发效率大大提高。

通过将 Spring Boot 和 MyBatis 结合使用，我们可以在快速开发的同时，享受到数据库操作的灵活性，完美满足业务需求。

3. 如何将 MyBatis 集成到 Spring Boot 中 🛠️

接下来，让我们进入最激动人心的部分：实际操作！集成 MyBatis 到 Spring Boot 中并不复杂，关键是理解配置过程和如何进行数据访问。

步骤一：创建 Spring Boot 项目

首先，我们可以通过 Spring Initializr 创建一个新的 Spring Boot 项目。在 Dependencies 选项中，选择：

• Spring Web：让你可以创建 RESTful API。
• MyBatis Framework：集成 MyBatis 框架。
• MySQL Driver：如果你使用的是 MySQL 数据库。
• Spring Data JPA：如果你还计划使用 JPA。

生成项目后，解压并打开 IDE，你就可以开始配置和编码了。

步骤二：添加 MyBatis 依赖

在 pom.xml 文件中添加 MyBatis 的依赖：

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

步骤三：配置数据源

在 application.yml 或 application.properties 文件中配置数据库连接信息：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydatabase
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 10
  mybatis:
    mapper-locations: classpath:mapper/*.xml
    type-aliases-package: com.example.demo.model

其中：

• spring.datasource：配置数据库连接相关信息。
• spring.mybatis.mapper-locations：指定 MyBatis 的 Mapper 文件位置。
• spring.mybatis.type-aliases-package：指定实体类的包路径。

4. 配置文件详解 📝

在配置过程中，我们要特别注意以下几个方面：

• 数据源配置：确保数据库 URL、用户名、密码配置正确。
• Mapper 配置：MyBatis 默认从 classpath:mapper/ 目录加载 Mapper 文件。如果文件放在其他位置，记得调整路径。
• Type Aliases 配置：这个配置可以让 MyBatis 自动识别 Java 类，避免每次都写全类名。

小贴士：

• 在开发中，mybatis-spring-boot-starter 提供了非常方便的自动配置功能，可以大大简化 MyBatis 的集成过程。你只需要关注 SQL 和映射文件的编写，Spring Boot 会自动为你配置其他相关组件。

5. 创建 DAO 和 Mapper 文件 💻

创建实体类

让我们从简单的 User 实体类开始：

package com.example.demo.model;

public class User {
    private Integer id;
    private String name;
    private Integer age;

    // getters and setters
}

创建 Mapper 接口

接下来，创建一个 Mapper 接口，通过注解来定义 SQL 语句：

package com.example.demo.mapper;

import com.example.demo.model.User;
import org.apache.ibatis.annotations.Select;

public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User findById(Integer id);
}

创建 Mapper XML 文件

如果你偏向使用 XML 来定义 SQL，以下是一个例子：

<mapper namespace="com.example.demo.mapper.UserMapper">
    <select id="findById" resultType="com.example.demo.model.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

在这个配置中，我们定义了一个 findById 的 SQL 查询，查询用户表中 ID 对应的记录。

6. 演示案例：增、删、改、查的实现 📊

查询

@Autowired
private UserMapper userMapper;

public User getUserById(Integer id) {
    return userMapper.findById(id);
}

插入

@Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
void insertUser(User user);

更新

@Update("UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}")
void updateUser(User user);

删除

@Delete("DELETE FROM user WHERE id = #{id}")
void deleteUser(Integer id);

这些操作使用了 MyBatis 的注解方式，简单且易于理解。当然，你也可以通过 XML 文件来编写 SQL，这取决于你的编码习惯。

7. 常见问题与解决方案 ⚠️

1. Mapper 文件没有生效：确保 Mapper 文件放在了正确的目录下，且路径在配置文件中正确指明。
2. SQL 映射错误：检查 SQL 语法是否正确，特别是参数绑定部分。
3. 数据库连接失败：确认数据库 URL、用户名和密码配置正确，且数据库服务处于启动状态。

8. 总结 🎉

到这里，我们已经完成了从零开始将 MyBatis 集成到 Spring Boot 中的全过程！是不是觉得简单又有趣呢？😎 通过 MyBatis，我们可以非常方便地执行各种数据库操作，结合 Spring Boot 提供的自动配置，我们只需要关注核心业务逻辑，大大提高了开发效率。

总结一下：

• MyBatis 是一个非常灵活且高效的持久层框架。
• Spring Boot 提供了极简的配置方式，帮助我们快速搭建应用。
• 两者结合，让你在快速开发的同时，享受 SQL 操作的自由。

通过本文的案例，你应该能清晰地理解如何将 MyBatis 集成到 Spring Boot 中，并开始在实际项目中使用它。希望你能够灵活运用这个工具，让开发过程更加高效、愉快！别忘了，代码是用来让你享受开发乐趣的哦！🚀

希望这篇文章对你有所帮助！喜欢的话请分享给更多的开发者朋友吧！😄

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-