当前位置： 首页 > article >正文

MyBatis简明教程

article 2025/2/27 2:14:57

MyBatis 是一个用于简化数据库操作的持久层框架，它的核心思想是 将 SQL 与 Java 代码解耦，让开发者专注于 SQL 的编写，同时自动处理重复的数据库操作步骤。

一、核心思想：SQL 与 Java 解耦

传统 JDBC 需要开发者手动管理数据库连接、拼接 SQL 参数、处理查询结果集，代码重复且容易出错。MyBatis 通过以下方式简化：

  1. 用 XML 或注解定义 SQL：将 SQL 语句写在配置文件中，与 Java 代码分离。
  2. 自动映射结果集：将数据库查询结果自动转为 Java 对象，无需手动解析。

二、核心组件与流程

1. 配置文件
  • 全局配置文件（如 mybatis-config.xml）：配置数据库连接、事务管理、映射文件路径等。
  • 映射文件（如 UserMapper.xml）：定义 SQL 语句（如 <select>, <insert>）和结果映射规则。
2. 接口与映射绑定
  • 定义一个 Java 接口（如 UserMapper），接口方法与映射文件中的 SQL 一一绑定。
  • 动态代理机制：MyBatis 自动为接口生成代理对象，调用接口方法时，实际执行对应的 SQL。
3. 执行流程

假设调用 userMapper.getUserById(1)：

  1. 解析 SQL：找到 UserMapper.xml 中对应的 SQL，如 <select id="getUserById" ...>。
  2. 处理参数：将参数 1 自动设置到 SQL 中（如替换 #{id}）。
  3. 执行 SQL：通过 SqlSession（类似数据库连接）发送 SQL 到数据库。
  4. 结果映射：将查询结果自动转为 User 对象（根据字段名与属性名的匹配，或自定义规则）。

三、关键机制

1. 动态 SQL
  • 使用 <if>, <foreach> 等标签，根据条件动态拼接 SQL。
  • 示例：根据不同条件生成不同的查询语句。
2. 缓存机制
  • 一级缓存：默认开启，同一个 SqlSession 内的查询结果会被缓存，提高性能。
  • 二级缓存：跨 SqlSession 的缓存（需手动开启），减少数据库访问。
3. 执行器（Executor）
  • 负责执行 SQL，并封装结果。MyBatis 提供了简单执行器、重用执行器、批量执行器等，适应不同场景。

四、对比 JDBC 的优势

  • 代码简洁：无需手动管理连接、参数、结果集。
  • 灵活性高：直接编写 SQL，适合复杂查询。
  • 维护方便：SQL 集中管理，修改时无需改动 Java 代码。

五、通俗比喻

把 MyBatis 想象成一个 “智能翻译官”：

  1. 你告诉它：“我要查询 id=1 的用户”（调用 getUserById(1)）。
  2. 它查字典（映射文件）找到对应的 SQL。
  3. 把参数 1 翻译成数据库能理解的语言，执行查询。
  4. 最后将数据库返回的“外语结果”翻译成 Java 对象，交还给你。

六、入门案例

1. 环境搭建

首先，你需要在项目中引入 MyBatis 相关依赖。如果使用 Maven 构建项目，在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.6</version>
</dependency>

确保你的项目已经配置好数据库驱动依赖。

2. 配置文件

创建 MyBatis 的配置文件 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="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

3. 创建实体类

创建与数据库表对应的 Java 实体类，例如 User 类：

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

    // Getters and Setters
}

4. Mapper 接口和 XML 映射文件

定义一个接口，比如 UserMapper，并为其创建相应的 XML 映射文件。

UserMapper.java

public interface UserMapper {
    User selectUser(int id);
}

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="selectUser" parameterType="int" resultType="com.example.model.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

5. 使用 SqlSessionFactory

在代码中初始化 SqlSessionFactory 并获取 SqlSession 来执行操作。

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);
    User user = mapper.selectUser(1);
    System.out.println(user.getName());
}

以上是 MyBatis 入门的一个基本流程，包括环境搭建、配置文件编写、实体类创建、Mapper 接口及映射文件的定义以及如何通过 SqlSession 执行数据库操作。

七、Mapper 接口及其对应的 XML 映射文件之间的映射

在 MyBatis 中，Mapper 接口及其对应的 XML 映射文件之间的映射是一个非常核心的概念，它允许开发者以面向接口的方式进行数据库操作。下面是关于 Mapper 接口和 XML 映射文件如何关联及映射的详细介绍：

  1. 命名空间（Namespace）：XML 映射文件中的 namespace 属性必须与 Mapper 接口的全限定名完全一致。这是 MyBatis 用来将接口方法与 XML 文件中的 SQL 语句相匹配的关键。

  2. SQL 语句 ID：在 Mapper 接口中定义的方法名应该与 XML 映射文件中 <select>, <insert>, <update>, <delete> 标签的 id 属性值相同。这样 MyBatis 就能知道哪个接口方法对应于哪条 SQL 语句。

映射过程

当你调用 Mapper 接口中的一个方法时，MyBatis 执行以下步骤来找到并执行相应的 SQL 语句：

  • 解析 Mapper 接口：根据 Mapper 接口的全限定名找到对应的 XML 映射文件。
  • 查找 SQL 语句：在找到的 XML 映射文件中，通过接口方法名作为 id 查找对应的 SQL 语句。
  • 参数映射：如果接口方法有参数，则 MyBatis 会根据参数类型自动将 Java 对象转换为 JDBC 类型，并将其设置到 PreparedStatement 的参数中。
  • 执行 SQL 语句：使用由 SqlSession 创建的 PreparedStatement 来执行查询或更新操作。
  • 结果映射：从数据库获取的结果集将按照 XML 中指定的 resultType 或 resultMap 转换回 Java 对象，并返回给调用者。

示例

假设有一个名为 UserMapper 的接口和一个对应的 XML 映射文件 UserMapper.xml：

UserMapper.java

public interface UserMapper {
    User selectUser(int id);
}

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="selectUser" parameterType="int" resultType="com.example.model.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

在这个例子中，UserMapper 接口的全限定名是 com.example.mapper.UserMapper，这需要与 UserMapper.xml 文件中的 namespace 属性保持一致。同时，接口中的 selectUser 方法与 XML 文件中的 <select> 标签的 id 属性值相同，这意味着当调用 selectUser 方法时，MyBatis 会执行该 <select> 标签内的 SQL 语句。

这种机制使得 MyBatis 不仅易于使用，而且具有很强的灵活性和扩展性，非常适合用于构建数据驱动的应用程序。

八、各组件之间逻辑关系

在这里插入图片描述

1. 基本架构

MyBatis 主要由以下几个组件构成：

  • SqlSessionFactory：这是 MyBatis 的入口点。通过 SqlSessionFactoryBuilder 根据配置文件或配置类创建 SqlSessionFactory 实例。
  • SqlSession：代表一个与数据库执行 SQL 操作的会话。可以通过 SqlSessionFactory 获取 SqlSession 对象。
  • Mapper 接口和 XML 映射文件：Mapper 接口定义了对数据库操作的方法签名，而 XML 映射文件则提供了具体的 SQL 语句以及结果映射规则。

2. 工作流程

配置阶段
  • 读取配置：MyBatis 从 mybatis-config.xml 文件（或其他形式的配置）中读取全局配置信息，包括数据源、事务管理器等。
  • 加载映射文件：同时也会加载 Mapper 接口及其对应的 XML 映射文件，解析其中的 SQL 语句、参数映射、结果映射等内容。
运行阶段
  • 创建 SqlSessionFactory：基于配置信息，通过 SqlSessionFactoryBuilder 创建 SqlSessionFactory 实例。
  • 获取 SqlSession：通过 SqlSessionFactory 开启 SqlSession，它是 MyBatis 与数据库交互的核心对象。
  • 执行 SQL 语句：通过 SqlSession 获得 Mapper 接口的代理对象，调用其方法执行相应的 SQL 语句。
  • 处理结果集：SQL 执行后，MyBatis 会根据映射文件中的配置将结果集自动映射到 Java 对象中，并返回给调用者。
  • 提交或回滚事务：根据业务逻辑决定是否提交或回滚当前事务。
  • 关闭 SqlSession：在操作完成后，必须关闭 SqlSession 以释放资源。

3. 核心机制

  • 动态 SQL：MyBatis 支持动态生成 SQL 语句，可以根据不同的条件组合 SQL 片段，提高代码的灵活性和复用性。
  • 缓存机制：为了提高性能，MyBatis 提供了一级缓存（SqlSession 级别）和二级缓存（跨 SqlSession 共享），减少数据库访问次数。
  • 插件机制：MyBatis 允许通过插件扩展功能，比如分页、日志记录等。插件可以拦截四大对象（Executor、StatementHandler、ParameterHandler、ResultSetHandler）的行为。

通过上述过程，MyBatis 将复杂的 JDBC 操作封装起来，提供更加简洁易用的 API 给开发者，同时也保留了足够的灵活性和控制力，使得开发者可以根据需要定制化 SQL 和结果映射逻辑。


http://www.kler.cn/a/562531.html

相关文章：

  • es-head（es库-谷歌浏览器插件）
  • Git系列之Git Reset
  • 量子计算如何改变加密技术：颠覆与变革的前沿
  • MLops：可解释深度神经网络训练平台Neural Designer ®
  • HBase与传统数据库的区别：为什么选择它来处理大数据？
  • MySQL 根据条件多值更新
  • 中兴B863AV3.2-T／B863AV3.1-T2／B863AV3.1-T2K_电信高安_S905L3A-B_安卓9.0_线刷固件包
  • [250224] Yaak 2.0：Git集成、WebSocket支持、OAuth认证等 | Zstandard v1.5.7 发布
  • Redis面试知识点总结
  • 使用open-webui调用大模型
  • Android 常用命令和工具解析之存储相关
  • 【Elasticsearch】动态计算字段的几种方式
  • 【Win10】Anaconda + Pycharm 环境搭建教程
  • 网络基础知识-2
  • 神经网络发展简史：从感知机到通用智能的进化之路
  • 树莓派学习【2】开机自动启动程序的方法
  • 代码随想录算法训练营第十四天|226.翻转二叉树|101. 对称二叉树|104.二叉树的最大深度|111.二叉树的最小深度
  • vue自定义指令千分位
  • 记录一下用docker克隆某授权制定ip的环境恢复
  • Amazon Outposts：构建混合云的安全堡垒，让数据安全“零距离”