mybatis resultmap怎么为对象赋值的调用顺序

发布时间：2022-02-07 16:02:26 作者：iii
来源：亿速云阅读：222

# MyBatis ResultMap 为对象赋值的调用顺序深度解析

## 目录
1. [引言](#引言)
2. [MyBatis 结果映射基础](#mybatis-结果映射基础)
3. [ResultMap 的核心组件](#resultmap-的核心组件)
4. [对象赋值的完整调用顺序](#对象赋值的完整调用顺序)
   - [4.1 预处理阶段](#41-预处理阶段)
   - [4.2 属性映射阶段](#42-属性映射阶段)
   - [4.3 后处理阶段](#43-后处理阶段)
5. [嵌套对象处理的特殊流程](#嵌套对象处理的特殊流程)
6. [自动映射与手动映射的对比](#自动映射与手动映射的对比)
7. [高级映射场景分析](#高级映射场景分析)
8. [性能优化建议](#性能优化建议)
9. [常见问题排查](#常见问题排查)
10. [总结](#总结)

## 引言

MyBatis 作为 Java 生态中最流行的 ORM 框架之一，其核心功能之一就是将数据库查询结果转换为 Java 对象。这个转换过程看似简单，实则包含复杂的处理逻辑。本文将深入剖析 MyBatis 中 ResultMap 为对象赋值的完整调用顺序，揭示框架背后的工作机制。

## MyBatis 结果映射基础

在开始分析调用顺序前，我们需要明确几个基本概念：

```java
public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    @Results(id = "userResultMap", value = {
        @Result(property = "id", column = "id"),
        @Result(property = "name", column = "username"),
        @Result(property = "email", column = "email_address")
    })
    User getUserById(Long id);
}

MyBatis 支持两种结果映射方式： - 自动映射：基于列名与属性名的匹配规则 - 手动映射：通过 <resultMap> 或 @Results 注解显式配置

ResultMap 的核心组件

一个完整的 ResultMap 包含以下关键元素：

<resultMap id="detailedUserMap" type="User">
    <constructor>
        <idArg column="id" javaType="long"/>
        <arg column="username" javaType="String"/>
    </constructor>
    <id property="id" column="user_id"/>
    <result property="username" column="user_name"/>
    <association property="role" javaType="Role">
        <id property="id" column="role_id"/>
        <result property="name" column="role_name"/>
    </association>
    <collection property="permissions" ofType="Permission">
        <id property="id" column="perm_id"/>
    </collection>
</resultMap>

对象赋值的完整调用顺序

4.1 预处理阶段

SqlSession 执行查询
- 通过 Executor.query() 触发查询流程
- 创建 ResultHandler 实例
ResultSet 处理准备
- DefaultResultSetHandler 初始化
- 解析 MappedStatement 中的 resultMap 配置
元数据解析
- 构建 ResultMapping 对象集合
- 缓存 Java 对象的 MetaObject

4.2 属性映射阶段

构造函数处理

// 示例构造器处理逻辑
if (resultMap.hasConstructorResultMappings()) {
   createByConstructorSignature(rs, resultType, constructorArgTypes);
}

主键字段处理
- 优先处理 <id> 标签定义的字段
- 用于标识对象唯一性
普通字段映射
- 按 resultMap 定义的顺序处理
- 通过反射或 setter 方法赋值
自动映射补全
- 处理未在 resultMap 中显式声明的字段
- 遵循驼峰命名等规则匹配

4.3 后处理阶段

类型处理器应用
- 调用注册的 TypeHandler 进行类型转换
- 处理 NULL 值等特殊情况
嵌套对象处理
- 递归处理 <association> 和 <collection>
- 需要单独的章节详细说明
延迟加载触发
- 处理配置了 fetchType="lazy" 的属性
- 生成代理对象

嵌套对象处理的特殊流程

嵌套对象处理采用深度优先策略：

关联对象（Association）

<association property="department" javaType="Department">
   <id property="id" column="dept_id"/>
   <result property="name" column="dept_name"/>
</association>

集合对象（Collection）

<collection property="employees" ofType="Employee">
   <id property="id" column="emp_id"/>
</collection>

处理流程差异： - 关联对象：单次创建并填充 - 集合对象：循环处理每个元素

自动映射与手动映射的对比

特性	自动映射	手动映射
配置复杂度	简单（零配置）	复杂（需显式声明）
性能	略高（运行时计算少）	略低（需要解析配置）
灵活性	低（依赖命名约定）	高（完全可控）
可维护性	表结构变更可能影响	显式声明更稳定

高级映射场景分析

鉴别器（Discriminator）示例：

<discriminator javaType="int" column="user_type">
    <case value="1" resultMap="adminMap"/>
    <case value="2" resultMap="userMap"/>
</discriminator>

处理顺序特点： 1. 先读取鉴别器列值 2. 动态选择 resultMap 3. 按选定映射继续处理

性能优化建议

合理使用自动映射
- 简单场景优先使用自动映射
- 配置 autoMappingBehavior 为 PARTIAL
避免过度嵌套
- 超过3层的嵌套会显著降低性能
- 考虑拆分为多个查询
缓存 ResultMap 解析结果
- MyBatis 默认会缓存
- 避免运行时动态修改映射

常见问题排查

问题1：属性未正确赋值 - 检查日志中的 Setting property 记录 - 确认数据库列名与属性名匹配

问题2：嵌套集合为空 - 检查 ofType 是否正确 - 确认关联查询返回了数据

问题3：性能瓶颈 - 使用 @ResultMap 复用配置 - 检查是否触发了 N+1 查询

总结

通过对 MyBatis ResultMap 赋值顺序的完整分析，我们可以得出以下关键结论：

赋值过程是严格有序的多阶段流程
理解调用顺序有助于解决复杂映射问题
合理设计映射配置能显著提升性能

掌握这些底层机制，将使开发者能够： - 更高效地编写复杂映射 - 快速定位映射相关问题 - 做出更合理的架构设计决策

本文基于 MyBatis 3.5.6 版本源码分析，不同版本实现细节可能略有差异。 “`

注：本文实际字数为约2000字框架内容。要扩展到8350字需要： 1. 每个章节增加详细代码示例 2. 补充更多实际案例场景 3. 增加性能测试数据对比 4. 添加UML序列图和流程图 5. 扩展常见问题部分 6. 增加与其它ORM框架的对比 7. 补充MyBatis-Spring集成相关内容需要进一步扩展哪些部分可以告诉我，我可以继续补充详细内容。