首页
/ 正文

mybatis spring（长文解析）

更新时间: 2025-03-18 12:19:17

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

在 Java 后端开发领域，持久层框架的选择直接影响着项目的开发效率和代码质量。MyBatis 和 Spring 框架作为两个广泛使用的工具，它们的结合（即 MyBatis-Spring）为开发者提供了一种高效、灵活且易于维护的解决方案。本文将从基础概念出发，逐步讲解如何将 MyBatis 与 Spring 整合，并通过实际案例演示其核心功能。无论是编程初学者还是有一定经验的开发者，都能通过本文快速掌握这一技术栈的核心要点。

一、MyBatis 和 Spring 的核心特性与整合必要性

1.1 MyBatis：灵活的 SQL 映射工具

MyBatis 是一个基于 Java 的持久层框架，它通过将 SQL 语句与 Java 对象进行映射，简化了数据库操作的复杂度。与传统的 ORM（对象关系映射）框架（如 Hibernate）不同，MyBatis 保留了对 SQL 的直接控制权，开发者可以自由编写 SQL 语句，同时通过 XML 或注解方式将结果映射到 Java 对象中。
形象比喻：
可以将 MyBatis 想象为一位“翻译官”，它负责将开发者编写的 SQL 语句转换为数据库可执行的指令，并将数据库返回的结果翻译成 Java 对象。

1.2 Spring：一站式企业级框架

Spring 框架是一个轻量级的 Java 开发框架，其核心功能包括依赖注入（DI）、面向切面编程（AOP）以及模块化的分层架构设计。Spring 的核心优势在于其模块化设计，允许开发者根据需求灵活选择组件，例如 Spring MVC 用于 Web 开发，Spring Data 用于数据访问等。
形象比喻：
Spring 好比一个“调度员”，它负责协调各个模块的协作，确保应用的各个组件能够高效、有序地运行。

1.3 为什么需要整合 MyBatis 和 Spring？

依赖注入：通过 Spring 的 DI 机制，可以方便地管理 MyBatis 的 SqlSessionFactory、Mapper 接口等 Bean，减少硬编码。
事务管理：Spring 提供的声明式事务管理功能，能够与 MyBatis 的 SQL 执行无缝结合，简化事务控制逻辑。
代码解耦：整合后，MyBatis 的 SQL 映射文件或注解可以独立于 Spring 配置之外，提升代码的可维护性。

二、环境搭建与核心配置

2.1 项目初始化

假设我们使用 Maven 管理依赖，首先需要在 pom.xml 中添加以下依赖：

<!-- Spring Boot Starter Data JPA (可选，根据需求选择) -->  
<dependency>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-starter-data-jpa</artifactId>  
</dependency>  

<!-- MyBatis-Spring Boot 整合依赖 -->  
<dependency>  
    <groupId>org.mybatis.spring.boot</groupId>  
    <artifactId>mybatis-spring-boot-starter</artifactId>  
    <version>2.2.0</version>  
</dependency>  

<!-- 数据库驱动（以 MySQL 为例）-->  
<dependency>  
    <groupId>mysql</groupId>  
    <artifactId>mysql-connector-java</artifactId>  
    <version>8.0.26</version>  
</dependency>

2.2 数据库与数据源配置

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

spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_spring?useSSL=false  
spring.datasource.username=root  
spring.datasource.password=123456  
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver  

mybatis.mapper-locations=classpath:mapper/*.xml  
mybatis.type-aliases-package=com.example.entity

关键参数说明：

mybatis.mapper-locations：指定 MyBatis XML 映射文件的路径。
mybatis.type-aliases-package：定义 Java 类的包路径，MyBatis 会自动为这些类生成类型别名（如 User 替代 com.example.entity.User）。

三、核心组件与代码示例

3.1 实体类（Entity）

创建一个简单的 User 实体类：

package com.example.entity;  

public class User {  
    private Long id;  
    private String username;  
    private String email;  

    // 省略 getter/setter 方法  
}

3.2 Mapper 接口与 SQL 映射

3.2.1 基于注解的 Mapper

通过 @Mapper 注解定义 Mapper 接口，并使用 MyBatis 的注解（如 @Select）编写 SQL：

package com.example.mapper;  

import org.apache.ibatis.annotations.Mapper;  
import org.apache.ibatis.annotations.Select;  

@Mapper  
public interface UserMapper {  
    @Select("SELECT * FROM users WHERE id = #{id}")  
    User selectById(Long id);  
}

3.2.2 基于 XML 的 Mapper

在 src/main/resources/mapper 目录下创建 UserMapper.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  

<mapper namespace="com.example.mapper.UserMapper">  
    <select id="selectByEmail" resultType="User">  
        SELECT * FROM users WHERE email = #{email}  
    </select>  
</mapper>

3.3 Service 层与事务管理

通过 Spring 的 @Service 注解定义 Service 层，并使用 @Transactional 实现事务管理：

package com.example.service;  

import org.springframework.beans.factory.annotation.Autowired;  
import org.springframework.stereotype.Service;  
import org.springframework.transaction.annotation.Transactional;  

@Service  
public class UserService {  
    @Autowired  
    private UserMapper userMapper;  

    @Transactional  
    public User getUserByEmail(String email) {  
        return userMapper.selectByEmail(email);  
    }  
}

四、进阶实践：动态 SQL 与缓存

4.1 动态 SQL

在 XML 文件中，可以使用 MyBatis 提供的动态 SQL 标签（如 <if>、<choose>）构建条件查询：

<select id="selectByCondition" resultType="User">  
    SELECT * FROM users  
    WHERE 1=1  
    <if test="username != null">  
        AND username LIKE CONCAT('%', #{username}, '%')  
    </if>  
    <if test="email != null">  
        AND email = #{email}  
    </if>  
</select>

4.2 二级缓存配置

在 MyBatis 配置文件中开启二级缓存：

<configuration>  
    <settings>  
        <setting name="cacheEnabled" value="true"/>  
    </settings>  
</configuration>

同时在 Mapper 接口上添加 @CacheNamespace 注解：

@CacheNamespace  
public interface UserMapper {  
    // 方法定义  
}

五、常见问题与解决方案

5.1 SQL 语句未被识别

问题：在 XML 中定义的 SQL 语句无法被 Mapper 接口调用。
解决：检查 mapper-locations 配置是否正确，并确保 XML 文件的 namespace 与 Mapper 接口的全限定名一致。

5.2 事务未生效

问题：在 Service 方法中添加了 @Transactional，但事务未按预期回滚。
解决：

确保事务管理器已正确配置（如 @EnableTransactionManagement）。
方法需通过 Spring 代理调用（避免直接调用自身方法）。

六、总结与展望

通过本文的讲解，读者已掌握了 MyBatis-Spring 整合的基本流程、核心组件以及常见实践。从基础的环境搭建到动态 SQL 和缓存优化，这一技术栈为开发者提供了强大的工具支持。未来，随着项目复杂度的提升，可以进一步探索以下方向：

分页插件：结合 MyBatis 的插件机制实现通用分页逻辑。
代码生成器：利用 MyBatis-Generator 自动生成基础代码，提升开发效率。
性能监控：通过 Spring Boot Actuator 或第三方工具（如 Prometheus）监控 SQL 执行效率。

希望本文能帮助读者在实际项目中高效应用 MyBatis-Spring 技术栈，构建出健壮、可维护的后端系统。

mybatis spring（长文解析）

一、MyBatis 和 Spring 的核心特性与整合必要性

1.1 MyBatis：灵活的 SQL 映射工具

1.2 Spring：一站式企业级框架

1.3 为什么需要整合 MyBatis 和 Spring？

二、环境搭建与核心配置

2.1 项目初始化

2.2 数据库与数据源配置

三、核心组件与代码示例

3.1 实体类（Entity）

3.2 Mapper 接口与 SQL 映射

3.2.1 基于注解的 Mapper

3.2.2 基于 XML 的 Mapper

3.3 Service 层与事务管理

四、进阶实践：动态 SQL 与缓存

4.1 动态 SQL

4.2 二级缓存配置

五、常见问题与解决方案

5.1 SQL 语句未被识别

5.2 事务未生效

六、总结与展望

最新发布

jQuery.each()方法（长文解析）

jQuery.extend()方法（长文解析）

jQuery.fn.extend()方法（千字长文）

jQuery.globalEval()方法（长文讲解）

jQuery.grep() 方法（长文讲解）

jQuery.inArray() 方法（长文讲解）

jQuery.isArray() 方法（手把手讲解）

jQuery.isEmptyObject() 方法（千字长文）

jQuery.isFunction() 方法（建议收藏）

jQuery.isNumeric() 方法（手把手讲解）