MyBatis：核心概念 + 环境搭建 + CRUD

MandalaO_O2026-05-21 14:38

一、简介

本文适合 Java 开发初学者，从零梳理 MyBatis 核心知识，包含环境搭建、配置详解、CRUD 实战、常见避坑，可直接用于学习、复习与项目开发。

二、MyBatis 基础概念与环境搭建

1. JDBC 痛点与 MyBatis 优势

在学习 MyBatis 之前，我们先回顾传统JDBC 开发的缺陷，这也是 MyBatis 诞生的核心原因。

JDBC 操作缺陷
  1. 资源频繁创建与释放，严重影响性能每次操作数据库都需要创建 Connection、Statement，用完直接关闭，频繁 IO 造成资源浪费。
  2. SQL 硬编码，维护成本极高SQL 语句直接写在 Java 代码中，修改 SQL 必须重新编译、打包、部署，无法灵活配置。
  3. 结果集解析繁琐，手动封装冗余 查询返回 ResultSet 后，需要手动getXxx()取值、手动 set 到实体类，代码量大且易出错。
  4. 代码冗余，开发效率低下连接、参数设置、结果解析大量重复代码，不符合开发规范。

典型 JDBC 冗余代码：

复制代码 
// 1. 加载驱动、建立连接
Class.forName("com.mysql.jdbc.Driver");
Connection conn = DriverManager.getConnection(url, user, pwd);
// 2. 编写SQL（硬编码）
String sql = "select * from user where id = ?";
PreparedStatement pstmt = conn.prepareStatement(sql);
// 3. 设置参数
pstmt.setInt(1, id);
// 4. 执行查询
ResultSet rs = pstmt.executeQuery();
// 5. 手动封装结果集
User user = null;
if(rs.next()){
    user = new User();
    user.setId(rs.getInt("id"));
    user.setUsername(rs.getString("username"));
}
MyBatis 优势与解决方案

MyBatis 是一款优秀的持久层框架，底层依然基于 JDBC，但做了高度封装：

  1. 连接池管理：避免频繁创建 / 释放连接，大幅提升性能；
  2. SQL 与 Java 代码解耦：SQL 统一写在 XML 配置文件中，修改无需编译 Java；
  3. 自动结果集映射：自动将 ResultSet 封装为实体对象，无需手动解析；
  4. 参数自动映射 ：支持简单类型、实体类参数，直接使用#{}占位符；
  5. 轻量级、学习成本低：相比 Hibernate，MyBatis 更灵活、可控性更强。

2. 项目环境配置

我们以Maven 项目为例，搭建标准 MyBatis 开发环境。

（1）Maven 依赖导入

在pom.xml中导入核心依赖：MyBatis 核心包、MySQL 驱动、日志包、Junit 测试。

复制代码 
<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>5.1.49</version>
    </dependency>
    <!-- 日志包 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    <!-- 测试包 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>
（2）MyBatis 核心配置文件（sqlMapConfig.xml）

在resources目录下创建核心配置文件，配置数据源、事务、加载映射文件。

复制代码 
<?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>
    <!-- 环境配置：默认使用development -->
    <environments default="development">
        <environment id="development">
            <!-- 事务管理：JDBC事务 -->
            <transactionManager type="JDBC"/>
            <!-- 数据源：POOLED连接池 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo?serverTimezone=Asia/Shanghai&amp;useSSL=false&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="abc123"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 加载Mapper映射文件 -->
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>
（3）项目标准结构
复制代码 
src/main/java
  com.qcby
    ├── dao/          DAO接口层
    ├── entity/       实体类
src/main/resources
  ├── mapper/         Mapper XML映射文件
  ├── sqlMapConfig.xml  MyBatis核心配置

三、核心配置与映射关系

1. 实体类与 Mapper 映射

MyBatis 实现自动封装的前提：数据库表 ↔ 实体类 严格映射。

（1）实体类编写规范
  1. 类属性名 与 数据库表字段名完全一致；
  2. 必须提供无参构造；
  3. 必须生成getter/setter；
  4. 必须重写toString() 方便测试打印。

User 实体类示例：

复制代码 
public class User {
    private Integer id;
    private String username;
    private String sex;
    private Date birthday;
    private String address;

    // 无参构造
    public User(){}
    // getter/setter
    // toString()
}
（2）DAO 接口与 XML 绑定规则

MyBatis 采用接口代理模式开发，无需编写实现类：

  1. 创建 DAO 接口（如UserDao.java）；
  2. XML 文件通过namespace绑定接口全类名；
  3. XML 中 SQL 标签的id 必须与 接口方法名完全一致；
  4. parameterType/resultType 与方法参数、返回值匹配。

接口示例：

复制代码 
public interface UserDao {
    List<User> findAll();
    User findUserById(Integer id);
}

XML 绑定示例：

复制代码 
<!-- namespace：绑定接口全限定名 -->
<mapper namespace="com.qcby.dao.UserDao">
    <!-- id：与接口方法名一致 -->
    <select id="findAll" resultType="com.qcby.entity.User">
        select * from user order by id desc
    </select>
</mapper>

2. 参数与结果映射

（1）参数传递（parameterType）

用于指定 SQL 入参类型，支持：

  • 基本类型：Integer、String
  • 实体类型：com.qcby.entity.User
  • 取值语法：#{属性名} 安全占位符，防 SQL 注入

xml

复制代码 
<select id="findUserById" parameterType="Integer" resultType="com.qcby.entity.User">
    select * from user where id = #{id}
</select>
（2）结果集封装（resultType）

指定 SQL 返回值类型：

  • 查询单条数据：直接写实体类全类名
  • 查询多条数据 ：依然写实体类，MyBatis 自动封装为List<实体>

示例：查询所有用户xml

复制代码 
<select id="findAll" resultType="com.qcby.entity.User">
    select * from user
</select>

四、增删改查（CRUD）实战

1. 查询操作（Select）

查询是 MyBatis 最常用操作，分为全量查询、精确查询、模糊查询。

（1）全量查询 findAll
复制代码 
<select id="findAll" resultType="com.qcby.entity.User">
    select * from user order by id desc;
</select>

接口方法：

复制代码 
List<User> findAll();
（2）条件查询：根据 ID 查询（单条结果）
复制代码 
<select id="findUserById" parameterType="Integer" resultType="com.qcby.entity.User">
    select * from user where id = #{id};
</select>

接口方法：

复制代码 
User findUserById(Integer id);
（3）模糊查询：根据用户名模糊匹配

重点：like 必须使用 concat 拼接，避免 SQL 注入

xml

复制代码 
<select id="findUserByUserName" parameterType="String" resultType="com.qcby.entity.User">
    select * from user where username like concat('%', #{username}, '%');
</select>

接口方法：

复制代码 
List<User> findUserByUserName(String username);
（4）字段映射异常处理

常见问题 ：查询结果部分字段为null根本原因 ：实体类属性名 ≠ 数据库列名解决方案：

  1. 统一名称（推荐）
  2. 使用resultMap手动映射

2. 增删改操作（Insert/Update/Delete）

增删改属于写操作 ，必须注意：必须手动提交事务 session.commit()。

（1）插入数据 insert
复制代码 
<insert id="insert" parameterType="com.qcby.entity.User">
    insert into user(username,sex,birthday,address)
    values(#{username},#{sex},#{birthday},#{address});
</insert>

接口方法：

复制代码 
int insert(User user);
（2）修改数据 update

必须传入包含 id的实体对象

复制代码 
<update id="update" parameterType="com.qcby.entity.User">
    update user 
    set username=#{username},sex=#{sex},birthday=#{birthday},address=#{address}
    where id=#{id};
</update>
（3）删除数据 delete
复制代码 
<delete id="delete" parameterType="Integer">
    delete from user where id=#{id};
</delete>
（4）事务提交机制

查询不需要提交事务；增删改必须提交！

复制代码 
@Test
public void addUser(){
    User user = new User();
    user.setUsername("张三");
    user.setSex("男");
    // 执行插入
    userDao.insert(user);
    // 必须提交事务
    session.commit();
}

五、测试工具类（通用版）

为了简化测试，可封装 MyBatis 工具类：

复制代码 
public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;
    static{
        try {
            String resource = "sqlMapConfig.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 获取SqlSession
    public static SqlSession getSession(){
        return sqlSessionFactory.openSession(true); // 自动提交事务
    }
}
相关推荐
雪芽蓝域zzs4 小时前
第 1 章：IDEA 创建 SpringBoot3.5.16 Maven 项目
java·maven·intellij-idea
golang学习记4 小时前
IDEA 开始换芯，发布全新AI版终端
java·人工智能·intellij-idea
vipxieliang4 小时前
ValidX 正则表达式预编译优化：Pattern 复用策略
java·spring boot·后端
雪芽蓝域zzs4 小时前
第 2 章：整合 MySQL + MyBatis，搭建数据库基础、实体类、Mapper、测试查询
数据库·mysql·mybatis
Wang's Blog4 小时前
Java 项目实战：交友项目 - FastDFS 工作原理
java·大数据·交友
Wang's Blog4 小时前
Java 项目实战：交友项目 - 保存访客记录
java·开发语言·交友
liangbo74 小时前
Spring系列01：IoC 与 DI 到底解决了什么
java·spring
江湖中的阿龙4 小时前
Oracle 紧急安全警报：Java 9.1 分漏洞 CVE-2026-91403，撤销对 eMudhra 风险证书的信任
java·安全·oracle
挖掘狂人5 小时前
缓存和数据库的一致性，别停在 “延时双删”
java·后端·程序员
codigger5 小时前
缓存和数据库的一致性，别停在 “延时双删”
java·后端·程序员·后端开发
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04几个好用的ip纯净度检测网站05苹果iPA游戏软件资源下载网站06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战08如何新建文件夹？ 电脑新建文件夹的4种方法09Dify：一站式AI应用开发平台全解析与Windows部署指南10Android 屏幕适配系列开篇：核心概念、官方机制与主流方案