mybits（建议收藏）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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（本文统一采用“mybits”作为关键词）作为一款轻量级的持久化框架，凭借其简洁的配置和强大的扩展性，在 Java 生态中广受欢迎。无论是小型项目还是大型系统，它都能提供直观的 SQL 映射能力，帮助开发者快速实现业务逻辑。本文将从零开始，逐步解析 mybits 的核心原理，并通过实战案例展示其具体应用。

一、MyBatis 的核心概念与优势

1.1 什么是 MyBatis？

MyBatis 是一个基于 Java 的持久层框架，它通过半自动化的 SQL 映射，将 Java 对象与数据库记录进行转换。与 Hibernate 等全 ORM 框架不同，MyBatis 不会完全隐藏 SQL 语句，而是允许开发者直接编写 SQL，并通过配置文件或注解实现 SQL 与对象的绑定。

形象比喻：
可以将 MyBatis 想象成一位“翻译官”。它不会替你直接生成 SQL（如“全自动翻译”），而是根据你的指令（Java 方法或 XML 配置），将数据库操作的“语言”（SQL）与 Java 对象的“语言”（类）进行精准转换。这种设计既保留了 SQL 的灵活性，又避免了手动操作的繁琐。

1.2 MyBatis 的核心优势

• 灵活的 SQL 控制：开发者可直接编写和优化 SQL，适合复杂查询场景。
• 轻量级架构：无冗余的自动映射逻辑，性能优于全 ORM 框架。
• 支持多种数据库：通过 JDBC 适配器兼容 MySQL、Oracle、PostgreSQL 等主流数据库。
• 易学易用：学习曲线平缓，适合从零开始构建数据访问层。

二、MyBatis 的核心组件解析

2.1 核心组件概述

MyBatis 的运行依赖以下四个核心组件：

1. SqlSessionFactory：数据库连接的“工厂”，负责创建 SqlSession 实例。
2. SqlSession：单次数据库操作的“会话”，包含执行 SQL、提交事务等方法。
3. Mapper：定义 SQL 与 Java 方法的映射关系，支持 XML 或注解配置。
4. Configuration：框架全局配置，包含数据源、类型别名、插件等设置。

表格：核心组件的功能对比

2.2 核心组件的协作流程

1. 创建 SqlSessionFactory：通过读取 mybatis-config.xml 或 Java 配置类生成。
2. 获取 SqlSession：调用 SqlSessionFactory.openSession() 开始数据库操作。
3. 执行 SQL：通过 SqlSession 的 selectOne()、insert() 等方法触发 Mapper 中定义的 SQL。
4. 提交或回滚：根据事务需求调用 commit() 或 rollback()。

流程图示意（文字描述）：

配置文件 → 创建工厂 → 生成会话 → 执行 SQL → 提交事务  

三、快速上手：MyBatis 的配置与使用

3.1 环境搭建

3.1.1 添加依赖

在 Maven 项目中，需引入 MyBatis 核心库和数据库驱动：

<dependencies>  
    <dependency>  
        <groupId>org.mybatis</groupId>  
        <artifactId>mybatis</artifactId>  
        <version>3.5.13</version>  
    </dependency>  
    <dependency>  
        <groupId>mysql</groupId>  
        <artifactId>mysql-connector-java</artifactId>  
        <version>8.0.29</version>  
    </dependency>  
</dependencies>  

3.1.2 配置 mybatis-config.xml

创建配置文件 src/main/resources/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>  
    <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?useSSL=false"/>  
                <property name="username" value="root"/>  
                <property name="password" value="123456"/>  
            </dataSource>  
        </environment>  
    </environments>  
    <mappers>  
        <mapper resource="mapper/UserMapper.xml"/>  
    </mappers>  
</configuration>  

3.2 编写第一个 Mapper

3.2.1 定义实体类

public class User {  
    private Integer id;  
    private String name;  
    private Integer age;  
    // 省略 getter/setter 方法  
}  

3.2.2 创建 XML 映射文件

在 src/main/resources/mapper/UserMapper.xml 中编写 SQL：

<?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="selectUserById" resultType="User">  
        SELECT * FROM user WHERE id = #{id}  
    </select>  
</mapper>  

3.2.3 编写接口并测试

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

// 测试代码  
public class Main {  
    public static void main(String[] args) throws IOException {  
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");  
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream);  
        try (SqlSession session = factory.openSession()) {  
            UserMapper mapper = session.getMapper(UserMapper.class);  
            User user = mapper.selectUserById(1);  
            System.out.println(user.getName());  
        }  
    }  
}  

四、MyBatis 的高级特性与最佳实践

4.1 动态 SQL

动态 SQL 是 MyBatis 的核心优势之一，通过 <if>、<choose>、<foreach> 等标签，可灵活构建复杂查询。

案例：带条件查询的用户列表

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

4.2 一级缓存与二级缓存

• 一级缓存（默认启用）：SqlSession 级别的缓存，同一会话内相同查询结果自动缓存。
• 二级缓存（需显式配置）：跨 SqlSession 的全局缓存，通过 <cache> 标签开启。

配置二级缓存：

<mapper namespace="com.example.mapper.UserMapper">  
    <cache/>  
    <!-- 其他 SQL 语句 -->  
</mapper>  

4.3 分页优化

使用 RowBounds 或 LIMIT 关键字实现分页：

// 方法一：RowBounds（适用于简单场景）  
List<User> users = session.selectList("selectUsers", null, new RowBounds(0, 10));  

// 方法二：直接编写带 LIMIT 的 SQL  
<select id="selectUsers" resultType="User">  
    SELECT * FROM user LIMIT #{offset}, #{limit}  
</select>  

4.4 插件开发

MyBatis 通过插件机制扩展功能。例如，拦截器可实现日志打印或性能监控：

@Intercepts({@Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})})  
public class LoggingInterceptor implements Interceptor {  
    @Override  
    public Object intercept(Invocation invocation) throws Throwable {  
        System.out.println("SQL 执行前的日志");  
        Object result = invocation.proceed();  
        System.out.println("SQL 执行后的日志");  
        return result;  
    }  
}  

五、常见问题与解决方案

5.1 连接池配置错误

问题：数据库连接失败，提示“Connection refused”。
解决方案：

1. 检查 mybatis-config.xml 中的数据库 URL、用户名和密码是否正确。
2. 确保数据库服务已启动，且端口（如 MySQL 默认 3306）可访问。

5.2 SQL 语句未生效

问题：执行插入或更新操作后，数据库无变化。
解决方案：

• 确保调用 SqlSession.commit() 提交事务（默认为手动提交模式）。
• 检查 SQL 语句的语法是否正确，例如字段名是否与数据库表一致。

5.3 性能优化建议

• 批量操作：使用 SqlSession 的 insert() 或 update() 批量插入数据。
• 延迟加载：通过 <select> 标签的 fetchType="lazy" 实现关联查询的延迟加载。

六、结论

MyBatis 通过其灵活的 SQL 映射能力和轻量级架构，成为 Java 开发者处理数据库操作的利器。无论是快速开发小型项目，还是优化大型系统的数据访问层，它都能提供高效的解决方案。本文从基础概念、核心组件到高级特性，逐步展示了 MyBatis 的使用方法与最佳实践。

下一步行动建议：

1. 尝试将现有项目中的 JDBC 代码迁移到 MyBatis，体验其代码简洁性。
2. 探索 MyBatis-Plus 等扩展框架，进一步简化开发流程。
3. 结合 Spring Boot，利用其自动配置特性快速集成 MyBatis。

掌握 MyBatis 的核心思想，不仅能提升开发效率，更能让你在数据库交互的设计中游刃有余。