当前位置：首页 > news >正文

resultMap和自定义映射结果形式（ResultMapManage）以及ResultMap Vs ResultType

news 2026/6/10 17:04:16

 <resultMap id="ResultMapManage" type="com.javapandeng.po.Manage"><result property="id" column="id" jdbcType="INTEGER"/><result property="userName" column="userName" jdbcType="VARCHAR"/><result property="passWord" column="passWord" jdbcType="VARCHAR"/><result property="realName" column="realName" jdbcType="VARCHAR"/></resultMap>
<select id="getByMap" resultMap="ResultMapManage" parameterType="map">select <include refid="Manage_field"/>from manage where where 1=1<include refid="Manage_where"/></select>

好的，我们来彻底讲清楚 resultMap="ResultMapManage" 中的 ResultMapManage 是什么意思。

这是一个 MyBatis 框架中的核心概念，非常重要。

一、核心答案：它是什么？

ResultMapManage 是一个 id，是一个标识符（名字）。

它是在 MyBatis 的 Mapper XML 文件中，由一个 <resultMap> 标签定义的结果映射集的唯一名称。

你可以把它理解为：

一个“说明书”或“映射规则”：它告诉 MyBatis：“当你从数据库查询到一条记录后，应该怎样把这条记录的各个字段，填充到一个 Java 对象的各个属性里。”
一个“转换器”：它负责将 ResultSet（JDBC 查询返回的表格数据）转换成 Java 对象。

二、为什么需要它？它解决了什么问题？

数据库的列（Column）名和 Java 类的属性（Property）名并不总是完全一致。即使一致，有时也需要进行一些特殊处理。<resultMap> 就是为了解决这个映射问题而存在的。

没有 resultMap 时（使用 resultType）：

MyBatis 会基于“约定优于配置”的原则，自动地尝试将查询结果的列名与 Java 对象属性名进行匹配（通常是驼峰命名转换，如 user_name -> userName）。
这种方式简单，但不灵活，无法处理复杂场景。

有 resultMap 时：

你显式地、手动地定义了映射规则，完全掌控了数据库列和Java属性之间的对应关系。
你可以处理任意复杂的映射关系。

三、`ResultMapManage` 是如何定义的？

在你的某个 Mapper XML 文件中，肯定有这样一段定义（名字可能不叫 ResultMapManage，但结构一样）：

<!-- 1. 使用 <resultMap> 标签定义一个映射集，并给它一个唯一的 id -->
<resultMap id="ResultMapManage" type="com.javapandeng.po.Manage"><!-- 2. 定义主键映射（可选，但好习惯） --><id property="id" column="id" /><!-- 3. 定义普通属性的映射 --><result property="userName" column="user_name" /><result property="password" column="password" /><result property="realName" column="real_name" /><result property="createTime" column="create_time" jdbcType="TIMESTAMP"/><result property="updateTime" column="update_time" jdbcType="TIMESTAMP"/><!-- 4. 可以处理更复杂的关联映射（一对一，一对多） --><!-- <association property="department" resultMap="AnotherResultMap"/> --><!-- <collection property="roles" ofType="Role" resultMap="RoleResultMap"/> -->
</resultMap>

这段代码解释：

<resultMap id="ResultMapManage" ...>：这里就是定义了这个映射集的名字（ID）叫 ResultMapManage。
type="com.javapandeng.po.Manage"：这个映射规则最终是要把一个数据库记录转换成 Manage 这个类型的 Java 对象。
<id> 和 <result>：这是映射规则的核心。
- column： 数据库表的列名（user_name）。
- property： Java 对象的属性名（userName）。
- jdbcType：（可选）指定数据库字段的类型，在某些特定场景下（如传入参数为null时）有助于 MyBatis 生成更精确的 SQL。

四、在什么地方使用它？（`resultMap="ResultMapManage"`）

定义好之后，你就可以在任何需要返回 Manage 对象的 SQL 查询语句中引用它。

<!-- 在 SELECT 语句中，使用 resultMap 属性（而不是 resultType）来引用我们定义好的映射集 -->
<select id="getManageById" resultMap="ResultMapManage">SELECT id, user_name, password, real_name, create_time, update_timeFROM manageWHERE id = #{id}
</select><select id="getAllManages" resultMap="ResultMapManage">SELECT * FROM manage <!-- 即使使用 SELECT *，也能靠 resultMap 正确映射 -->
</select>

当 MyBatis 执行 getManageById 这个查询时：

执行 SQL：SELECT ... FROM manage WHERE id = 1，得到一行结果。
MyBatis 看到 resultMap="ResultMapManage"，就知道要去寻找 id 为 ResultMapManage 的 <resultMap>。
找到后，按照里面的规则，开始创建 Manage 对象并填充属性：
- 将数据库列 user_name 的值，赋给 Java 对象的 userName 属性。
- 将数据库列 create_time 的值，赋给 Java 对象的 createTime 属性。
- ...以此类推。
最终，一个完整的、属性都已赋值的 Manage 对象就被返回给了调用方（如 Service 层）。

五、`resultMap` vs `resultType`

特性	`resultMap` (手动映射)	`resultType` (自动映射)
控制力	强。完全掌控映射过程。	弱。依赖默认规则。
灵活性	高。可以处理列名和属性名不一致、复杂类型、关联查询。	低。只能处理简单直接的映射。
代码量	需要编写额外的 `<resultMap>` 配置。	无需额外配置，直接指定Java类即可。
适用场景	强烈推荐用于所有正式项目，尤其是属性名和列名不一致或有关联查询时。	仅用于快速原型、测试或非常简单的场景。

总结

所以，resultMap="ResultMapManage" 中的 ResultMapManage：

它是一个标识符，是你在 XML 中自定义的一套映射规则的名称。
这套规则明确规定了数据库表的列 和 Java 对象的属性 之间的对应关系。
你在 SQL 查询标签（<select>）中通过 resultMap="ResultMapManage" 来引用这套规则，告诉 MyBatis：“请按照 ResultMapManage 这个说明书，把我查到的数据组装成 Java 对象。”