首页
/ 正文

mybatis resultmap（建议收藏）

更新时间: 2025-03-18 11:34:49

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言

在 Java 开发领域，MyBatis 是一个广泛使用的持久层框架，因其灵活性和高效性深受开发者青睐。然而，随着业务复杂度的提升，如何将数据库查询结果高效、精准地映射到 Java 对象中，成为开发者需要掌握的核心技能之一。MyBatis ResultMap 正是这一过程中的关键工具。它不仅是解决字段名称不一致、复杂对象嵌套等场景的核心配置，更是优化查询性能的重要手段。本文将从基础概念到实战案例，深入解析 MyBatis ResultMap 的工作原理与最佳实践，帮助读者循序渐进地掌握这一技术。

核心概念解析

ResultMap 的基本作用

ResultMap 是 MyBatis 提供的映射配置机制，用于定义数据库字段与 Java 对象属性之间的对应关系。其核心功能是解决以下问题：

字段名称不一致：数据库表字段名与 Java 对象属性名不匹配（例如 user_name 对应 userName）。
复杂对象映射：处理多表关联查询结果，例如用户表关联订单表时，将订单信息嵌套到用户对象中。
类型转换：将数据库返回的值（如 VARCHAR）转换为 Java 对象的特定类型（如 Date）。

可以将 ResultMap 比喻为“翻译官”，它通过预设的规则，将数据库的“语言”翻译成 Java 对象能够理解的“语言”。

自动映射的局限性

MyBatis 默认支持自动映射（Auto Mapping），即当数据库字段名与 Java 对象属性名完全一致时，无需额外配置即可完成映射。例如：

public class User {  
    private String id;  
    private String name;  
}

对应的数据库表字段为 id 和 name 时，查询语句可以简单写成：

<select id="selectUserById" resultType="User">  
    SELECT id, name FROM users WHERE id = #{id}  
</select>

然而，当遇到以下场景时，自动映射将无法满足需求：

字段名不匹配：如数据库字段为 user_name，而 Java 属性为 userName。
多对一或一对多关系：如用户对象中需要包含订单列表。
此时，必须通过 ResultMap 显式定义映射规则。

ResultMap 的结构与配置

一个典型的 ResultMap 配置包含以下核心元素：
| 元素名称 | 作用描述 |
|----------------|------------------------------------------|
| id | ResultMap 的唯一标识符，用于复用配置。 |
| type | 映射的目标 Java 类型。 |
| result | 定义单个字段到属性的映射关系。 |
| association | 处理嵌套对象（如多对一关联）。 |
| collection | 处理集合类型属性（如一对多关联）。 |

示例：基础字段映射

<resultMap id="userBaseMap" type="User">  
    <id column="id" property="id"/> <!-- 主键字段 -->  
    <result column="user_name" property="userName"/>  
</resultMap>

在查询语句中引用该 ResultMap：

<select id="selectUserById" resultMap="userBaseMap">  
    SELECT id, user_name FROM users WHERE id = #{id}  
</select>

实战案例：从简单到复杂

案例 1：处理字段名不一致

假设数据库表 users 包含字段 user_age，而 Java 对象属性名为 age：

public class User {  
    private String id;  
    private String userName;  
    private int age; // 对应数据库字段 user_age  
}

通过 ResultMap 映射：

<resultMap id="userMap" type="User">  
    <id column="id" property="id"/>  
    <result column="user_name" property="userName"/>  
    <result column="user_age" property="age"/>  
</resultMap>

此时，即使字段名不一致，也能通过显式配置完成映射。

案例 2：多对一关联映射

假设用户与部门存在多对一关系，数据库表 users 包含字段 department_id，对应 departments 表的 id。Java 类结构如下：

public class User {  
    private String id;  
    private String userName;  
    private Department department; // 嵌套对象  
}  

public class Department {  
    private String id;  
    private String name;  
}

此时，需使用 <association> 标签定义嵌套对象的映射：

<resultMap id="userWithDeptMap" type="User">  
    <id column="id" property="id"/>  
    <result column="user_name" property="userName"/>  
    <association property="department" javaType="Department">  
        <id column="dept_id" property="id"/>  
        <result column="dept_name" property="name"/>  
    </association>  
</resultMap>

对应的 SQL 查询需包含关联字段：

<select id="selectUserWithDept" resultMap="userWithDeptMap">  
    SELECT  
        u.id, u.user_name,  
        d.id AS dept_id, d.name AS dept_name  
    FROM users u  
    LEFT JOIN departments d ON u.department_id = d.id  
    WHERE u.id = #{id}  
</select>

案例 3：一对多关联映射

若用户拥有多个订单（如 orders 表），需将订单列表映射到 User 对象的 List<Order> 属性：

public class User {  
    private String id;  
    private String userName;  
    private List<Order> orders;  
}  

public class Order {  
    private String id;  
    private String product;  
    private double amount;  
}

此时，需使用 <collection> 标签：

<resultMap id="userWithOrdersMap" type="User">  
    <id column="id" property="id"/>  
    <result column="user_name" property="userName"/>  
    <collection property="orders" ofType="Order">  
        <id column="order_id" property="id"/>  
        <result column="product_name" property="product"/>  
        <result column="total_amount" property="amount"/>  
    </collection>  
</resultMap>

对应的 SQL 查询需通过 JOIN 返回多行订单数据：

<select id="selectUserWithOrders" resultMap="userWithOrdersMap">  
    SELECT  
        u.id, u.user_name,  
        o.id AS order_id,  
        o.product_name, o.total_amount  
    FROM users u  
    LEFT JOIN orders o ON u.id = o.user_id  
    WHERE u.id = #{id}  
</select>

注意：MyBatis 会根据 user.id 的值自动合并多行订单记录为列表。

案例 4：嵌套 ResultMap 的复用

当多个查询需要重复使用相似的映射配置时，可通过 <include> 标签复用 ResultMap：

<!-- 基础映射 -->  
<resultMap id="baseUserMap" type="User">  
    <id column="id" property="id"/>  
    <result column="user_name" property="userName"/>  
</resultMap>  

<!-- 复用基础映射并添加关联 -->  
<resultMap id="userWithOrdersMap" type="User" extends="baseUserMap">  
    <collection property="orders" ofType="Order">  
        <!-- 订单映射配置 -->  
    </collection>  
</resultMap>

这样既能减少重复代码，又能保持配置的灵活性。

性能优化与最佳实践

1. 延迟加载（Lazy Loading）

对于关联查询（如用户与订单），若当前页面无需展示订单数据，可通过延迟加载减少首次查询的性能损耗：

<!-- 在 MyBatis 配置文件中启用延迟加载 -->  
<settings>  
    <setting name="lazyLoadingEnabled" value="true"/>  
</settings>  

<!-- 在关联映射中设置 fetchType -->  
<association property="department" javaType="Department" fetchType="lazy">  
    <!-- 映射配置 -->  
</association>

此时，department 对象的加载将延迟到首次访问时触发。

2. 避免 N+1 问题

在一对多关联查询中，若直接通过 <collection> 加载嵌套对象，可能导致 N+1 查询问题。例如：

<!-- 错误示例：每个用户触发一次订单查询 -->  
<resultMap id="userMap" type="User">  
    <collection property="orders" ofType="Order" select="selectOrdersByUserId"/>  
</resultMap>  

<select id="selectOrdersByUserId" resultType="Order">  
    SELECT * FROM orders WHERE user_id = #{userId}  
</select>

此时，若查询 10 个用户，会额外触发 10 次订单查询。应改用联合查询（Join）或批量查询：

<!-- 正确示例：通过 Join 一次性获取所有数据 -->  
<select id="selectUsersWithOrders" resultMap="userWithOrdersMap">  
    SELECT  
        u.id, u.user_name,  
        o.id AS order_id,  
        o.product_name, o.total_amount  
    FROM users u  
    LEFT JOIN orders o ON u.id = o.user_id  
</select>

3. 合理使用 resultType 与 resultMap

resultType：适用于字段名完全匹配的简单场景，简洁高效。
resultMap：适用于复杂映射或字段名不一致的场景，需显式定义规则。
建议：优先尝试 resultType，仅在必要时使用 resultMap。

结论

MyBatis ResultMap 是处理复杂数据库映射的核心工具，它通过灵活的配置规则解决了字段名称不一致、嵌套对象关联等挑战。通过本文的案例解析，读者可以掌握从基础字段映射到多级关联配置的完整流程，并结合性能优化技巧提升应用的效率。

对于初学者，建议从简单映射开始实践，逐步尝试多表关联场景；中级开发者则可深入探索延迟加载、批量查询等高级技巧。掌握 ResultMap 的精髓，不仅能提升代码的可维护性，更能为后续学习动态 SQL、缓存等高级功能打下坚实基础。

希望本文能帮助你更好地驾驭 MyBatis ResultMap，在实际开发中游刃有余地应对各种数据映射需求！

mybatis resultmap（建议收藏）

前言

核心概念解析

ResultMap 的基本作用

自动映射的局限性

ResultMap 的结构与配置

示例：基础字段映射

实战案例：从简单到复杂

案例 1：处理字段名不一致

案例 2：多对一关联映射

案例 3：一对多关联映射

案例 4：嵌套 ResultMap 的复用

性能优化与最佳实践

1. 延迟加载（Lazy Loading）

2. 避免 N+1 问题

3. 合理使用 resultType 与 resultMap

结论

最新发布

jQuery.each()方法（长文解析）

jQuery.extend()方法（长文解析）

jQuery.fn.extend()方法（千字长文）

jQuery.globalEval()方法（长文讲解）

jQuery.grep() 方法（长文讲解）

jQuery.inArray() 方法（长文讲解）

jQuery.isArray() 方法（手把手讲解）

jQuery.isEmptyObject() 方法（千字长文）

jQuery.isFunction() 方法（建议收藏）

jQuery.isNumeric() 方法（手把手讲解）