MyBatis的XML映射文件通过核心标签实现Java接口与数据库操作的绑定。1. 为根标签,需指定namespace绑定接口;2. 、、、对应CRUD操作,配置id、参数和返回类型;3. 处理字段与属性不一致或关联关系,支持、、、子标签;4. 定义可复用SQL片段,引用以提升维护性;5. #{} 预编译防注入,${}用于动态SQL但需防范风险;6. 配置二级缓存提升性能,如LRU策略、定时刷新等。合理使用这些标签可提高SQL安全性与代码可维护性。

MyBatis 的 XML 映射文件(mapper.xml)是持久层框架中连接 Java 接口与数据库操作的核心组件。它通过定义 SQL 语句和结果映射,实现对数据库的灵活操作。理解其核心标签的用法,是掌握 MyBatis 的关键。
:根标签,指定命名空间
mapper 是映射文件的根元素,必须包含 namespace 属性。该属性通常指向对应的 Mapper 接口全路径,用于绑定接口与 XML 文件。
例如:
MyBatis 通过 namespace 定位 SQL 语句,如果使用注解方式,namespace 仍需保持一致。
这些标签对应基本的 CRUD 操作,是最常用的元素。
- 用于查询,需指定 id(对应接口方法名)、resultType 或 resultMap(返回类型)
-
插入数据,可配合 useGeneratedKeys 和 keyProperty 获取自增主键 -
和 分别执行更新和删除,返回值为影响行数(int/Integer)
示例:
:复杂结果映射的利器
当数据库字段名与 Java 属性名不一致,或存在关联关系(如一对一、一对多)时,resultMap 提供了精细的映射控制。
主要子标签包括:
-
:标识主键字段,提升性能识别 -
:普通字段映射,可指定 column 到 property 的对应 -
:映射关联对象(如订单中的用户信息) -
:映射集合类型(如用户的所有订单列表)
典型场景:
与 :SQL 片段复用
避免重复编写相同 SQL 片段,可以使用 sql 标签定义可重用代码块,并通过 include 引入。
例如抽取公共字段:
id, username, email, created_time
这提高了维护性,一处修改,全局生效。
与 #{}、${}:参数处理机制
虽然 parameterType 可显式声明参数类型,但多数情况下 MyBatis 能自动推断。真正重要的是参数占位符的选择:
- #{}:预编译占位,防止 SQL 注入,推荐使用
- ${}:直接字符串替换,适用于动态表名、排序字段等,但有安全风险
例如动态排序:
此时必须确保 sortBy 来源可信。
:启用二级缓存
在 mapper 级别开启缓存,减少数据库访问。默认一级缓存(SqlSession 级)始终开启,二级需手动配置。
简单配置:
表示使用 LRU 策略,每分钟清空,最多缓存 512 条,只读模式提升并发效率。
基本上就这些。合理运用这些标签,能让 SQL 更清晰、安全、易维护。关键是根据业务复杂度选择合适的结果映射方式,优先使用预编译参数,复用 SQL 片段,必要时启用缓存。不复杂但容易忽略细节。










