Mybatis的应用及部分特性
初识Mybatis
Mybatis的概念
MyBatis 是一个Java 持久层框架，核心作用是简化数据库操作，把 SQL 和 Java 代码解耦。
ORM框架
MyBatis是一个ORM 框架
所谓ORM 框架，就是把数据库里的表、字段、关系，映射成编程语言里的类、属性、对象引用，从而让我们用“面向对象”的方式去操作关系型数据库，而不用写大量繁复的 JDBC/SQL。
简而言之，半自动化ORM，将SQL与Java对象映射，不自动生成SQL，只负责把“你写的 SQL”和“你写的 Java 对象”精准地对接起来，半自动化 ORM 是“SQL 与 Java 对象之间的翻译官”。
核心组件
SqlSessionFactory
作用： MyBatis 的核心工厂，负责创建和管理 SqlSession 实例。
特点：
- 全局单例：在整个应用中只需要一个实例，线程安全。
- 初始化：加载 MyBatis 配置文件、解析映射文件，初始化数据库连接池等资源。
功能： 通过 openSession() 方法创建 SqlSession 实例，用于执行 SQL 操作。
SqlSession
作用：MyBatis 的一个会话对象，用于执行 SQL 操作。
特点：
- 线程不安全：每次请求或操作数据库时需要创建一个新的实例，用完后必须关闭。
- 功能：提供 crud等方法，用于执行 SQL 语句。它还管理事务（提交或回滚）。
- 生命周期：通常与一个请求或一个业务操作绑定，用完即关闭。
Executor
作用：它是 SqlSession的底层执行器，负责执行 SQL 语句。
类型：
- Simple：每次执行 SQL 时都创建新的 Statement，适合简单场景。
- Reuse：复用 Statement，减少 Statement 的创建和销毁开销。
- Batch：批量执行 SQL，适合批量插入或更新操作，可以减少数据库交互次数。
功能：负责执行 SQL 语句，管理 Statement 的生命周期，以及维护一级缓存。
MapperProxy
作用：它是 MyBatis 的动态代理机制，用于实现 Mapper 接口。
特点：
- 动态代理：通过 JDK 动态代理技术，为 Mapper 接口生成代理实例。
- 功能：将 Mapper 接口的方法调用转换为具体的 SQL 执行操作。
- 解耦：让开发者只需要关注 Mapper 接口的定义，而不需要关心底层的 SQL 执行细节。
配置文件
此处介绍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>
<!-- 配置mybatis的环境--><environments default="mysql">
<!-- id和default的值必须保持一致,接下来配置连接mysql的具体信息--><environment id="mysql">
<!-- 配置事务类型 JDBC--><transactionManager type="JDBC"></transactionManager>
<!-- 配置数据源 它的取值有POOLED 和 UNPOOLED 前者是mysql提供的默认数据源进行数据库的连接
后者是不使用数据源，多次与数据库进行交互--><dataSource type="POOLED">
<!-- 配置连接数据库的驱动 url 用户名和密码--><property name="driver" value="com.mysql.cj.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><property name="username" value="root"/><property name="password" value="123456"/></dataSource></environment></environments>
<!-- 在核心配置文件里要导入接口的映射文件--><mappers><mapper resource="com/noy/dao/UserDao.xml"></mapper></mappers>
</configuration>Mapper XML 文件
若要通过xml来执行SQL操作，那么Mapper XML配置文件必不可少
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace 命名空间 值必须唯一 一般写接口的全限定名即可
-->
<mapper namespace="com.noy.dao.UserDao">
<!--
select标签 就是一个执行查询操作的标签
id必须和接口方法名称一样，才可以保持映射成功
parameterType参数类型的意思，这里不传参可以不写
resultType 是接口的返回值 如果是泛型 ，写泛型的全限定名
--><select id="findAll" resultType="com.noy.pojo.User">SELECT * FROM user</select>
</mapper>搭建mybatis入门案例的步骤
- 导入mybatis相关的依赖
- 创建pojo，将pojo和数据表进行关联映射 定义接口
- 创建mybatis的核心配置文件sqlMapConfig.xml
- 创建接口的映射文件 接口所在的目录 和接口文件所在的目录保持一致
- 编写测试代码
SQL映射
本质上是解耦 SQL 与 Java 代码，通过声明式配置实现数据库操作
基础 CRUD 标签
| 标签 | 核心属性 | |
|---|---|---|
<select> | id, resultType/resultMap | |
<insert> | id, parameterType | |
<update> | id, parameterType | |
<delete> | id, parameterType |
id 必须与 Mapper 接口方法同名，MyBatis 就靠这个把接口方法与 SQL 绑定在一起。
参数 & 占位符
#{}表示一个占位符号 通过#{}可以实现 preparedStatement 向占位符中设置值，自动进行 java 类型和 jdbc 类型转换，
#{}可以有效防止 sql 注入。 #{}可以接收简单类型值或 pojo 属性值。如果 parameterType 传输单个简单类 型值，#{}括号中可以是 value 或其它名称。${}表示拼接 sql 串 通过${}可以将 parameterType 传入的内容拼接在 sql 中且不进行 jdbc 类型转换，
${}可以接收简单类型值或 pojo 属性值，如果 parameterType传输单个简单类型值，${}括号中只能是value。
总而言之，安全用 #{} ，拼接才用 ${}
列表演示：
| 特性 | #{} (预编译占位符) | ${} (字符串替换) |
|---|---|---|
| SQL 安全 | 防止 SQL 注入 ✅ | 有注入风险 ❗ |
| 类型处理 | 自动类型转换 (Java→JDBC) | 直接字符串替换 |
| 使用场景 | 值参数（WHERE 条件值） | 动态表名/列名 |
| 日志输出 | ? 占位符 | 替换后的完整 SQL |
返回结果
resultType ：简单场景，直接写全限定类名或别名，列名与属性名一致即可自动映射。
例： <select id="getById" resultType="com.noy.User">
resultMap ：复杂场景，自定义映射规则（列名≠属性名、一对多、枚举转换等）。
例： <resultMap id="userMap" type="User"><result column="user_name" property="name"/></resultMap>
主键回填（insert 专属）
useGeneratedKeys="true" 开启 JDBC 自动生成主键回填。
keyProperty="id" 指定把数据库生成的主键值塞进参数对象的哪个属性。
<insert id="save" parameterType="User"useGeneratedKeys="true" keyProperty="id">INSERT INTO user(name) VALUES(#{name})
</insert>
插入完成后， User#getId() 就能直接拿到新主键。
多级映射
一个人可能有不同的身份，不同的人可能有同一种身份，不同的人也可能会有不同的身份，所以映射也是如此
| 关系类型 | 数据库表现 | 对象关系示例 | MyBatis 标签 | 使用场景 |
|---|---|---|---|---|
| 一对一 | 主表外键指向关联表主键 | 用户 ↔ 身份证 | <association> | 用户详情页显示身份证信息 |
| 一对多 | 主表主键出现在关联表的外键字段 | 部门 ↔ 员工 | <collection> | 部门页面显示下属员工列表 |
| 多对多 | 通过中间表维护两个主表的关系 | 学生 ↔ 课程 | 两个<collection> | 学生选课系统/课程学生名单 |
一对一
SQL
CREATE TABLE user (id INT PRIMARY KEY,name VARCHAR(50)
);CREATE TABLE id_card (id INT PRIMARY KEY,card_number VARCHAR(20),user_id INT UNIQUE, -- 唯一外键FOREIGN KEY (user_id) REFERENCES user(id)
);Java
public class User {private Integer id;private String name;private IdCard idCard; // 一对一关联对象
}public class IdCard {private String cardNumber;
}MyBatis 映射
<resultMap id="userMap" type="User"><id property="id" column="user_id"/><result property="name" column="user_name"/><!-- 一对一映射 --><association property="idCard" javaType="IdCard"><result property="cardNumber" column="card_number"/></association>
</resultMap><select id="getUserWithCard" resultMap="userMap">SELECT u.id AS user_id, u.name AS user_name,c.card_numberFROM user uJOIN id_card c ON u.id = c.user_idWHERE u.id = #{id}
</select>一对多
SQL
CREATE TABLE department (id INT PRIMARY KEY,name VARCHAR(50)
);CREATE TABLE employee (id INT PRIMARY KEY,name VARCHAR(50),dept_id INT, -- 非唯一外键FOREIGN KEY (dept_id) REFERENCES department(id)
);Java
public class Department {private Integer id;private String name;private List<Employee> employees; // 一对多关联集合
}public class Employee {private String name;
}MyBatis 映射
<resultMap id="deptMap" type="Department"><id property="id" column="dept_id"/><result property="name" column="dept_name"/><!-- 一对多映射 --><collection property="employees" ofType="Employee"><result property="name" column="emp_name"/></collection>
</resultMap><select id="getDeptWithEmployees" resultMap="deptMap">SELECT d.id AS dept_id,d.name AS dept_name,e.name AS emp_nameFROM department dLEFT JOIN employee e ON d.id = e.dept_idWHERE d.id = #{id}
</select>多对多
SQL
CREATE TABLE student (id INT PRIMARY KEY,name VARCHAR(50)
);CREATE TABLE course (id INT PRIMARY KEY,name VARCHAR(50)
);-- 中间表
CREATE TABLE student_course (student_id INT,course_id INT,PRIMARY KEY (student_id, course_id),FOREIGN KEY (student_id) REFERENCES student(id),FOREIGN KEY (course_id) REFERENCES course(id)
);Java
public class Student {private Integer id;private String name;private List<Course> courses; // 多对多关联
}public class Course {private String name;private List<Student> students; // 反向关联（可选）
}MyBatis 映射
<resultMap id="studentMap" type="Student"><id property="id" column="student_id"/><result property="name" column="student_name"/><!-- 多对多映射（通过中间表） --><collection property="courses" ofType="Course"><result property="name" column="course_name"/></collection>
</resultMap><select id="getStudentWithCourses" resultMap="studentMap">SELECT s.id AS student_id,s.name AS student_name,c.name AS course_nameFROM student sJOIN student_course sc ON s.id = sc.student_idJOIN course c ON sc.course_id = c.idWHERE s.id = #{id}
</select>实际上，一对多/多对多使用<collection>时，大数据量建议开启延迟加载，具体操作见下列映射策略
映射策略
自动映射：配置
autoMappingBehavior(PARTIAL/FULL/NONE)嵌套查询：
<association select="queryDeptById">+column="dept_id"延迟加载：在全局启用
lazyLoadingEnabled=true
<settings><!-- 开启全局延迟加载 --><setting name="lazyLoadingEnabled" value="true"/><!-- 关闭积极加载（3.4.1+ 默认为 false，高于此版本的mybatis可以不写） --><setting name="aggressiveLazyLoading" value="false"/>
</settings>
动态 SQL用法
其目的为
动态生成 SQL：根据参数条件自动拼接不同 SQL 片段
替代硬编码：避免在 Java 中手动拼接 SQL 字符串
智能去除多余关键字（AND/OR/）
用声明式 XML 标签代替过程式代码拼接，使 SQL 更清晰、更安全、更易维护。
核心标签为
| 标签 | 作用 | 常用场景 |
|---|---|---|
<if> | 条件判断 | 按需添加 WHERE 条件 |
<choose> | 多选一（类似 switch-case） | 多种查询方案选择 |
<where> | 智能处理 WHERE 子句 | 自动去除开头多余的 AND/OR |
<set> | 智能处理 UPDATE 的 SET 子句 | 自动去除尾部逗号 |
<foreach> | 遍历集合 | IN 查询、批量插入 |
它们的用法语法也类似于Java
基础条件控制 <if>
<select id="search">SELECT * FROM users<where><!-- 姓名不为空时添加条件 --><if test="name != null">AND name = #{name}</if><!-- 年龄大于0时添加条件 --><if test="age > 0">AND age > #{age}</if></where>
</select> 多分支选择 <choose>
<select id="getData">SELECT * FROM products<where><choose><!-- 优先按ID查 --><when test="id != null">id = #{id}</when><!-- 其次按名称查 --><when test="name != null">name LIKE #{name}</when><!-- 默认查上架商品 --><otherwise>status = 'ON_SALE'</otherwise></choose></where>
</select>智能更新 <set>
<update id="updateUser">UPDATE users<set><!-- 动态更新字段 --><if test="name != null">name=#{name},</if><if test="email != null">email=#{email},</if>update_time = NOW() <!-- 固定更新 --></set>WHERE id = #{id}
</update>集合遍历 <foreach>
<!-- IN 查询 -->
<select id="findByIds">SELECT * FROM usersWHERE id IN<foreach item="id" collection="ids" open="(" separator="," close=")">#{id}</foreach>
</select><!-- 批量插入 -->
<insert id="batchInsert">INSERT INTO users (name, age)VALUES<foreach item="user" collection="list" separator=",">(#{user.name}, #{user.age})</foreach>
</insert>此外，在动态SQL中，WHERE条件 → 用 <where> 标签，UPDATE 操作 → 用 <set> 标签
空集合处理
<!-- 检查集合非空 -->
<if test="list != null and !list.isEmpty()">...
</if>