mybatis #（超详细）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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+ 小伙伴加入学习 ，欢迎点击围观

前言：走进 MyBatis 的世界

在 Java 开发领域，持久层框架的选择往往决定了项目的性能与可维护性。MyBatis 作为一款轻量级的 ORM（对象关系映射）框架，凭借其灵活的 SQL 写法和低侵入性设计，成为众多开发者的心头之选。尤其在需要精细控制数据库操作的场景中，MyBatis 的优势尤为突出。本文将深入探讨 MyBatis 的核心特性与最佳实践，通过循序渐进的讲解，帮助读者理解如何高效使用 MyBatis，并掌握其背后的设计理念。对于编程初学者，我们将以简单易懂的方式拆解概念；对于中级开发者，本文将提供进阶技巧，助力技术提升。

MyBatis 的核心组件与基础配置

1. 核心组件解析

MyBatis 的架构设计围绕几个关键组件展开：

• SqlSessionFactory：数据库连接的工厂类，负责创建 SqlSession 对象，可类比为“桥梁建造师”，负责搭建与数据库交互的通道。
• SqlSession：执行 SQL 语句的核心接口，承担增删改查等操作，类似“桥梁本身”，直接承载数据的传输。
• Mapper 接口与 XML 文件：定义 SQL 语句的入口，通过接口或 XML 文件描述 SQL 逻辑，是 MyBatis 的“导航系统”。

示例配置：基础环境搭建

<!-- mybatis-config.xml 配置文件 -->
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2. 参数绑定与 # 的奥秘

在 MyBatis 中，# 符号是参数占位符的关键角色。它通过预编译机制将参数值安全地注入 SQL 语句，有效防止 SQL 注入攻击。例如：

-- 使用 # 的 SQL 写法
SELECT * FROM user WHERE name = #{name}

此处的 #{name} 会被替换为 ?，最终通过 JDBC 的 PreparedStatement 实现参数绑定。与 $ 符号不同，# 的本质是“安全防护罩”，而 $ 则直接拼接字符串（需谨慎使用）。

对比示例：# 与 $ 的区别

动态 SQL 与条件构建

1. 动态 SQL 的核心标签

MyBatis 提供了丰富的动态 SQL 标签，如 <if>、<choose>、<foreach> 等，帮助开发者灵活构建 SQL 语句。例如：

<!-- UserMapper.xml 中的动态查询 -->
<select id="selectUsers" resultType="User">
    SELECT * FROM user
    WHERE 1=1
    <if test="name != null">
        AND name LIKE CONCAT('%', #{name}, '%')
    </if>
    <if test="age != null">
        AND age >= #{age}
    </if>
</select>

此例中，<if> 标签根据传入参数动态拼接查询条件，类似“积木组合”，极大提升了 SQL 的复用性。

2. 复杂条件的优雅处理

对于多条件组合场景，<choose> 标签可模拟 switch-case 逻辑：

<choose>
    <when test="status == 1">
        AND status = 1
    </when>
    <when test="status == 2">
        AND status = 2
    </when>
    <otherwise>
        AND status IS NULL
    </otherwise>
</choose>

结果映射与对象关系处理

1. 基本映射与复杂关联

MyBatis 默认根据属性名自动映射数据库字段，但复杂场景需手动定义：

<!-- 处理一对多关系 -->
<resultMap id="userWithOrders" type="User">
    <id column="user_id" property="id"/>
    <collection property="orders" ofType="Order">
        <id column="order_id" property="id"/>
    </collection>
</resultMap>

此配置将用户与订单表关联，类似“家庭关系图谱”，清晰展示对象间依赖。

2. 别名与自动映射优化

通过 <typeAliases> 配置别名，可简化代码：

<typeAliases>
    <typeAlias alias="User" type="com.example.entity.User"/>
</typeAliases>

事务管理与缓存机制

1. 事务控制

MyBatis 的事务由 SqlSession 管理，通过 commit() 和 rollback() 控制：

try (SqlSession session = factory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    mapper.insertUser(user);
    session.commit();
} catch (Exception e) {
    session.rollback();
    throw e;
}

2. 缓存策略

MyBatis 提供一级缓存（本地缓存）和二级缓存（跨 SqlSession）：

<!-- 开启二级缓存 -->
<cache eviction="FIFO" flushInterval="60000"/>

合理使用缓存可减少数据库压力，类似“记忆库”，存储近期查询结果。

实战案例：用户管理系统

1. 功能需求

实现用户增删改查，支持分页与条件查询。

2. 代码实现

Mapper 接口定义

public interface UserMapper {
    void insertUser(User user);
    void deleteUserById(Long id);
    User selectUserById(Long id);
    List<User> selectUsers(UserQuery query);
}

XML 配置

<!-- 分页与条件查询 -->
<select id="selectUsers" resultType="User">
    SELECT * FROM user
    WHERE name LIKE CONCAT('%', #{query.name}, '%')
    ORDER BY id DESC
    LIMIT #{query.offset}, #{query.limit}
</select>

分页工具类

public class UserQuery {
    private String name;
    private int offset;
    private int limit;
    // getters/setters
}

结论：MyBatis 的进阶之路

通过本文的讲解，我们深入理解了 MyBatis 的核心机制，从基础配置到动态 SQL，再到缓存优化，逐步构建了一个完整的知识体系。对于初学者，建议从简单查询入手，逐步掌握 # 符号的使用与动态 SQL 的逻辑；中级开发者则可探索缓存策略与分页优化。MyBatis 的灵活性使其成为复杂业务场景的理想选择，但需注意过度使用动态 SQL 可能导致的代码维护问题。未来，结合 MyBatis-Plus 等增强框架，开发者可进一步提升开发效率，实现更优雅的代码架构。