1. MyBatis 基础概念与核心特性
1.1 什么是 MyBatis?
MyBatis 是一款轻量级的半自动 ORM(对象关系映射)框架,它专注于 SQL 映射,将 Java 对象与数据库表进行关联,简化了传统的 JDBC 操作。作为一个在 Java 持久层广泛使用的框架,MyBatis 允许开发者完全掌控 SQL 语句的编写,同时自动处理参数绑定和结果集映射这些繁琐的工作。
我在实际项目中使用 MyBatis 多年,发现它特别适合需要精细控制 SQL 性能的场景。与全自动 ORM 框架不同,MyBatis 不会自动生成 SQL,而是让开发者自己编写 SQL 语句,这样既能保证 SQL 的执行效率,又能避免全自动 ORM 在某些复杂查询场景下的局限性。
注意:MyBatis 的前身是 iBatis,2010 年正式更名为 MyBatis。这个框架的核心思想就是"半自动化"——开发者负责编写 SQL,框架负责处理参数绑定、结果映射和连接管理等重复性工作。
1.2 MyBatis 的核心架构
MyBatis 的架构设计非常清晰,主要包含以下几个核心组件:
-
SqlSessionFactory:这是 MyBatis 的核心工厂类,负责创建 SqlSession 实例。通常一个应用只需要一个 SqlSessionFactory,它会在应用启动时通过配置文件或 Java 代码初始化。
-
SqlSession:这是 MyBatis 的主要工作接口,代表一次数据库会话。它提供了执行 SQL、获取映射器和管理事务的方法。在实际开发中,每个线程都应该有自己的 SqlSession 实例。
-
Mapper 接口:这是 MyBatis 的特色设计,通过接口定义数据库操作,MyBatis 会动态生成实现类。这种方式既保持了类型安全,又避免了传统 DAO 实现类的样板代码。
-
Executor:这是 MyBatis 的执行器,负责 SQL 语句的执行和缓存的维护。MyBatis 提供了三种执行器:SimpleExecutor、ReuseExecutor 和 BatchExecutor,分别适用于不同的场景。
-
StatementHandler:负责处理 JDBC Statement 的操作,包括参数设置和结果集转换。
-
ParameterHandler:负责将 Java 对象转换为 JDBC 参数。
-
ResultSetHandler:负责将 JDBC 结果集转换为 Java 对象。
1.3 MyBatis 的工作流程
理解 MyBatis 的工作流程对于深入使用这个框架非常重要。下面是一个典型的 MyBatis 执行流程:
-
配置加载阶段:MyBatis 启动时,会读取配置文件(mybatis-config.xml)和所有的映射文件(Mapper XML),构建出 Configuration 对象,这个对象包含了 MyBatis 运行所需的所有配置信息。
-
SQL 解析阶段:MyBatis 会解析所有的 SQL 映射文件,将每个 SQL 语句解析为 MappedStatement 对象,并存储在 Configuration 中。
-
SQL 执行阶段:
- 应用程序通过 SqlSessionFactory 获取 SqlSession
- SqlSession 通过 Executor 执行 SQL
- Executor 通过 StatementHandler 处理 Statement
- StatementHandler 使用 ParameterHandler 设置参数
- Statement 执行后,ResultSetHandler 处理结果集
- 最终结果返回给调用者
-
结果映射阶段:MyBatis 会根据配置的 resultMap 或 resultType,将结果集转换为 Java 对象。
在实际项目中,我发现理解这个工作流程对于排查问题和性能优化非常有帮助。例如,当遇到 SQL 执行慢的问题时,可以清楚地知道是在哪个环节出现了瓶颈。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. MyBatis 的核心配置与映射
2.1 MyBatis 配置文件详解
MyBatis 的主配置文件(通常是 mybatis-config.xml)是整个框架的核心配置入口。这个文件虽然看起来简单,但包含了大量可配置的选项,合理配置这些选项可以显著提升 MyBatis 的性能和可用性。
以下是一个典型配置文件的骨架结构:
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>
<!-- 属性配置 -->
<properties resource="db.properties"/>
<!-- 设置 -->
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 更多设置... -->
</settings>
<!-- 类型别名 -->
<typeAliases>
<package name="com.example.model"/>
</typeAliases>
<!-- 类型处理器 -->
<typeHandlers>
<package name="com.example.typehandler"/>
</typeHandlers>
<!-- 环境配置 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!-- 数据源配置 -->
</dataSource>
</environment>
</environments>
<!-- 映射器 -->
<mappers>
<mapper resource="mapper/U
