Java 持久层框架 MyBatis 全面详解

Java 持久层框架 MyBatis 全面详解

MyBatis 是 Java 生态中最流行的持久层框架之一（ORM 框架），前身为 iBatis，于 2010 年更名。它专注于 SQL 映射，提供简洁的 API 来处理数据库操作，支持复杂查询、动态 SQL 和缓存。相比 Hibernate（全自动 ORM），MyBatis 是半自动 ORM：开发者手动编写 SQL，但框架处理参数映射和结果集转换。

这份详解从基础到高级，聚焦核心原理、实战代码和常见场景。基于 MyBatis 3.x（最新版 3.5.13+，2026 年当前），适合初学者到资深开发者。假设你有 JDBC 和 Java 基础。

1. MyBatis 核心优势 & 与其他框架对比

优势：

• SQL 灵活：直接写 SQL，支持动态拼接，避免 Hibernate HQL 的局限。
• 轻量级：无侵入性，易集成 Spring/Spring Boot。
• 性能高：手动 SQL 优化空间大，支持二级缓存。
• 映射自由：支持一对一、一对多、多对多结果映射。
• 插件生态：易扩展，如分页插件、通用 Mapper。

对比表（常见 ORM 框架）：

框架	类型	SQL 控制度	学习曲线	适用场景	缺点
MyBatis	半自动 ORM	高（手动写）	中等	复杂查询、遗留系统	SQL 编写量大
Hibernate/JPA	全自动 ORM	中（HQL/JPQL）	高	简单 CRUD、领域模型驱动	黑盒优化难、N+1 问题
Spring Data JDBC	轻量 ORM	中（注解+SQL）	低	简单应用、纯 JDBC 替代	功能少、不支持动态 SQL
MyBatis-Plus	MyBatis 增强	高（自动+手动）	低	快速开发、CRUD 优化	依赖 MyBatis，稍重

一句话记忆：MyBatis = SQL + 映射 + 配置，强调“SQL 本位”。

2. MyBatis 工作原理（核心流程）

1. 配置加载：读取 mybatis-config.xml 或注解配置，构建 SqlSessionFactory。
2. 会话创建：SqlSessionFactory.openSession() → SqlSession（线程不安全，需手动关闭）。
3. Mapper 获取：SqlSession.getMapper(UserMapper.class) → 动态代理 Mapper 接口。
4. SQL 执行：调用 Mapper 方法 → 参数绑定 → 执行 SQL → 结果映射到 POJO。
5. 事务管理：支持手动/自动提交，支持与 Spring 事务集成。

关键组件：

• SqlSession：核心接口，执行 SQL。
• Mapper：接口 + XML/注解，定义 SQL。
• TypeHandler：类型转换（如 Date ↔ Timestamp）。
• Executor：执行器（Simple/Reuse/Batch/Caching）。
• Cache：一级（会话级）/二级（全局）。

3. 快速上手：Maven 配置 & 基本示例

Maven 依赖（Spring Boot 集成推荐 starter）：

<!-- MyBatis Core -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.13</version>
</dependency>
<!-- MySQL 驱动（示例） -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>
<!-- Spring Boot Starter（可选） -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>

mybatis-config.xml（全局配置）：

<?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>
    <settings>
        <setting name="mapUnderscoreToCamelCase" value="true"/> <!-- 驼峰映射 -->
        <setting name="useGeneratedKeys" value="true"/> <!-- 自增主键返回 -->
        <setting name="cacheEnabled" value="true"/> <!-- 开启二级缓存 -->
    </settings>
    <typeAliases>
        <package name="com.example.pojo"/> <!-- 别名包 -->
    </typeAliases>
    <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/testdb"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/> <!-- XML Mapper -->
    </mappers>
</configuration>

POJO 示例（User.java）：

public class User {
    private Integer id;
    private String name;
    private Integer age;
    // getters/setters
}

Mapper 接口（UserMapper.java）：

public interface UserMapper {
    User selectById(Integer id);
    List<User> selectAll();
    int insertUser(User user);
}

Mapper XML（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="selectById" parameterType="int" resultType="User">
        SELECT id, name, age FROM user WHERE id = #{id}
    </select>
    <select id="selectAll" resultType="User">
        SELECT * FROM user
    </select>
    <insert id="insertUser" parameterType="User" useGeneratedKeys="true" keyProperty="id">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>
</mapper>

测试代码（纯 MyBatis）：

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MyBatisTest {
    public static void main(String[] args) throws Exception {
        SqlSessionFactory factory = new SqlSessionFactoryBuilder()
                .build(Resources.getResourceAsReader("mybatis-config.xml"));
        try (SqlSession session = factory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            User user = mapper.selectById(1);
            System.out.println(user);
            session.commit(); // 事务提交
        }
    }
}

4. 动态 SQL（高频实战）

MyBatis 的动态 SQL 是其亮点，使用 <if>、<choose>、<foreach> 等标签拼接 SQL。

示例（动态查询）：

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

foreach 批量插入：

<insert id="batchInsert" parameterType="list">
    INSERT INTO user (name, age) VALUES
    <foreach collection="list" item="user" separator=",">
        (#{user.name}, #{user.age})
    </foreach>
</insert>

choose/when（类似 switch）：

<choose>
    <when test="id != null">AND id = #{id}</when>
    <when test="name != null">AND name = #{name}</when>
    <otherwise>AND age > 18</otherwise>
</choose>

5. 结果映射（ResultMap）——处理复杂关联

用于处理列名不匹配、一对多等。

示例（一对多：User 有多个 Order）：

<resultMap id="userWithOrders" type="User">
    <id property="id" column="u_id"/>
    <result property="name" column="u_name"/>
    <collection property="orders" ofType="Order">
        <id property="id" column="o_id"/>
        <result property="amount" column="o_amount"/>
    </collection>
</resultMap>

<select id="selectUserWithOrders" resultMap="userWithOrders">
    SELECT u.id u_id, u.name u_name, o.id o_id, o.amount o_amount
    FROM user u LEFT JOIN order o ON u.id = o.user_id
    WHERE u.id = #{id}
</select>

6. 缓存机制（性能优化）

• 一级缓存：默认开启，会话级（SqlSession 内相同查询复用结果）。
• 二级缓存：全局级，需配置 <cache/> 或 <cache-ref/>。
• 支持 Ehcache/Redis 集成。
• 读写模式：readOnly=true（默认读）。

XML 配置：

<cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>

注意：更新操作会刷新缓存，避免脏读。

7. 插件开发（Interceptor）——扩展点

MyBatis 支持拦截 Executor、ParameterHandler、ResultSetHandler、StatementHandler。

示例（日志插件）：

import org.apache.ibatis.plugin.*;

@Intercepts(@Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}))
public class LogPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        System.out.println("执行 SQL: " + invocation.getArgs()[0]);
        return invocation.proceed();
    }
}

配置：<plugins><plugin interceptor="com.example.LogPlugin"/></plugins>

8. 与 Spring/Spring Boot 集成（企业级必备）

Spring Boot 配置（application.yml）：

mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.example.pojo
  configuration:
    map-underscore-to-camel-case: true

Mapper 扫描：@MapperScan(“com.example.mapper”)

事务：@Transactional

9. 常见问题 & 最佳实践

• N+1 问题：用延迟加载（lazyLoadingEnabled=true）或关联查询解决。
• 参数注入：单参数用 #{param}，多参数用 @Param(“name”)。
• 分页：用 PageHelper 插件（Maven: com.github.pagehelper）。
• 性能调优：批量操作用 BatchExecutor，监控慢 SQL。
• 安全：用 #{} 防 SQL 注入，避免 ${}。
• 版本升级：从 3.4+ 支持 JDK 8+ 特性，如 Optional。
• 扩展工具：MyBatis-Plus（代码生成器）、MyBatis Generator（逆向工程）。

掌握以上，MyBatis 基本精通。建议实践：建一个 CRUD 项目，集成 Spring Boot + MyBatis + MySQL。想深入特定模块（如动态 SQL 完整示例、MyBatis-Plus 对比、源码分析），或代码调试问题，继续问我！加油，重阳！（考虑到你的名字，祝你像重阳节一样，事业高升！）