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

Commit写错了

2025-06-22 09:00

阅读 334

开篇：MyBatis 是什么，能干什么？

大家好！如果你是 Java 初学者，并且开始接触到数据库操作相关的开发工作，那么你可能已经听说过 JDBC、Hibernate、Spring Data JPA 等技术。今天我们要介绍的是另一个非常重要但也相对轻量级的工具——MyBatis。

那么问题来了：

MyBatis 是什么？

简短地说：MyBatis 是一个基于 Java 的持久层框架，它的主要作用就是帮助我们更方便地操作数据库。换句话说，你可以通过它来执行 SQL 语句，并将结果自动映射到 Java 对象中，而不必手动解析 ResultSet。

那它和传统的 JDBC 有什么区别？

JDBC 是 Java 自带的操作数据库的标准 API，但它使用起来比较繁琐。比如每执行一条 SQL 都要连接数据库、获取 Statement、处理异常等等，这些重复性的工作会让我们写很多冗余代码。

而 MyBatis 把这些工作“封装”了起来，让你可以专注于写 SQL 和业务逻辑本身。

第一步：环境准备

在学习 MyBatis 前，你需要准备好以下开发环境：

所需工具清单：

工具名称	版本建议
JDK	1.8 或以上
IntelliJ IDEA（或任意 IDE）	社区版即可
MySQL	5.x / 8.x
Maven	最新版（3.6+）

步骤一：安装并启动 MySQL

你可以从 MySQL官网下载安装包进行安装，也可以使用 Docker 快速部署（适合有经验的同学）。

安装完成后，确保你的数据库服务正在运行，并记住用户名（默认 root）和密码。

创建测试数据库和表

CREATE DATABASE mybatis_demo;

USE mybatis_demo;

CREATE TABLE user (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(255),
  email VARCHAR(255)
);

INSERT INTO user (name, email) VALUES ('张三', 'zhangsan@example.com');

这样我们就准备好了用于测试的数据环境。

步骤二：新建 Maven 项目

使用 IntelliJ IDEA 新建一个 Maven 项目，或者使用命令行创建：

mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-demo -DarchetypeArtifactId=maven-archetype-quickstart

然后打开 pom.xml 文件，添加 MyBatis 和 MySQL 驱动的依赖：

<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.30</version>
  </dependency>
</dependencies>

保存文件后，Maven 会自动下载相关依赖。

核心概念：MyBatis 的关键要素有哪些？

虽然我们刚接触，但 MyBatis 的核心并不复杂。我们可以先简单了解几个必须掌握的概念：

1. `SqlSessionFactory`

这是整个 MyBatis 的“源头”，用于创建数据库连接会话。它是一个工厂类，通常是通过配置文件加载出来的。

2. `SqlSession`

代表一次数据库会话，所有对数据库的操作都需要通过它来进行。例如：查询、插入、删除、更新等。

3. Mapper 映射器

Mapper 可以是一个接口或 XML 文件，用来定义 SQL 语句及对应的 Java 对象之间的映射关系。MyBatis 会根据这个映射，自动将查询结果转换成 Java 对象。

4. 全局配置文件 `mybatis-config.xml`

这个文件用于配置数据库连接池、事务管理方式、插件等全局设置。

实战项目：做一个最简单的“用户查询”功能

接下来我们用一个完整的示例带你理解 MyBatis 的使用流程。

步骤一：编写实体类 `User.java`

package com.example.model;

public class User {
    private Integer id;
    private String name;
    private String email;

    // Getters and Setters
    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }

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

    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }

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

步骤二：创建 Mapper 接口 `UserMapper.java`

package com.example.mapper;

import com.example.model.User;
import java.util.List;

public interface UserMapper {
    List<User> getAllUsers();  // 查询所有用户
    User getUserById(int id);   // 根据ID查询单个用户
}

步骤三：创建 Mapper XML 文件 `UserMapper.xml`

在 resources 目录下创建一个目录结构和 Java 包一致的路径，如：

src/main/resources/com/example/mapper/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">

<mapper namespace="com.example.mapper.UserMapper">
  <select id="getAllUsers" resultType="com.example.model.User">
    SELECT * FROM user
  </select>

  <select id="getUserById" parameterType="int" resultType="com.example.model.User">
    SELECT * FROM user WHERE id = #{id}
  </select>
</mapper>

解释一下这里的标签含义：

namespace: 要绑定的接口名。
<select>: 定义一个查询语句。
resultType: 查询结果映射为哪种 Java 类型。
#{id}: 表示参数占位符。

步骤四：配置 `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"/>
        <property name="username" value="root"/>
        <property name="password" value="your_password"/>
      </dataSource>
    </environment>
  </environments>

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

记得替换上面的 your_password 为你自己的数据库密码！

步骤五：编写主程序入口 `App.java`

package com.example;

import com.example.model.User;
import com.example.mapper.UserMapper;
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 App {
    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();
            for (User user : users) {
                System.out.println(user);
            }

            // 根据ID查询用户
            User user = mapper.getUserById(1);
            System.out.println("根据ID查到：" + user);
        }
    }
}

运行结果应该类似如下：

User{id=1, name='张三', email='zhangsan@example.com'}
根据ID查到：User{id=1, name='张三', email='zhangsan@example.com'}

恭喜你完成了第一个 MyBatis 查询程序！

常见问题解答（FAQ）

❓Q1：运行时报错说找不到 mapper.xml 文件？

可能原因：

XML 文件没有放到 resources 目录中。
文件路径与 mapper 中的 namespace 不匹配。
构建时没有正确复制资源文件。

✅解决方案：检查 maven 配置是否包含资源过滤，确保 resources 目录下的文件被正确编译进 target/classes 中。

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
    </resource>
  </resources>
</build>

❓Q2：SQL 查询返回为空对象？

可能原因：

数据库字段名与 Java Bean 属性名不一致。
没有设置别名或 resultMap 映射。

✅解决方案：使用别名或在 XML 中显式定义列与属性的映射：

<select id="getUserById" resultType="com.example.model.User">
  SELECT id as id, name as name, email as email FROM user WHERE id = #{id}
</select>

❓Q3：如何调试 SQL 语句？

✅解决方案：可以在 mybatis-config.xml 中加入日志配置（比如使用 log4j 或 SLF4J），输出 SQL 日志信息。

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

你现在已经掌握了 MyBatis 的基本使用，接下来推荐继续学习以下内容：

✅ 必须掌握的内容：

动态 SQL
- <if> <choose> <where> <foreach> 等标签的使用
- 动态拼接 SQL 的能力非常实用
ResultMap 高级映射
- 复杂类型、嵌套对象的映射
- 一对一、一对多关系的处理
注解式开发
- 不用 XML 写 SQL，用 Java 注解实现 Mapper
- 更适合小型项目或快速开发
MyBatis 与 Spring 集成
- 在真实企业项目中，几乎不会单独使用 MyBatis，而是配合 Spring 使用
- 学会集成有助于进入实战阶段

总结

这篇文章我们从零开始，一步步搭建了 MyBatis 的开发环境，完成了一个完整的数据库查询小项目，并讲解了一些初学者常遇到的问题和解决方法。希望你能亲手敲一遍代码，在实际操作中加深理解。

坚持下去，你会慢慢发现，MyBatis 并不像一开始看起来那么复杂。它既保留了 SQL 的灵活性，又提升了代码的可维护性和开发效率，是一款非常适合 Java 后端开发者入门的优秀框架！

如果你觉得这篇文章对你有帮助，欢迎点赞、分享，也欢迎留言提问。我们下次再见！🎉

标签:综合区块链

最热最新

暂无评论

为你推荐

暂无相关推荐

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

开篇：MyBatis 是什么，能干什么？

那么问题来了：

第一步：环境准备

所需工具清单：

步骤一：安装并启动 MySQL

创建测试数据库和表

步骤二：新建 Maven 项目

核心概念：MyBatis 的关键要素有哪些？

1. `SqlSessionFactory`

2. `SqlSession`

3. Mapper 映射器

4. 全局配置文件 `mybatis-config.xml`

实战项目：做一个最简单的“用户查询”功能

步骤一：编写实体类 `User.java`

步骤二：创建 Mapper 接口 `UserMapper.java`

步骤三：创建 Mapper XML 文件 `UserMapper.xml`

步骤四：配置 `mybatis-config.xml`

步骤五：编写主程序入口 `App.java`

运行结果应该类似如下：

常见问题解答（FAQ）

❓Q1：运行时报错说找不到 mapper.xml 文件？

❓Q2：SQL 查询返回为空对象？

❓Q3：如何调试 SQL 语句？

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

✅ 必须掌握的内容：

总结

评论 0

为你推荐

精选内容

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

开篇：MyBatis 是什么，能干什么？

那么问题来了：

第一步：环境准备

所需工具清单：

步骤一：安装并启动 MySQL

创建测试数据库和表

步骤二：新建 Maven 项目

核心概念：MyBatis 的关键要素有哪些？

1. SqlSessionFactory

2. SqlSession

3. Mapper 映射器

4. 全局配置文件 mybatis-config.xml

实战项目：做一个最简单的“用户查询”功能

步骤一：编写实体类 User.java

步骤二：创建 Mapper 接口 UserMapper.java

步骤三：创建 Mapper XML 文件 UserMapper.xml

步骤四：配置 mybatis-config.xml

步骤五：编写主程序入口 App.java

运行结果应该类似如下：

常见问题解答（FAQ）

❓Q1：运行时报错说找不到 mapper.xml 文件？

❓Q2：SQL 查询返回为空对象？

❓Q3：如何调试 SQL 语句？

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

✅ 必须掌握的内容：

总结

评论 0

为你推荐

相关推荐

精选内容

1. `SqlSessionFactory`

2. `SqlSession`

4. 全局配置文件 `mybatis-config.xml`

步骤一：编写实体类 `User.java`

步骤二：创建 Mapper 接口 `UserMapper.java`

步骤三：创建 Mapper XML 文件 `UserMapper.xml`

步骤四：配置 `mybatis-config.xml`

步骤五：编写主程序入口 `App.java`