Spring Boot与MyBatis：你真的了解这对黄金搭档吗？

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

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

前言

在如今的开发世界中，Spring Boot和MyBatis几乎是“黄金搭档”的代名词。你可能已经在项目中使用过Spring Boot来构建应用，或者是用MyBatis来处理数据库操作，但你是否真正理解它们是如何协同工作的呢？今天，我们就来聊聊如何将Spring Boot和MyBatis结合，如何高效地进行数据持久化操作以及如何解决那些看似复杂的查询问题！📊🚀

目录 📑

1. 🧠 MyBatis的简介与使用
   • MyBatis是什么？
   • 为什么选择MyBatis？
2. ⚙️ 配置MyBatis与Spring Boot集成
   • 集成Spring Boot与MyBatis的步骤
   • 配置数据库连接
3. 📜 创建Mapper接口与XML配置
   • 如何创建Mapper接口
   • XML配置与SQL映射
4. 🔍 动态SQL与复杂查询
   • 动态SQL的使用
   • 复杂查询的实现技巧

1. 🧠 MyBatis的简介与使用

MyBatis是什么？

MyBatis 是一款流行的持久层框架，它支持自定义SQL、存储过程以及高级映射。与JPA（Java Persistence API）不同，MyBatis 更加灵活，能够让你直接编写SQL语句，完全掌控数据库查询操作。因此，MyBatis特别适合那些需要复杂SQL查询的场景。

• 灵活性：可以完全控制SQL语句，手写SQL，或使用XML映射文件，适合业务复杂的项目。
• 高性能：通过SQL的优化与直接查询，性能可以得到较好的控制。
• 支持存储过程：MyBatis也支持存储过程，能够方便地与复杂的数据库操作打交道。

为什么选择MyBatis？

在很多情况下，ORM框架（如Hibernate）对开发人员提供了很多便利，但有时这种“方便”会限制你对SQL的控制，尤其是在面对复杂查询和性能优化时。而MyBatis则通过允许开发者编写原生SQL，避免了Hibernate中SQL的抽象化，使开发人员能够对每个查询都进行精确控制。

• 灵活性高：完全自定义SQL。
• 适合复杂查询：能够处理复杂的JOIN、子查询等情况，甚至是存储过程。
• 性能可控：开发者能够针对每个查询进行优化，避免了ORM框架中对SQL的过度抽象。

2. ⚙️ 配置MyBatis与Spring Boot集成

集成Spring Boot与MyBatis的步骤

在Spring Boot中集成MyBatis其实非常简单。通过一些基本的配置和注解，我们就能让MyBatis工作起来。接下来，我们一起看一下如何在Spring Boot项目中集成MyBatis。

1. 添加依赖

首先，在你的pom.xml文件中添加MyBatis和Spring Boot的相关依赖：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- Spring Boot Starter Data JPA (可选) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    
    <!-- MyBatis Starter -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>

    <!-- 数据库连接池与驱动 (以H2为例，可替换为其他数据库) -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2. 配置 application.properties

然后，配置数据库连接信息和MyBatis相关配置：

# 数据库连接配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password

# MyBatis配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.demo.model

配置数据库连接

你可以在application.properties中配置各种数据库连接属性，包括数据库类型、URL、用户名、密码等，Spring Boot 会自动帮你配置数据源。你只需指定合适的数据库驱动和连接信息即可。

3. 📜 创建Mapper接口与XML配置

如何创建Mapper接口

在MyBatis中，所有的数据库操作都会通过一个接口（Mapper）来实现。首先，我们需要创建一个Mapper接口，用于定义所有的数据库操作方法。

package com.example.demo.mapper;

import com.example.demo.model.User;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;

@Mapper
public interface UserMapper {
    // 查询所有用户
    List<User> findAllUsers();

    // 根据id查询用户
    User findUserById(int id);
    
    // 插入用户
    void insertUser(User user);
}

XML配置与SQL映射

每个Mapper接口的方法都需要与SQL映射文件对应。在MyBatis中，SQL语句通常写在一个XML文件中，这样可以更清晰地管理SQL和映射。

首先，创建一个XML映射文件UserMapper.xml，并在其中编写SQL语句：

<?xml version="1.0" encoding="UTF-8"?>
<mapper namespace="com.example.demo.mapper.UserMapper">
    
    <!-- 查询所有用户 -->
    <select id="findAllUsers" resultType="com.example.demo.model.User">
        SELECT * FROM users;
    </select>

    <!-- 根据ID查询用户 -->
    <select id="findUserById" resultType="com.example.demo.model.User">
        SELECT * FROM users WHERE id = #{id};
    </select>

    <!-- 插入用户 -->
    <insert id="insertUser" parameterType="com.example.demo.model.User">
        INSERT INTO users (name, email) VALUES (#{name}, #{email});
    </insert>

</mapper>

配置扫描路径

确保在application.properties中配置了正确的Mapper路径，或者在主类中通过注解配置扫描路径：

@SpringBootApplication
@MapperScan("com.example.demo.mapper") // 扫描Mapper接口
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

4. 🔍 动态SQL与复杂查询

动态SQL的使用

在实际开发中，很多查询是动态的，意思是查询条件可能会根据用户的需求或其他因素发生变化。MyBatis提供了强大的动态SQL功能，通过<if>, <choose>, <trim>, <where>等标签，我们可以动态构建SQL语句。

动态查询示例：

<select id="findUsersByCondition" resultType="com.example.demo.model.User">
    SELECT * FROM users
    <where>
        <if test="name != null">AND name = #{name}</if>
        <if test="email != null">AND email = #{email}</if>
    </where>
</select>

这里，我们使用<if>标签来判断name和email是否为空。如果它们不为空，就把相应的查询条件加到SQL语句中。

复杂查询的实现技巧

当查询变得复杂时，通常需要使用JOIN操作、子查询等。MyBatis完全支持这些操作，可以帮助你处理复杂的数据库查询。下面是一个使用JOIN的查询示例：

<select id="findUsersWithOrders" resultType="com.example.demo.model.User">
    SELECT u.id, u.name, u.email, o.id AS order_id, o.amount
    FROM users u
    LEFT JOIN orders o ON u.id = o.user_id
    WHERE u.name = #{name}
</select>

这个查询会返回一个用户及其相关的订单信息，使用LEFT JOIN来获取所有符合条件的用户，即使他们没有任何订单。

结语：Spring Boot与MyBatis，灵活与高效并存！🔧🚀

通过今天的分享，我们不仅仅了解了如何在Spring Boot中集成MyBatis，还深入探讨了如何使用Mapper接口和XML配置实现灵活的数据持久化操作。MyBatis提供了强大的动态SQL支持，能让我们高效地进行复杂查询，尤其适合那些需要直接操控SQL的场景。

无论是简洁的增删改查，还是复杂的多表连接查询，Spring Boot与MyBatis的结合都会让你轻松应对。如果你还没有在项目中使用过这对“黄金搭档”，赶紧试试吧！💡

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学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-