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 平台？

MyBatis 是一款广泛应用于 Java 生态的持久化框架，它简化了数据库操作的复杂性，帮助开发者高效地实现数据访问层（DAO）功能。与传统的 JDBC 操作相比，MyBatis 通过 SQL 语句与对象映射 的方式，将数据库记录自动转换为 Java 对象，减少了重复代码的编写。

可以将 MyBatis 比作一位“翻译官”：它将开发者熟悉的面向对象编程（OOP）语言，与数据库的结构化查询语言（SQL）进行无缝转换。这种特性使得即使是编程初学者，也能快速上手数据库操作，而中级开发者则能通过高级功能实现复杂需求。

MyBatis 的核心概念与优势

1. 核心思想：面向 SQL 的 ORM 框架

ORM（Object-Relational Mapping） 是 MyBatis 的核心设计目标。它通过以下方式实现对象与关系型数据库的映射：

• SQL 语句与对象的绑定：开发者编写 SQL 后，MyBatis 自动将查询结果映射为 Java 对象。
• 配置驱动与注解驱动：支持 XML 配置或直接通过注解（如 @Select）定义 SQL，灵活适应不同场景需求。

与 Hibernate 等全自动化 ORM 框架不同，MyBatis 保留了对 SQL 的绝对控制权。这意味着开发者可以针对具体业务需求优化 SQL 性能，同时避免因 ORM 层过度抽象导致的“黑盒”问题。

2. MyBatis 平台的核心组件

MyBatis 的架构由三个核心组件构成：

1. SqlSessionFactory：工厂模式的产物，用于创建 SqlSession 实例。
2. SqlSession：单一线程内的数据库操作接口，负责执行 SQL、管理事务等。
3. Mapper 接口与 XML/注解配置：定义 SQL 语句及其与对象的映射规则。

比喻：这三者的关系类似于“餐馆的后厨”：

• SqlSessionFactory 是“总厨师长”，负责调配资源；
• SqlSession 是“具体厨师”，负责烹饪（执行 SQL）；
• Mapper 是“菜单”，规定了每道菜（SQL 语句）的制作方式。

3. MyBatis 的核心优势

环境搭建与快速入门

1. 环境准备

要使用 MyBatis 平台，需完成以下步骤：

• 添加依赖：通过 Maven 或 Gradle 引入 MyBatis 核心库。
• 配置数据库连接：提供 JDBC 驱动及数据源信息（如 URL、用户名、密码）。

Maven 依赖示例：

<dependency>  
    <groupId>org.mybatis</groupId>  
    <artifactId>mybatis</artifactId>  
    <version>3.5.10</version>  
</dependency>  

2. 最小化示例：查询用户信息

步骤 1：创建 Java 对象

定义一个 User 类，与数据库表 user 一一对应：

public class User {  
    private Integer id;  
    private String name;  
    private Integer age;  
    // 省略构造方法与 Getter/Setter  
}  

步骤 2：编写 Mapper XML 或注解

通过 XML 文件定义 SQL 语句：

<!-- UserMapper.xml -->  
<mapper namespace="com.example.mapper.UserMapper">  
    <select id="selectUserById" resultType="User">  
        SELECT * FROM user WHERE id = #{id}  
    </select>  
</mapper>  

步骤 3：配置 MyBatis 核心文件

创建 mybatis-config.xml，配置数据源和 Mapper 文件路径：

<?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE configuration  
  PUBLIC "-//mybatis.org//DTD Config 3.0//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/test"/>  
                <property name="username" value="root"/>  
                <property name="password" value="root"/>  
            </dataSource>  
        </environment>  
    </environments>  
    <mappers>  
        <mapper resource="com/example/mapper/UserMapper.xml"/>  
    </mappers>  
</configuration>  

步骤 4：执行查询

通过 SqlSessionFactory 和 SqlSession 执行 SQL：

public class Main {  
    public static void main(String[] args) throws IOException {  
        // 加载 MyBatis 配置文件  
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");  
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);  

        try (SqlSession session = sqlSessionFactory.openSession()) {  
            UserMapper mapper = session.getMapper(UserMapper.class);  
            User user = mapper.selectUserById(1);  
            System.out.println("User Name: " + user.getName());  
        }  
    }  
}  

3. 运行结果

如果数据库中存在 id=1 的用户，控制台将输出其 name 字段的值。这一流程展示了 MyBatis 的基本工作原理：

1. 配置文件加载：定义数据库连接与 Mapper 文件路径；
2. SQL 执行：通过 Mapper 接口调用 SQL 语句；
3. 结果映射：MyBatis 将数据库记录自动转换为 User 对象。

MyBatis 的核心 API 深入解析

1. SqlSessionFactory 与 SqlSession

SqlSessionFactory 的作用

它是 MyBatis 的入口类，通过 SqlSessionFactoryBuilder 读取配置文件（如 mybatis-config.xml），返回一个 SqlSessionFactory 实例。

关键代码示例：

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()  
    .build(inputStream);  

SqlSession 的生命周期

每个 SqlSession 实例代表一次数据库操作的上下文。其生命周期遵循以下原则：

• 线程隔离：每个线程应拥有独立的 SqlSession；
• 及时关闭：操作完成后需调用 close() 方法，释放数据库连接。

常见操作：

try (SqlSession session = sqlSessionFactory.openSession()) {  
    // 执行增删改查操作  
}  

2. Mapper 接口与 XML 的协作

MyBatis 通过 接口与 XML 文件的映射 实现 SQL 定义。例如：

接口定义：

public interface UserMapper {  
    User selectUserById(Integer id);  
}  

XML 配置：

<select id="selectUserById" resultType="User">  
    SELECT * FROM user WHERE id = #{id}  
</select>  

映射规则：

• id 属性：与接口方法名完全一致；
• 参数占位符：#{id} 表示从方法参数中提取值。

3. 动态 SQL：让 SQL 更智能

动态 SQL 是 MyBatis 的核心特性之一，允许根据条件生成不同的 SQL 语句。常用标签包括：

1. <if> 条件判断

<select id="selectUser" resultType="User">  
    SELECT * FROM user  
    WHERE 1=1  
    <if test="name != null">  
        AND name = #{name}  
    </if>  
    <if test="age != null">  
        AND age = #{age}  
    </if>  
</select>  

2. <foreach> 循环遍历

用于处理 IN 条件或批量操作：

<select id="selectUsersByIds" resultType="User">  
    SELECT * FROM user  
    WHERE id IN  
    <foreach item="id" collection="ids" open="(" separator="," close=")">  
        #{id}  
    </foreach>  
</select>  

3. <choose> 条件组合

类似 Java 的 switch-case：

<select id="selectUserByCondition" resultType="User">  
    SELECT * FROM user  
    WHERE 1=1  
    <choose>  
        <when test="name != null">  
            AND name = #{name}  
        </when>  
        <when test="age != null">  
            AND age = #{age}  
        </when>  
        <otherwise>  
            AND status = 1  
        </otherwise>  
    </choose>  
</select>  

4. 缓存机制：提升性能

MyBatis 提供了 一级缓存（默认开启）和 二级缓存（需手动配置），用于减少重复查询的数据库访问。

一级缓存

作用域为 单个 SqlSession，在同一个会话内查询同一对象时，会直接返回缓存结果。

二级缓存

作用域为 SqlSessionFactory，允许跨会话共享数据。需在 Mapper 文件中启用：

<mapper namespace="com.example.mapper.UserMapper">  
    <cache/>  
</mapper>  

进阶特性：关联查询与分页

1. 关联查询（Association）

当需要查询关联表数据时，MyBatis 通过 <association> 标签实现对象嵌套。例如，查询用户及其所属部门：

数据库表结构：

• user 表包含 department_id 外键；
• department 表存储部门信息。

Mapper XML 配置：

<select id="selectUserWithDepartment" resultType="User">  
    SELECT  
        u.id, u.name, u.age,  
        d.id AS dept_id,  
        d.name AS dept_name  
    FROM user u  
    LEFT JOIN department d ON u.department_id = d.id  
    WHERE u.id = #{id}  
</select>  

<!-- 或使用嵌套结果 -->  
<resultMap id="userResultMap" type="User">  
    <id property="id" column="id"/>  
    <result property="name" column="name"/>  
    <association property="department" javaType="Department">  
        <id property="id" column="dept_id"/>  
        <result property="name" column="dept_name"/>  
    </association>  
</resultMap>  

2. 分页查询

MyBatis 本身不提供分页功能，但可通过 RowBounds 或 LIMIT 关键字实现：

方法 1：RowBounds 分页

List<User> users = session.selectList("selectUsers", null,  
    new RowBounds(offset, limit));  

方法 2：直接在 SQL 中使用 LIMIT

<select id="selectUsers" resultType="User">  
    SELECT * FROM user  
    LIMIT #{offset}, #{limit}  
</select>  

3. 通用 Mapper：简化基础操作

通过第三方库（如 mybatis-generator 或 tk.mybatis），可自动生成基础的增删改查代码。例如：

@Mapper  
public interface UserMapper extends tk.mybatis.mapper.common.Mapper<User> {  
    // 自动继承 CRUD 方法  
}  

总结与展望

MyBatis 平台凭借其灵活性、轻量级特性及对 SQL 的直接控制，成为 Java 开发者处理数据库操作的首选工具之一。无论是编程初学者通过快速入门示例熟悉框架，还是中级开发者利用动态 SQL 和高级特性解决复杂场景，MyBatis 均能提供高效的支持。

未来，随着数据库技术的演进，MyBatis 平台也将持续优化性能、扩展性及易用性，进一步巩固其在 Java 持久化领域的地位。建议开发者在实践中深入理解其核心机制，结合业务需求灵活运用，以最大化开发效率与代码质量。