Mybatis的xml映射文件怎么写？ 深入解析mapper.xml的核心标签

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）

示例：

SELECT * FROM user WHERE id = #{id}

：复杂结果映射的利器

当数据库字段名与 Java 属性名不一致，或存在关联关系（如一对一、一对多）时，resultMap 提供了精细的映射控制。

主要子标签包括：

• ：标识主键字段，提升性能识别
• ：普通字段映射，可指定 column 到 property 的对应
• ：映射关联对象（如订单中的用户信息）
• ：映射集合类型（如用户的所有订单列表）

典型场景：

腾讯云AI代码助手

基于混元代码大模型的AI辅助编码工具

205

查看详情

与 ：SQL 片段复用

避免重复编写相同 SQL 片段，可以使用 sql 标签定义可重用代码块，并通过 include 引入。

例如抽取公共字段：

id, username, email, created_time



SELECT FROM user

这提高了维护性，一处修改，全局生效。

与 #{}、${}：参数处理机制

虽然 parameterType 可显式声明参数类型，但多数情况下 MyBatis 能自动推断。真正重要的是参数占位符的选择：

• #{}：预编译占位，防止 SQL 注入，推荐使用
• ${}：直接字符串替换，适用于动态表名、排序字段等，但有安全风险

例如动态排序：

SELECT * FROM user ORDER BY ${sortBy}

此时必须确保 sortBy 来源可信。

：启用二级缓存

在 mapper 级别开启缓存，减少数据库访问。默认一级缓存（SqlSession 级）始终开启，二级需手动配置。

简单配置：

表示使用 LRU 策略，每分钟清空，最多缓存 512 条，只读模式提升并发效率。

基本上就这些。合理运用这些标签，能让 SQL 更清晰、安全、易维护。关键是根据业务复杂度选择合适的结果映射方式，优先使用预编译参数，复用 SQL 片段，必要时启用缓存。不复杂但容易忽略细节。

以上就是Mybatis的xml映射文件怎么写？ 深入解析mapper.xml的核心标签的详细内容，更多请关注php中文网其它相关文章！