MyBatis映射文件 <resultMap> 元素详解与示例


引言

<resultMap> 是 MyBatis 中最核心的映射配置元素,用于解决数据库字段与 Java 对象属性之间的复杂映射问题,尤其是字段名不一致、嵌套对象关联、集合映射等场景。ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。以下是 <resultMap> 的详细解析和用法说明。


一、<resultMap> 基础结构

1. 核心属性
  • id:唯一标识符,用于其他操作引用此映射。
  • type:映射的目标 Java 对象类型(全限定类名或别名)。
  • autoMapping:是否启用自动映射(默认 false,建议部分场景开启)。
    在这里插入图片描述
2. 基础示例

场景:数据库字段为 user_id,Java 对象属性为 userId

<!-- 
用户结果映射(基础版本)
功能:将数据库查询结果映射到com.example.User对象
说明:1. id="BaseUserMap":标识这个结果映射的唯一名称。2. type="com.example.User":指定目标Java对象的完整类路径。3. <id property="userId" column="user_id">:定义主键属性userId与数据库列user_id的映射关系。4. <result property="userName" column="user_name">:定义普通属性userName与数据库列user_name的映射关系。5. <result property="age" column="age">:定义普通属性age与数据库列age的映射关系。
用法:在需要复杂映射的场景下,可复用此结果映射。-->
<resultMap id="BaseUserMap" type="com.example.User"><id property="userId" column="user_id" /><result property="userName" column="user_name" /><result property="age" column="age" />
</resultMap><!-- 
查询用户基本信息
功能:从users表中查询user_id、user_name和age列,并使用BaseUserMap结果映射转换为Java对象
说明:1. id="getUser":标识这个查询操作的唯一名称。2. resultMap="BaseUserMap":指定使用BaseUserMap结果映射来处理查询结果。3. SELECT user_id, user_name, age FROM users:从users表中查询指定列。
用法:在Mapper接口中定义对应的方法,例如:User getUser();返回一个包含用户基本信息的User对象。-->
<select id="getUser" resultMap="BaseUserMap">SELECT user_id, user_name, age FROM users
</select>

二、字段映射详解

1. <id><result> 的区别
  • <id>:标记主键字段,影响缓存和性能优化(必须配置)。
  • <result>:普通字段映射。
    在这里插入图片描述
2. 显式映射 vs 自动映射
  • 显式映射:手动配置所有字段(推荐复杂场景)。
  • 自动映射:开启 autoMapping="true" 后,未配置的字段按名称自动映射。
<!-- 
自动映射主键的用户结果映射
功能:使用MyBatis的自动映射功能,将数据库查询结果映射到User对象
特别说明:1. autoMapping="true":表示开启MyBatis的自动映射功能。- MyBatis会自动将查询结果中与User对象属性名匹配的列映射到对应的属性上。2. <id property="userId" column="user_id">:手动配置主键映射,确保主键列与User对象的userId属性正确对应。- 通常主键列需要显式定义,其他非主键列可以依赖自动映射完成。-->
<resultMap id="AutoUserMap" type="User" autoMapping="true"><id property="userId" column="user_id" /> <!-- 只需配置主键 -->
</resultMap><!-- 
查询用户信息(使用自动映射)
功能:从users表中查询所有用户信息,并通过AutoUserMap结果映射转换为User对象。
特别说明:- 该查询语句只需简单地从表中选择所有列(SELECT *),因为开启了自动映射,MyBatis会自动处理列名与User对象属性的映射。- 如果某些列名与User对象属性名不一致,可以手动在resultMap中配置对应的映射关系。-->
<select id="getUser" parameterType="String" resultMap="AutoUserMap">SELECT * FROM users
</select>

三、关联关系映射

1. 一对一关联 <association>

场景:用户(User)与身份证(IDCard)一对一关联。
Java 对象

public class User {private Integer userId;private String userName;private IDCard idCard; // 一对一对象
}

映射配置

<!-- 
用户与身份证信息的结果映射
功能:将用户信息和其关联的身份证信息映射到User对象
说明:1. id="UserWithIDCardMap":标识这个结果映射的唯一名称。2. type="User":指定目标Java对象类型为User。3. <id property="userId" column="user_id">:定义User对象的userId属性与数据库表的user_id列对应,作为主键。4. <result property="userName" column="user_name">:定义User对象的userName属性与数据库表的user_name列对应。5. <association property="idCard" javaType="IDCard">- property="idCard":User对象中的idCard属性,表示用户的身份证信息。- javaType="IDCard":指定关联对象的Java类型为IDCard。- <id property="cardId" column="card_id">:定义IDCard对象的cardId属性与数据库表的card_id列对应,作为主键。- <result property="cardNumber" column="card_number">:定义IDCard对象的cardNumber属性与数据库表的card_number列对应。- 通过这个关联映射,可以将用户的身份证信息嵌套到User对象中。-->
<resultMap id="UserWithIDCardMap" type="User"><id property="userId" column="user_id"/><result property="userName" column="user_name"/><!-- 嵌套对象映射 --><association property="idCard" javaType="IDCard"><id property="cardId" column="card_id"/><result property="cardNumber" column="card_number"/></association>
</resultMap><!-- 
查询用户及其身份证信息
功能:从users和id_card表中查询用户及身份证数据,并通过UserWithIDCardMap结果映射转换为Java对象
说明:1. id="getUserWithIDCard":标识这个查询操作的唯一名称。2. resultMap="UserWithIDCardMap":指定使用UserWithIDCardMap结果映射来处理查询结果。3. SELECT u.user_id, u.user_name, c.card_id, c.card_number FROM users u LEFT JOIN id_card c ON u.user_id = c.user_id:- 查询users表和id_card表的联合数据。- LEFT JOIN将users表和id_card表连接,连接条件为用户ID(u.user_id = c.user_id)。- 查询结果将包含用户的基本信息和其关联的身份证信息。
用法:在Mapper接口中定义对应的方法,例如:User getUserWithIDCard();返回一个包含用户及其身份证信息的User对象。-->
<select id="getUserWithIDCard" resultMap="UserWithIDCardMap">SELECT u.user_id, u.user_name, c.card_id, c.card_numberFROM users uLEFT JOIN id_card c ON u.user_id = c.user_id
</select>

2. 一对多关联 <collection>

场景:用户(User)与订单(Order)一对多关联。
Java 对象

public class User {private Integer userId;private String userName;private List<Order> orders; // 一对多集合
}

映射配置

<!-- 
用户与订单的结果映射
功能:将用户信息及其关联的订单信息映射到User对象
说明:1. id="UserWithOrdersMap":标识这个结果映射的唯一名称。2. type="User":指定目标Java对象类型为User。3. <id property="userId" column="user_id">:定义User对象的userId属性与数据库表的user_id列对应,作为主键。4. <result property="userName" column="user_name">:定义User对象的userName属性与数据库表的user_name列对应。5. <collection property="orders" ofType="Order">- property="orders":User对象中的orders属性,表示用户的订单集合。- ofType="Order":指定集合中元素的类型为Order。- <id property="orderId" column="order_id">:定义Order对象的orderId属性与数据库表的order_id列对应,作为主键。- <result property="orderNo" column="order_no">:定义Order对象的orderNo属性与数据库表的order_no列对应。- <result property="amount" column="amount">:定义Order对象的amount属性与数据库表的amount列对应。- 通过这个集合映射,可以将用户的订单信息作为嵌套集合封装到User对象中。-->
<resultMap id="UserWithOrdersMap" type="User"><id property="userId" column="user_id"/><result property="userName" column="user_name"/><!-- 集合映射 --><collection property="orders" ofType="Order"><id property="orderId" column="order_id"/><result property="orderNo" column="order_no"/><result property="amount" column="amount"/></collection>
</resultMap><!-- 
查询用户及其订单信息
功能:从users和orders表中查询用户及订单数据,并通过UserWithOrdersMap结果映射转换为Java对象
说明:1. id="getUserWithOrders":标识这个查询操作的唯一名称。2. resultMap="UserWithOrdersMap":指定使用UserWithOrdersMap结果映射来处理查询结果。3. SELECT u.user_id, u.user_name, o.order_id, o.order_no, o.amount FROM users u LEFT JOIN orders o ON u.user_id = o.user_id:- 查询users表和orders表的联合数据。- LEFT JOIN将users表和orders表连接,连接条件为用户ID(u.user_id = o.user_id)。- 查询结果将包含用户的基本信息和其关联的订单信息。
用法:在Mapper接口中定义对应的方法,例如:User getUserWithOrders();返回一个包含用户及其订单信息的User对象。-->
<select id="getUserWithOrders" resultMap="UserWithOrdersMap">SELECT u.user_id, u.user_name,o.order_id, o.order_no, o.amountFROM users uLEFT JOIN orders o ON u.user_id = o.user_id
</select>

四、高级用法

1. 继承映射 (extends)

复用已有的 resultMap,避免重复配置。

<!-- 
基础用户结果映射
功能:定义了一个基础的结果映射,包含用户的基本字段(user_id 和 user_name)
说明:1. id="BaseUserMap":标识这个结果映射的唯一名称。2. type="User":指定目标Java对象类型为User。3. <id property="userId" column="user_id">:定义User对象的userId属性与数据库表的user_id列对应,作为主键。4. <result property="userName" column="user_name">:定义User对象的userName属性与数据库表的user_name列对应。5. 这个基础映射可以被其他映射继承和扩展,避免重复定义公共字段。-->
<resultMap id="BaseUserMap" type="User"><id property="userId" column="user_id"/><result property="userName" column="user_name"/>
</resultMap><!-- 
扩展基础用户结果映射,添加新字段
功能:在基础用户映射的基础上,添加一个新的字段(email)
说明:1. id="ExtendedUserMap":标识这个结果映射的唯一名称。2. extends="BaseUserMap":表示继承BaseUserMap中的所有字段和配置。3. type="User":指定目标Java对象类型为User。4. <result property="email" column="email">:新增字段,定义User对象的email属性与数据库表的email列对应。5. 通过继承基础映射,可以避免重复定义公共字段,简化配置。-->
<resultMap id="ExtendedUserMap" extends="BaseUserMap" type="User"><result property="email" column="email"/>
</resultMap>

2. 构造函数映射 <constructor>

通过构造方法注入字段(适合不可变对象)。
Java 对象

public class User {private final Integer userId;private final String userName;public User(Integer userId, String userName) {this.userId = userId;this.userName = userName;}
}

映射配置

<!-- 
用户结果映射(基于构造函数)
功能:将数据库查询结果通过构造函数映射到User对象
说明:1. id="UserConstructorMap":标识这个结果映射的唯一名称。2. type="User":指定目标Java对象类型为User。3. <constructor>:表示将通过User类的构造函数来初始化对象。4. <arg column="user_id" javaType="int">:- 定义构造函数的第一个参数,对应数据库列user_id,Java类型为int。5. <arg column="user_name" javaType="String">:- 定义构造函数的第二个参数,对应数据库列user_name,Java类型为String。6. 这个结果映射要求User类有一个接受两个参数(int user_id, String user_name)的构造函数。
用法:在需要使用构造函数映射的场景下,通过这个resultMap将查询结果转换为User对象。-->
<resultMap id="UserConstructorMap" type="User"><constructor><arg column="user_id" javaType="int"/><arg column="user_name" javaType="String"/></constructor>
</resultMap>

3. 嵌套查询(分步查询)

解决关联查询的 N+1 性能问题,通过分步加载数据。

<!-- 
用户与订单的延迟加载映射 先查用户,再通过 user_id 查订单
功能:定义了一个结果映射,用于将用户信息和其关联的订单信息进行映射。在查询用户时,不会立即加载订单信息,而是通过延迟加载的方式在需要时再加载。
说明:1. id="UserWithLazyOrdersMap":标识这个结果映射的唯一名称。2. type="User":指定目标Java对象类型为User。3. <id property="userId" column="user_id">:定义User对象的userId属性与数据库表的user_id列对应,作为主键。4. <result property="userName" column="user_name">:定义User对象的userName属性与数据库表的user_name列对应。5. <collection property="orders" ofType="Order" select="com.example.OrderMapper.getOrdersByUserId" column="user_id">- property="orders":User对象中的orders属性,表示用户关联的订单集合。- ofType="Order":指定集合中元素的类型为Order。- select="com.example.OrderMapper.getOrdersByUserId":指定一个单独的SQL查询语句,用于根据用户ID查询订单信息。- column="user_id":将查询结果中的user_id列作为参数传递给子查询。-->
<resultMap id="UserWithLazyOrdersMap" type="User"><id property="userId" column="user_id"/><result property="userName" column="user_name"/><collection property="orders" ofType="Order"select="com.example.OrderMapper.getOrdersByUserId"column="user_id"/> <!-- 将 user_id 作为参数传递给子查询 -->
</resultMap><!-- 
查询用户信息(延迟加载订单)
功能:根据用户ID查询用户的基本信息,并通过延迟加载的方式获取其关联的订单信息。
说明:1. id="getUser":标识这个查询操作的唯一名称。2. resultMap="UserWithLazyOrdersMap":指定使用UserWithLazyOrdersMap结果映射来处理查询结果。3. SELECT user_id, user_name FROM users WHERE user_id = #{id}:- 查询users表中的user_id和user_name列。- WHERE user_id = #{id}:根据传入的用户ID进行查询。
用法:在Mapper接口中定义对应的方法,例如:User getUser(int id);返回一个包含用户基本信息的User对象,其orders属性在需要时才会加载。-->
<select id="getUser" resultMap="UserWithLazyOrdersMap">SELECT user_id, user_name FROM users WHERE user_id = #{id}
</select>

OrderMapper.xml

<!-- 
根据用户ID查询订单信息
功能:从orders表中查询指定用户的所有订单
参数:userId(用户ID)
返回:Order对象的列表,包含该用户的所有订单信息
说明:1. id="getOrdersByUserId":标识这个查询操作的唯一名称。2. resultType="Order":指定查询结果的类型为Order对象。3. SELECT * FROM orders WHERE user_id = #{userId}:- 查询orders表中所有列的数据。- WHERE user_id = #{userId}:条件是订单的user_id等于传入的userId参数。
用法:在Mapper接口中定义对应的方法,例如:List<Order> getOrdersByUserId(int userId);调用时传入用户ID,返回该用户的所有订单信息。-->
<select id="getOrdersByUserId" resultType="Order">SELECT * FROM orders WHERE user_id = #{userId}
</select>

在这里插入图片描述


五、常见问题与最佳实践

  1. 主键必须配置<id> 影响缓存机制,未配置可能导致性能下降。
  2. 避免过度嵌套:复杂关联建议使用分步查询(嵌套查询)减少单次 SQL 复杂度。
  3. 自动映射的取舍:简单场景可开启 autoMapping,复杂字段仍需显式配置。
  4. 性能优化:一对多关联使用懒加载(fetchType="lazy"),按需加载数据。

六、总结

拓展阅读:MyBatis映射文件常用元素详解与示例
官方文档:MyBatis | XML 映射文件
在这里插入图片描述

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/17149.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

时间盲注Boolen盲注之获取表、列、具体数据的函数

时间盲注 时间盲注&#xff08;Time-Based Blind SQL Injection&#xff09;是一种利用数据库响应时间的差异来推断数据的SQL注入技术。它的核心原理是通过构造特定的SQL查询&#xff0c;使得数据库在执行查询时产生时间延迟&#xff0c;从而根据延迟的有无来推断数据。 时间…

通过操作系统中的IO模型理解Java中的BIO,NIO,AIO

操作系统中的三种IO模型 阻塞I/O 先来看看阻塞 I/O&#xff0c;当用户程序执行 read&#xff0c;线程会被阻塞 一直等到内核数据准备好&#xff0c;并把数据从内核缓冲区拷贝到应用程序的缓冲区中&#xff0c;当拷贝过程完成&#xff0c;read 才会返回 注意&#xff1a;阻塞…

JUC并发—2.Thread源码分析及案例应用

大纲 1.什么是线程以及并发编程 2.微服务注册中心案例 3.以工作线程模式开启微服务的注册和心跳线程 4.微服务注册中心的服务注册功能 5.微服务注册中心的心跳续约功能 6.微服务的存活状态监控线程 7.以daemon模式运行微服务的存活监控线程 8.一般不常用到的ThreadGrou…

Excel函数公式合并相同项目的行数据

今天公司同事问我&#xff0c;如何将相同项目的数据行的行数据合并起来 于是我首先想到textjoin函数&#xff0c;但是条件筛选怎么办&#xff0c;后来想了下&#xff0c;可以用filter函数或者if IF公式如下 TEXTJOIN("|",TRUE,IF($A$2:$A$30A2,$B$2:$B$30,"&q…

【DeepSeek系列专栏大纲:深入探索与实践深度学习】

第一部分:深度学习基础篇 第1章:深度学习概览 1.1 深度学习的历史背景与发展轨迹 1.2 深度学习与机器学习、传统人工智能的区别与联系 1.3 深度学习的核心组件与概念解析 神经网络基础 激活函数的作用与类型 损失函数与优化算法的选择 1.4 深度学习框架简介与选择建议 第2…

Jenkins 通过 Execute Shell 执行 shell 脚本 七

Jenkins 通过 Execute Shell 执行 shell 脚本 七 一、创建 .sh 文件 项目目录下新建 .sh 文件 jenkins-script\shell\ci_android_master.sh添加 Execute Shell 模块 在 Command 中添加 # 获取 .sh 路径 CI_ANDROID_MASTER_PATH"${WORKSPACE}/jenkins-script/shell/…

NixHomepage - 简单的个人网站

&#x1f4bb; NixHomepage - 简单的个人网站 推荐下个人的开源项目&#xff0c;演示网站&#xff0c;项目链接 https://github.com/nixgnauhcuy/NixHomepage&#xff0c;喜欢的话可以为我的项目点个 Star~ &#x1f4f7; 预览 ⚙️ 功能特性 多平台适配 明亮/暗黑模式切换 W…

八大排序——简单选择排序

目录 1.1基本操作&#xff1a; 1.2动态图&#xff1a; 1.3代码&#xff1a; 代码解释 1. main 方法 2. selectSort 方法 示例运行过程 初始数组 每轮排序后的数组 最终排序结果 代码总结 1.1基本操作&#xff1a; 选择排序&#xff08;select sorting&#xff09;也…

2025有哪些关键词优化工具好用

越来越多的企业和个人开始意识到搜索引擎优化&#xff08;SEO&#xff09;对于网站曝光和业务增长的重要性。在SEO优化的过程中&#xff0c;关键词优化占据着至关重要的地位。关键词是用户在搜索引擎中输入的词语&#xff0c;优化关键词有助于提高网站在搜索结果中的排名&#…

(Xshell 8 + Xftp 8)下载安装miniconda至服务器指定目录+配置虚拟环境

一一一一 Xshell 8 Xftp 8均已登录&#xff0c;miniconda.sh安装包已经放在服务器指定目录中 二二二二 赋予脚本执行权限 chmod x Miniconda3-latest-Linux-x86_64.sh安装miniconda ./Miniconda3-latest-Linux-x86_64.sh -p /data1/huyan/zhangyifeng/miniconda3一直Enter…

Python学习

1 class MyClass:def __init__(self):print("Constructor called.")def __str__(self):return "MyClass instance"obj MyClass()print(obj) # 调用__str__方法 在Python中&#xff0c;__str__是一个特殊的方法&#xff0c;当你使用print()函数打印一个…

vueDevtools和文档整合(前端常用工具/插件)

3.vueDevtools安装 chrome插件vue-devtools下载地址&#xff1a; https://chrome.zzzmh.cn/info/nhdogjmejiglipccpnnnanhbledajbpd下载完放到chrome的拓展程序中即可&#xff0c;注意点&#xff1a;vue2和vue3下载版本不同&#xff0c;vue2的话使用稍微老点的版本才行。 详细…

dify.ai 配置链接到阿里云百练等云厂商的 DeepSeek 模型

要将 dify.ai 配置链接到阿里云百练等云厂商的 DeepSeek 模型. 申请阿里云百练的KEY 添加模型 测试模型

将Sqlite3数据库挂在内存上处理

创作灵感&#xff1a;最近把小学生的口算题从2位数改到3位数&#xff0c;100以内四则运算练习&#xff08;千纬数学&#xff09;再次更新&#xff0c;选取难题-CSDN博客要不断刷题目&#xff0c;以前100以内的加减乘除也是这样刷出来的&#xff0c;代码如下&#xff1a; impor…

【第1章:深度学习概览——1.1 深度学习的历史背景与发展轨迹】

你可能不知道,现在能自动给照片上色、帮医生看CT片、甚至写诗作曲的AI技术,其实早在二战时期就埋下了种子。这段故事里充满了天才的灵光乍现、整个行业的集体打脸、以及无数个"山穷水尽疑无路,柳暗花明又一村"的神转折。系好安全带,我们要从1943年的脑科学实验室…

九.Spring Boot使用 ShardingSphere + MyBatis + Druid 进行分库分表

文章目录 前言一、引入依赖二、创建一个light-db_1备用数据库三、配置文件 application-dev.yml四、创建shardingsphere-config.yml完整项目结构 五、测试总结 前言 在现代化微服务架构中&#xff0c;随着数据量的不断增长&#xff0c;单一数据库已难以满足高可用性、扩展性和…

XSS 常用标签及绕过姿势总结

XSS 常用标签及绕过姿势总结 一、xss 常见标签语句 0x01. 标签 <a href"javascript:alert(1)">test</a> <a href"x" onfocus"alert(xss);" autofocus"">xss</a> <a href"x" onclickeval(&quo…

Ubuntu20.04上搭建nginx正向代理提供上网服务

背景&#xff1a;公司很多电脑因软件管控问题不得不禁止设备上网&#xff0c;现需搭建上网代理服务器提供给这些用户使用。 操作系统&#xff1a;ubuntu20.04 工具&#xff1a;nginx-1.25.4 1、下载nginx安装包及依赖 由于nginx默认只持支持转发http协议&#xff0c;所以如…

deepseek的CoT优势、两阶段训练的有效性学习笔记

文章目录 1 DeepSeek的CoT思维链的优势1.2 open-r1的CoT训练数据1.3 ReAct任务与CoT任务适用场景 2 AI推理方向&#xff1a;deepseek与deepmind的两条路线的差异2.1 PRM与ORM的两大学派分支的差异2.2 DeepSeek-R1的两阶段训练概述 1 DeepSeek的CoT思维链的优势 DeepSeek跟之前…

DeepSeek批量生成全平台推广营销内容:高效提升营销效率

在这个信息爆炸的时代&#xff0c;内容营销的重要性不言而喻。无论是企业的官方网站、社交媒体账号&#xff0c;还是电商平台&#xff0c;都需要源源不断的高质量内容来吸引和留住用户。面对多平台发布的需求&#xff0c;人工撰写内容不仅耗时耗力&#xff0c;还容易出现内容质…