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

开篇：MyBatis是什么？

在Java开发中，有一个很常见的需求：把程序中的数据保存到数据库里，或者从数据库中读取出来。

比如你写了一个学生管理系统，学生的信息（姓名、年龄、性别）都得保存到数据库里。这个时候就需要一个“中间人”来帮助你和数据库打交道，MyBatis就是这样的工具。

简单来说：
MyBatis 是一个 Java 的持久层框架，可以帮助我们简化与数据库的交互操作。它不像传统的 JDBC 那样需要写很多模板代码，但它也不像完全自动化的 ORM 框架那样“黑盒”，它给了开发者更多的控制权。

---

环境准备：搭建你的第一个 MyBatis 项目

步骤一：安装 Java 开发环境

你需要确保以下环境已安装：

• JDK 1.8 或更高版本
• Maven（用于依赖管理）
• IDE（推荐 IntelliJ IDEA）

新手建议使用 IntelliJ IDEA 社区版，免费且功能强大，支持自动补全和代码提示。

步骤二：创建一个 Maven 项目

打开 IntelliJ IDEA，选择 Create New Project → Maven → 勾选 Create from archetype → maven-archetype-quickstart，然后一路下一步完成项目创建。

项目结构如下：

mybatis-demo/
├── pom.xml
└── src/
    └── main/
        └── java/
            └── com.example.demo/
                └── App.java

步骤三：添加 MyBatis 和数据库驱动依赖

编辑 pom.xml 文件，加入以下内容：

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

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

保存文件后，Maven 会自动下载所需的依赖包。

---

核心概念：用通俗的语言解释关键术语

什么是“持久层”？

你可以把它理解成一个“存东西的地方”。你的 Java 对象（例如一个 Student 类的对象）想要长期保存下去，就需要通过某种方式存储到数据库里，这个过程就是在“持久层”中完成的。

什么是 ORM？

ORM 全称是 Object Relational Mapping，即对象关系映射。
简单点说：它是让你能用 Java 对象去对应数据库表的一种技术。

例如：

• Java 类 Student 对应数据库表 student
• 类的属性如 name 对应表字段 name

MyBatis 的核心组件

组件名称	功能说明
SqlSessionFactory	用来创建会话工厂
SqlSession	数据库交互的核心接口
Mapper 接口	用来定义数据库操作方法
XML 映射文件	定义 SQL 语句和 Java 对象的映射

---

实战项目：实现一个简单的查询功能

我们来做一个小项目：用 MyBatis 查询数据库中的所有学生信息，并打印出来。

步骤一：准备数据库和数据

假设我们已经有一个数据库名叫 school，里面有一张 student 表，建表语句如下：

CREATE TABLE student (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100),
    age INT
);

插入一些测试数据：

INSERT INTO student (name, age) VALUES ('张三', 18), ('李四', 20);

记得先启动 MySQL 服务，并配置用户名密码为 root/root，或者自己修改为你自己的数据库信息。

步骤二：创建实体类 Student

在 src/main/java/com/example/demo 下创建一个 Java 类：

package com.example.demo;

public class Student {
    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 "Student{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

步骤三：创建 Mapper 接口和 XML 映射文件

创建 StudentMapper.java

package com.example.demo;

import java.util.List;

public interface StudentMapper {
    List<Student> getAllStudents();
}

创建 StudentMapper.xml

在 resources 目录下新建文件夹结构：com/example/demo，并在其中创建 StudentMapper.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.demo.StudentMapper">
    <select id="getAllStudents" resultType="com.example.demo.Student">
        SELECT * FROM student
    </select>
</mapper>

步骤四：配置 MyBatis 的全局配置文件 mybatis-config.xml

在 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/school"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="com/example/demo/StudentMapper.xml"/>
    </mappers>
</configuration>

步骤五：编写主程序调用接口

修改 App.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.InputStream;
import java.util.List;

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

        // 打开一次会话
        try (SqlSession session = sqlSessionFactory.openSession()) {
            // 获取 Mapper 接口的实现类
            StudentMapper mapper = session.getMapper(StudentMapper.class);

            // 调用方法执行查询
            List<Student> students = mapper.getAllStudents();

            // 输出结果
            for (Student s : students) {
                System.out.println(s);
            }
        }
    }
}

运行程序，你会看到输出类似如下内容：

Student{id=1, name='张三', age=18}
Student{id=2, name='李四', age=20}

恭喜！你已经完成了第一个 MyBatis 小项目！

---

常见问题解答

Q：报错 “No such method or field in class...”

A：通常是因为 XML 中的 resultType 或 namespace 写错了路径，请检查是否与 Java 类匹配。

Q：连接不上数据库怎么办？

A：请确认你的数据库正在运行，mybatis-config.xml 中的地址、端口、用户名和密码是否正确。

Q：MyBatis 为什么不用像 JDBC 一样写很多代码？

A：因为它帮你封装了大量重复性的工作，例如获取连接、创建 Statement、处理结果集等，让你专注于业务逻辑本身。

---

学习建议：下一步该学什么？

掌握 MyBatis 基础只是第一步。接下来可以学习：

• 参数传递：如何传入单个或多个参数给 SQL？
• 动态 SQL：根据条件拼接不同的 SQL 语句（如 <if>、<choose>）
• 关联查询：一对一、一对多查询怎么实现？
• 事务管理：如何手动控制提交和回滚？
• 注解方式：不用 XML 文件也能写 MyBatis？

建议边学边做小项目练习，遇到问题不要怕查资料，反复实践是最好的老师。

---

结语：
MyBatis 虽然是一个轻量级框架，但它非常灵活，适合深入理解数据库和 Java 之间的交互机制。希望这篇教程能带你在 Java 后端世界迈出坚实的一步！

如有疑问，欢迎留言或继续提问，我会尽力为你解答 😊