mybatis in（建议收藏）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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 开发中的重要性

在 Java 开发中，数据库操作是应用的核心功能之一。传统的 JDBC 方式虽然直接，但代码冗余、难以维护，而 MyBatis 作为一款半自动化 ORM 框架，通过灵活的 SQL 映射和简洁的 API，成为开发者高效操作数据库的首选工具。本文将深入解析 MyBatis in Java 应用中的核心概念、工作原理及实战技巧，帮助读者从零开始掌握这一工具。

核心概念与基本使用

什么是 MyBatis？

MyBatis 是一个基于 Java 的持久层框架，它通过将 SQL 语句与 Java 对象映射，简化了数据库操作。其核心思想是 “让开发者完全掌控 SQL”，同时提供了一套优雅的 API 来执行查询、插入、更新和删除操作。

核心组件解析

1. SqlSessionFactory：数据库会话工厂，负责创建 SqlSession 对象。
2. SqlSession：单线程数据库操作的核心接口，提供执行 SQL、提交事务等能力。
3. Mapper 接口与 XML 文件：定义 SQL 语句的映射关系，是 MyBatis 的核心配置单元。

示例：简单查询操作

// Mapper 接口
public interface UserMapper {
    User selectById(int id);
}

// XML 映射文件（UserMapper.xml）
<mapper namespace="com.example.UserMapper">
    <select id="selectById" resultType="User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

通过接口与 XML 的配合，开发者可以清晰地分离业务逻辑与 SQL 语句，提升代码可维护性。

MyBatis 的工作原理

数据库操作的“翻译官”

MyBatis 的核心作用是充当 “Java 对象与 SQL 语句的翻译官”。其工作流程如下：

1. 配置加载：读取 mybatis-config.xml，初始化数据库连接参数和映射关系。
2. SQL 解析：根据 Mapper 接口或 XML 文件，将方法名或注解映射到具体的 SQL 语句。
3. 动态 SQL 处理：根据条件生成最终的 SQL 语句（如 WHERE 条件拼接）。
4. 执行与结果映射：通过 JDBC 执行 SQL，并将结果集自动转换为 Java 对象。

流程比喻

可以将 MyBatis 想象为一座桥梁：

• 桥墩：配置文件和映射关系，确保结构稳固。
• 桥面：动态 SQL 处理，灵活适应不同场景。
• 车辆：最终生成的 SQL 语句，高效通行到数据库。

配置与初始化

核心配置文件：mybatis-config.xml

该文件定义了 MyBatis 的全局配置，包括数据源、环境配置、类型别名等。

示例配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD CONFIG 3.5//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<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/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

关键配置项说明

SQL 映射与执行

映射文件的结构

Mapper XML 文件的核心是 <mapper> 标签，包含以下元素：

• <select>：查询操作。
• <insert>：插入操作。
• <update>：更新操作。
• <delete>：删除操作。

示例：插入操作

<insert id="insertUser" parameterType="User">
    INSERT INTO users (name, email) VALUES (#{name}, #{email})
</insert>

注解驱动的映射

MyBatis 还支持通过注解直接在 Mapper 接口上定义 SQL：

@Insert("INSERT INTO users (name, email) VALUES (#{name}, #{email})")
void insertUser(@Param("name") String name, @Param("email") String email);

注解的优势

• 减少 XML 文件数量，适合小型项目。
• 参数绑定需配合 @Param 注解显式指定字段名。

动态 SQL：灵活的 SQL 生成

动态 SQL 是 MyBatis 的核心特性之一，允许根据条件动态生成 SQL 语句。

常用标签与示例

1. <if>：条件判断

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

2. <foreach>：遍历集合

<update id="updateUsers">
    UPDATE users 
    SET active = 1 
    WHERE id IN 
    <foreach item="id" collection="ids" open="(" separator="," close=")">
        #{id}
    </foreach>
</update>

3. <choose>：多条件分支

<choose>
    <when test="conditionA">
        AND status = 'A'
    </when>
    <when test="conditionB">
        AND status = 'B'
    </when>
    <otherwise>
        AND status = 'DEFAULT'
    </otherwise>
</choose>

动态 SQL 的比喻

动态 SQL 就像一个“智能拼图”：

• 条件判断：根据输入参数选择拼图碎片。
• 循环遍历：自动将集合数据转化为 SQL 的 IN 条件。
• 分支选择：像交通灯一样，根据条件选择不同的执行路径。

高级特性：缓存与分页

缓存机制

MyBatis 提供 一级缓存（SqlSession 级）和 二级缓存（Mapper 级），可显著提升查询性能。

一级缓存示例

<select id="selectById" resultType="User" useCache="true">
    SELECT * FROM users WHERE id = #{id}
</select>

分页插件

通过 PageHelper 等插件，可轻松实现分页查询：

PageHelper.startPage(1, 10);
List<User> users = userMapper.selectAll();
PageInfo<User> pageInfo = new PageInfo<>(users);

MyBatis in Spring Boot 的整合

在 Spring Boot 中，只需添加依赖并配置 application.properties，即可快速集成 MyBatis：

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=123456
mybatis.type-aliases-package=com.example.model

示例：Spring Boot 配置类

@Configuration
@MapperScan("com.example.mapper")
public class MyBatisConfig {
    // 可扩展自定义配置
}

实际案例：用户管理系统

需求描述

实现一个简单的用户管理功能，包含以下操作：

1. 根据姓名模糊查询用户。
2. 批量更新用户状态。
3. 分页查询用户列表。

实现步骤

1. 实体类：

public class User {
    private int id;
    private String name;
    private String email;
    private boolean active;
    // Getters and Setters
}

2. Mapper 接口：

public interface UserMapper {
    List<User> searchUsers(@Param("name") String name);
    void batchUpdate(@Param("ids") List<Integer> ids);
    List<User> listUsers(int pageNum, int pageSize);
}

3. XML 映射文件：

<!-- 模糊查询 -->
<select id="searchUsers" resultType="User">
    SELECT * FROM users 
    WHERE name LIKE CONCAT('%', #{name}, '%')
</select>

<!-- 批量更新 -->
<update id="batchUpdate">
    UPDATE users 
    SET active = 1 
    WHERE id IN 
    <foreach item="id" collection="ids" open="(" separator="," close=")">
        #{id}
    </foreach>
</update>

4. 分页查询：

// Service 层代码
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.listUsers();
PageInfo<User> pageInfo = new PageInfo<>(users);

结论：MyBatis 的适用场景与学习建议

适用场景

• 需要精细控制 SQL 语句的复杂查询场景。
• 对性能要求高，需优化 SQL 的项目。
• 需要与遗留数据库或复杂表结构交互的场景。

进阶学习方向

1. 源码分析：理解 SqlSession、Executor 的实现细节。
2. 插件开发：自定义拦截器实现日志记录或权限控制。
3. 与 ORM 框架对比：对比 Hibernate 的全自动映射特性。

通过本文的讲解，读者应能掌握 MyBatis 的核心功能与最佳实践。建议从简单项目入手，逐步尝试动态 SQL、缓存和插件开发，最终实现高效、灵活的数据库交互。

希望本文能帮助开发者在 MyBatis in 实际开发中游刃有余，提升代码质量和开发效率。