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

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

MyBatis 的 XML 映射文件（mapper.xml）是持久层框架中连接 Java 接口与数据库操作的核心组件。它通过定义 SQL 语句和结果映射，实现对数据库的灵活操作。理解其核心标签的用法，是掌握 MyBatis 的关键。

<mapper>：根标签，指定命名空间

mapper 是映射文件的根元素，必须包含 namespace 属性。该属性通常指向对应的 Mapper 接口全路径，用于绑定接口与 XML 文件。

例如：

<mapper namespace="com.example.mapper.UserMapper">

MyBatis 通过 namespace 定位 SQL 语句，如果使用注解方式，namespace 仍需保持一致。

<select>、<insert>、<update>、<delete>：增删改查标签

这些标签对应基本的 CRUD 操作，是最常用的元素。

• <select> 用于查询，需指定 id（对应接口方法名）、resultType 或 resultMap（返回类型）
• <insert> 插入数据，可配合 useGeneratedKeys 和 keyProperty 获取自增主键
• <update> 和 <delete> 分别执行更新和删除，返回值为影响行数（int/Integer）

示例：

<select id="selectUserById" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>

<resultMap>：复杂结果映射的利器

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

主要子标签包括：

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

典型场景：

<resultMap id="userOrderMap" type="User">
<id property="id" column="user_id"/>
<result property="name" column="user_name"/>
<collection property="orders" ofType="Order" resultMap="orderMap"/>
</resultMap>

<sql> 与 <include>：SQL 片段复用

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

Jenni AI

使用最先进的 AI 写作助手为您的写作增光添彩。

48

查看详情

例如抽取公共字段：

<sql id="baseColumns">
id, username, email, created_time
</sql>

<select id="findAll" resultType="User">
SELECT <include refid="baseColumns"/> FROM user
</select>

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

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

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

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

例如动态排序：

<select id="findUsers" resultType="User">
SELECT * FROM user ORDER BY ${sortBy}
</select>

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

<cache>：启用二级缓存

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

简单配置：

<cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>

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

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

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