MyBatis基础教程：Java持久层框架入门

---

开篇：MyBatis是什么？用来做什么？

在开发数据库驱动的应用程序时，我们经常需要将Java对象与数据库表进行交互。例如，从数据库读取数据并将其转换为Java对象，或将Java对象保存到数据库中。这个过程被称为持久化操作。

MyBatis 是一个流行的 Java 持久层框架，它帮助开发者简化了 Java 应用程序与数据库之间的交互。它的主要功能是通过配置文件或注解将 SQL 语句映射到 Java 对象，从而让开发者更方便地执行数据库操作。

简单来说，MyBatis 的作用就是：

• 帮助你轻松编写和管理 SQL 语句。
• 自动将查询结果转化为 Java 对象。
• 提供高效的数据存储和检索功能。

如果你正在学习 Java 后端开发，掌握 MyBatis 将会是一个非常重要的技能。

---

环境准备：搭建开发环境

在开始学习 MyBatis 之前，我们需要准备好开发环境。以下是详细的步骤：

1. 安装 JDK

确保你的电脑上已经安装了 JDK 8 或更高版本。可以通过以下命令检查：

java -version

如果没有安装，请前往 Oracle 官网 或 OpenJDK 官网 下载并安装。

2. 安装 IDE

推荐使用 IntelliJ IDEA 或 Eclipse。这里以 IntelliJ IDEA 为例。

3. 创建 Maven 项目

Maven 是一种常用的构建工具，可以帮我们管理项目的依赖库。

1. 打开 IntelliJ IDEA，选择 File > New > Project。
2. 选择 Maven，点击下一步。
3. 输入项目名称，例如 mybatis-demo，点击完成。

4. 添加 MyBatis 和数据库驱动依赖

在 pom.xml 文件中添加以下依赖：

<dependencies>
    <!-- MyBatis 核心库 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.11</version>
    </dependency>

    <!-- MySQL 数据库驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
    </dependency>
</dependencies>

保存后，IDEA 会自动下载相关依赖。

5. 配置 MySQL 数据库

确保你已经安装了 MySQL，并创建了一个数据库。例如：

CREATE DATABASE mybatis_demo;
USE mybatis_demo;

CREATE TABLE user (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    age INT
);

INSERT INTO user (name, age) VALUES ('Alice', 25);
INSERT INTO user (name, age) VALUES ('Bob', 30);

---

核心概念：理解 MyBatis 的关键点

在深入实战之前，先了解以下几个核心概念：

1. SqlSessionFactory

SqlSessionFactory 是 MyBatis 的核心组件之一，用于创建 SqlSession 实例。它负责加载配置文件（如 mybatis-config.xml）并初始化全局设置。

2. SqlSession

SqlSession 是 MyBatis 提供的一个接口，用于执行 SQL 语句、获取映射器和管理事务。

3. Mapper

Mapper 是 MyBatis 中的映射文件或接口，定义了 SQL 语句与 Java 方法的对应关系。

4. 配置文件

MyBatis 使用 XML 文件来配置数据库连接信息、SQL 映射规则等内容。

---

实战项目：创建一个简单的用户管理系统

接下来，我们将一步步创建一个简单的用户管理系统，实现增删改查功能。

1. 创建实体类

在 src/main/java/com/example/demo 目录下创建一个名为 User.java 的实体类：

package com.example.demo;

public class User {
    private int id;
    private String name;
    private int age;

    // Getter 和 Setter 方法
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }

    @Override
    public String toString() {
        return "User{id=" + id + ", name='" + name + "', age=" + age + "}";
    }
}

2. 编写 MyBatis 配置文件

在 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/mybatis_demo?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="your_password"/>
            </dataSource>
        </environment>
    </environments>

    <!-- Mapper 映射文件 -->
    <mappers>
        <mapper resource="UserMapper.xml"/>
    </mappers>
</configuration>

3. 编写 Mapper 文件

在 src/main/resources 目录下创建一个名为 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">


![微服务架构示意图-2](https://code-guide.oss.shanghai.autogptai.club/common/file/download?name=date2025061113/61bca0e2-3879-41bd-964f-1ad0f2250022.jpg)


<mapper namespace="com.example.demo.UserMapper">

    <!-- 查询所有用户 -->
    <select id="getAllUsers" resultType="com.example.demo.User">
        SELECT * FROM user
    </select>

    <!-- 根据 ID 查询用户 -->
    <select id="getUserById" parameterType="int" resultType="com.example.demo.User">
        SELECT * FROM user WHERE id = #{id}
    </select>

    <!-- 插入新用户 -->
    <insert id="insertUser" parameterType="com.example.demo.User">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>

    <!-- 更新用户信息 -->
    <update id="updateUser" parameterType="com.example.demo.User">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>

    <!-- 删除用户 -->
    <delete id="deleteUser" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>

</mapper>

4. 创建 Mapper 接口

在 src/main/java/com/example/demo 目录下创建一个名为 UserMapper.java 的接口：

package com.example.demo;

import java.util.List;

public interface UserMapper {
    List<User> getAllUsers();
    User getUserById(int id);
    void insertUser(User user);
    void updateUser(User user);
    void deleteUser(int id);
}

5. 编写测试代码

在 src/main/java/com/example/demo 目录下创建一个名为 MainApp.java 的主类：

package com.example.demo;

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

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

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

        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);

            // 查询所有用户
            List<User> users = mapper.getAllUsers();
            System.out.println("所有用户:");
            for (User user : users) {
                System.out.println(user);
            }

            // 插入新用户
            User newUser = new User();
            newUser.setName("Charlie");
            newUser.setAge(28);
            mapper.insertUser(newUser);
            session.commit(); // 提交事务
            System.out.println("新增用户成功!");

            // 查询单个用户
            User userById = mapper.getUserById(3);
            System.out.println("根据 ID 查询用户: " + userById);

            // 更新用户信息
            userById.setAge(30);
            mapper.updateUser(userById);
            session.commit();
            System.out.println("更新用户成功!");

            // 删除用户
            mapper.deleteUser(3);
            session.commit();
            System.out.println("删除用户成功!");
        }
    }
}

运行 MainApp 类，观察控制台输出，确认功能是否正常。

---

常见问题及解决方案

1. 问题：无法连接数据库

   • 原因：可能是数据库 URL、用户名或密码错误。
   • 解决方法：检查 mybatis-config.xml 中的数据库配置是否正确。

2. 问题：Mapper 文件未加载

   • 原因：Mapper 文件路径错误或命名空间不匹配。
   • 解决方法：确保 mybatis-config.xml 中的 <mapper> 路径与实际文件位置一致。

3. 问题：SQL 语句报错

   • 原因：SQL 语法错误或字段名拼写错误。
   • 解决方法：检查 UserMapper.xml 中的 SQL 语句是否正确。

---

学习建议：下一步的学习路径

完成本教程后，你可以尝试以下进阶内容：

• 学习 MyBatis 的动态 SQL 功能，例如 <if>, <choose>, <foreach> 等。
• 探索 MyBatis 注解方式代替 XML 映射文件。
• 理解 MyBatis 的缓存机制及其优化技巧。
• 结合 Spring 框架，学习 MyBatis 与 Spring 的整合。

通过不断实践和探索，相信你会对 MyBatis 有更深刻的理解！