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开发中，数据库操作是应用的核心功能之一。早期开发者需要手动编写SQL语句并处理JDBC连接，这种方式不仅代码冗余，还容易引发SQL注入等安全问题。随着ORM（对象关系映射）技术的兴起，框架如Hibernate、MyBatis应运而生。其中，MyBatis介绍常被提及，因其在灵活性与易用性之间的平衡，成为开发者首选的数据库交互工具。

与全自动化ORM框架不同，MyBatis采用"半自动化"策略：它允许开发者直接编写SQL语句，同时通过映射机制将结果自动转换为Java对象。这种设计既保留了SQL的精细控制能力，又避免了重复的数据库操作代码。接下来，本文将从核心概念、配置方法、实际案例等角度，深入解析MyBatis的运作原理与应用技巧。

核心概念：理解MyBatis的"翻译官"角色

1. 核心组件：SqlSessionFactory与SqlSession

MyBatis框架的核心可以比喻为一位"数据库翻译官"。当应用程序需要与数据库交互时，它负责将Java对象翻译成SQL语句，同时将查询结果翻译回Java对象。这个过程依赖两个关键组件：

• SqlSessionFactory：相当于"翻译官的办公室"，负责创建SqlSession实例。通过配置文件（如mybatis-config.xml）初始化数据库连接信息、映射文件路径等。
• SqlSession：直接参与翻译工作的"翻译员"，提供执行SQL、提交事务等操作。每次数据库交互都需通过SqlSession对象完成。

// 创建SqlSessionFactory示例
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

// 获取SqlSession示例
try (SqlSession session = sqlSessionFactory.openSession()) {
    // 执行数据库操作
}

2. 映射文件：SQL语句的"词典库"

MyBatis通过XML或注解定义映射关系，这些映射文件如同"翻译词典"，存储着SQL语句与Java方法的对应关系。例如：

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

在此示例中，selectUserById方法对应数据库查询，参数#{id}会被MyBatis自动替换为Java对象中的id值，查询结果则根据resultType="User"映射为User类实例。

快速上手：配置与简单CRUD操作

1. 环境搭建步骤

MyBatis的集成过程可分为三步：

1. 添加依赖：在Maven项目中引入MyBatis核心库

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

2. 配置数据库连接：在mybatis-config.xml中定义数据源

   <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="password"/>
           </dataSource>
       </environment>
   </environments>
   

3. 注册映射文件：在配置文件中声明所有Mapper XML路径

   <mappers>
       <mapper resource="com/example/mapper/UserMapper.xml"/>
   </mappers>
   

2. 实现CRUD操作

以下通过用户管理案例，演示MyBatis的增删改查操作：

(1) 查询操作

public User selectUserById(int id) {
    try (SqlSession session = sqlSessionFactory.openSession()) {
        UserMapper mapper = session.getMapper(UserMapper.class);
        return mapper.selectUserById(id);
    }
}

(2) 插入操作

<!-- UserMapper.xml -->
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
    INSERT INTO users (name, email) VALUES (#{name}, #{email})
</insert>

(3) 更新操作

<update id="updateUser">
    UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}
</update>

(4) 删除操作

<delete id="deleteUserById">
    DELETE FROM users WHERE id = #{id}
</delete>

动态SQL：让SQL语句"智能"起来

1. 常用动态标签解析

MyBatis提供了多种动态SQL标签，使SQL语句能根据条件灵活变化，避免硬编码多套SQL：

• if标签：条件判断

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

• choose标签：多条件分支（类似Java的switch）

<choose>
    <when test="age > 30">
        AND age > 30
    </when>
    <when test="gender == 'F'">
        AND gender = 'F'
    </when>
    <otherwise>
        AND active = true
    </otherwise>
</choose>

2. 循环标签：处理集合参数

当需要根据用户传入的列表参数生成IN条件时，可以使用foreach标签：

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

3. 组合技巧：片段复用

通过include标签可将公共SQL语句提取为片段，例如：

<!-- 定义片段 -->
<sql id="baseColumns">
    id, name, email, create_time
</sql>

<!-- 引用片段 -->
<select id="selectUsers" resultType="User">
    SELECT <include refid="baseColumns"/> FROM users
</select>

高级特性：分页与缓存机制

1. 分页实现方案

MyBatis本身不提供内置分页，但可通过两种方式实现：

(1) RowBounds分页（简单场景）

通过RowBounds对象控制分页，但此方法依赖数据库驱动，不建议用于大数据量场景：

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

(2) 原生SQL分页（推荐）

直接在SQL中使用LIMIT或ROWNUM等数据库特定语法：

<select id="selectUsersWithPage" resultType="User">
    SELECT * FROM users 
    ORDER BY id
    LIMIT #{offset}, #{limit}
</select>

2. 缓存机制详解

MyBatis支持一级缓存（SqlSession级别）和二级缓存（Mapper级别）。启用二级缓存需满足：

1. 在Mapper XML中添加<cache/>声明
2. 实体类实现Serializable接口

<!-- 开启二级缓存 -->
<mapper namespace="com.example.mapper.UserMapper">
    <cache/>
    <!-- 其他SQL语句 -->
</mapper>

常见问题与最佳实践

1. 性能优化建议

• 避免全表查询：始终添加合理的WHERE条件
• 使用批处理：批量插入时使用SqlSession的insert方法重载

List<User> users = ...;
session.insert("batchInsertUsers", users);

• 合理使用延迟加载：通过lazyLoadAllEnabled配置控制关联对象加载时机

2. 异常处理要点

• 捕获SQLException并转换为业务异常
• 使用@SelectKey处理自增主键返回问题

3. 与Spring整合技巧

通过@MapperScan注解简化配置：

@Configuration
@MapperScan("com.example.mapper")
public class MyBatisConfig {
    // 配置数据源等
}

结论：选择MyBatis的三大理由

1. 灵活可控：直接编写SQL语句，避免ORM框架的"黑箱操作"
2. 性能优越：相比Hibernate等全ORM框架，MyBatis的性能损耗更低
3. 学习曲线适中：对于熟悉SQL的开发者，只需掌握基本映射规则即可快速上手

通过本文的介绍，相信读者已对MyBatis的核心功能有了系统性认识。无论是处理中小型项目的数据库交互，还是优化大型应用的查询性能，MyBatis都能提供灵活高效的解决方案。建议读者通过官方文档和实际项目实践，进一步掌握动态SQL、缓存配置等进阶功能，从而在开发中充分发挥MyBatis的价值。