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

【实体转换】mapstruct详解

news 来源：原创 2025/8/16 17:55:58

大家好，我是jstart千语。今天来给大家讲讲在项目中经常可以使用得到的一个“工具”，就是mapstruct。

一、工具介绍

这个工具有些类似于spring提供的BeanUtils.copyProperties()用于对象转化。而mapstruct是通过生成高效的、类型安全的映射代码来帮助开发人员在不同的数据对象之间进行转换。但他们的实现方式大有不同，从而他们从性能方面也会有差异。

总得来说，如果项目中使用到的实体转换场景不多，那么使用BeanUtils就可以了，但如果项目中需要大量使用到实体转换，那么使用mapstruct在提高性能方面就是一个很好的选择。

二、引入依赖

一般来说引入两个依赖，但是如果你用到了lombok依赖，一定要将lombok依赖放到mapstruct依赖前面。

        <!-- lombok --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency>        <!-- mapstruct --><dependency><groupId>org.mapstruct</groupId><artifactId>mapstruct</artifactId><version>1.4.2.Final</version></dependency><dependency><groupId>org.mapstruct</groupId><artifactId>mapstruct-processor</artifactId><version>1.4.2.Final</version></dependency>

三、实现方法

mapstruct的实现方法有两种方式：

依靠spring的依赖注入实现
通过使用mapstruct静态工厂来实现

区别：

spring依赖注入	更符合spring的代码风格，支持自动注入其他 Bean。
mapstruct静态工厂	简单直接，实例生命周期需手动管理

两种在性能上没有什么区别，我更喜欢用静态工厂这种方法，因为它足够简单，只需要一行代码就可以搞定。

1、spring依赖注入方式

定义Mapper接口，使用@Mapper注解并指定componentModel = "spring"，使其成为Spring Bean

// Mapper 接口（配置 componentModel = "spring"）
@Mapper(componentModel = "spring")
public interface JudgeSubjectConverter {JudgeSubjectDTO toDto(JudgeSubject judgeSubject);
}// 使用方式（通过注入）
@Service
public class MyService {@Autowiredprivate JudgeSubjectConverter judgeSubjectConverter;public void process() {JudgeSubject judgeSubject = new JudgeSubject();JudgeSubjectDTO judgeSubjectDTO = judgeSubjectConverter.toDto(judgeSubject);}
}

2、mapstruct静态工厂

@Mapper
public interface JudgeSubjectConverter {JudgeSubjectConverter INSTANCE = Mappers.getMapper(JudgeSubjectConverter.class);JudgeSubjectDTO toDto(JudgeSubject judgeSubject);
}// 使用方式：直接通过类名调用
@Service
public void myService(){//...JudgeSubject judgeSubject = new JudgeSubject();JudgeSubjectDTO judgeSubjectDTO = JudgeSubjectConverter.INSTANCE.toDto(judgeSubject);//...}

3、共同功能

首先记得添加@Mapper注解时，导入的是mapstruct的包，不要导入了mybatis的包了。

（1）处理字段映射

默认的映射关系就是只有属性名相同才会映射转换，如果两个实体的属性名不同还需要进行转换的话就需要手动映射。

public class User {private String email;
}public class UserDTO {private String emailAddress;
}// Mapper 接口
@Mapper
public interface UserMapper {@Mapping(source = "email", target = "emailAddress")UserDTO toDto(User user);
}

（2）忽略字段

public class User {private String password;
}public class UserDTO {private String password; // 不希望映射此字段
}// Mapper 接口
@Mapper
public interface UserMapper {@Mapping(target = "password", ignore = true)UserDTO toDto(User user);
}

（3）格式化日期

public class User {private Date createTime;
}public class UserDTO {private String createTime;
}// Mapper 接口
@Mapper
public interface UserMapper {@Mapping(target = "createTime", dateFormat = "yyyy-MM-dd HH:mm:ss")UserDTO toDto(User user);
}

（4）多源对象映射

public class Order {private String orderId;
}public class User {private String userId;
}public class OrderDTO {private String orderId;private String userId;
}// Mapper 接口
@Mapper
public interface OrderMapper {@Mapping(source = "order.orderId", target = "orderId")@Mapping(source = "user.userId", target = "userId")OrderDTO toDto(Order order, User user);
}

例2：

/**
*题目信息表
*/
@Data
public class SubjectInfo implements Serializable {private static final long serialVersionUID = -71318372165220898L;/*** 主键*/private Long id;/*** 题目名称*/private String subjectName;}
---------------------------------------------------------------------------------------/**
*题目DTO
*/
@Data
public class SubjectOptionBO implements Serializable {/*** 题目答案*/private String subjectAnswer;/*** 题目选项的答案内容*/private List<SubjectAnswerBO> optionList;}
---------------------------------------------------------------------------------------
/**
*题目BO
*/
@Data
public class SubjectInfoBO extends PageInfo implements Serializable {//主键private Long id;//题目名称private String subjectName;//题目答案private String subjectAnswer;//答案选项private List<SubjectAnswerBO> optionList;}
---------------------------------------------------------------------------------------/**
* 多源类型转换
*/
@Mapper
public interface SubjectInfoConverter {SubjectInfoBO convertOptionAndInfoToBo(SubjectOptionBO subjectOptionBO,SubjectInfo subjectInfo);
}

（5）设置默认值

当源字段为 null 时，使用默认值：

@Mapping(target = "description", source = "desc", defaultValue = "暂无描述")
ProductDTO toDto(Product product);

（6）设置常量值

直接为目标字段赋固定值：

@Mapping(target = "type", constant = "VIP")
UserDTO toDto(User user);

四、与BeanUtils.copyProperties()比较

他们两个都可以进行对象转换，最主要的区别就是性能上了。

（1）Spring 的 BeanUtils.copyProperties()

底层是通过 Java 的反射机制实现的：

运行时获取源对象和目标对象的 getter/setter 方法；
检查方法签名是否匹配；
动态调用 setXxx() 设置属性值。

性能影响：

反射调用慢：反射比直接方法调用慢得多，因为它要解析类结构、做安全检查、动态调用方法；
运行期做类型判断和匹配：每次调用都要做这些检查；
不可内联优化：JVM 对反射方法优化很有限，无法像普通方法调用一样 JIT 编译优化。

（2）MapStruct 是编译期生成代码（纯 Java）

MapStruct 在你编译代码的时候，就自动生成了普通 Java 类和方法来做对象转换，不使用反射。

这些方法就是标准的 obj.setXxx(obj.getYyy())；
完全等同于你自己写一堆 setter 调用，只不过 MapStruct 自动帮你写好了。

性能优势：

没有反射开销；
纯 Java 调用，JVM 可以 JIT 优化、内联优化；
内存更友好，因为不需要动态创建 Method 对象；
执行速度接近你手写转换方法的极限。

（3）MapStruct 字节码展示

编译完后：

【实体转换】mapstruct详解

大家好，我是jstart千语。今天来给大家讲讲在项目中经常可以使用得到的一个“工具”，就是mapstruct。一、工具介绍这个工具有些类似于spring提供的BeanUtils.copyProperties()用于对象转化。而mapstruct是通过生成高效的、类型安全的映射代码来帮助开发…...

编程日记 2025/8/16 17:55:58

部署路线Ubuntu_MySQL_Django_绑定域名

第 1 步：绑定域名（DNS） 在域名服务商后台（例如阿里云 / 腾讯云 / Cloudflare）中设置： A 记录 →域名 → 指向服务器公网 IP 可选：也加一个 www.域名 → 同样指向服务器第 2 步：安…...

编程日记 2025/8/11 18:02:01

大屏设计与汇报：政务服务可视化实践

大屏设计与汇报：政务服务可视化实践引言在政务服务数字化转型浪潮中，大屏设计成为展现业务能力与数据价值的关键手段。本文围绕政务大屏设计，从设计要点、业务逻辑到汇报技巧展开深入探讨，为相关从业者提供全面参考。一、大屏设计核心要点（一）多维度考量设计大…...

编程日记 2025/8/14 12:59:17

【MySQL】数据库和表的操作详解

目录一、数据库： 1、查看数据库： 2、创建数据库： 3、删除数据库： 4、数据库的编码问题： 5、校验规则对数据库的影响： 6、修改数据库： 7、库的备份与恢复： 8、查看链接情况…...

编程日记 2025/8/16 17:50:02

从PDF到播客：MIT开发的超越NotebookLM的工具

NotebookLM是谷歌推出的更具创意的AI产品之一，几个月前刚刚推出。许多人对它的能力感到惊叹——尤其是将长文本转化为两位播客主持人之间有趣对话的功能。 NotebookLM提供的不仅仅是这些，还包括聊天（问答）甚至生成思维导图。如果你还没有尝试过NotebookLM，我强烈建议…...

编程日记 2025/8/15 21:33:26

ubuntu系统上基于RKE2部署K8S及Rancher

由于我们特殊的网络环境，所以只能使用国内资源来进行安装 - Rancher Releases Mirrors：https://mirror.rancher.cn/ - 阿里云镜像仓库：registry.cn-hangzhou.aliyuncs.com 1、配置资源仓库及token rootdemo-1:~# mkdir -p /etc/rancher/r…...

编程日记 2025/8/14 7:35:34

STM32单片机入门学习——第40节: [11-5] 硬件SPI读写W25Q64

写这个文章是用来学习的,记录一下我的学习过程。希望我能一直坚持下去,我只是一个小白,只是想好好学习,我知道这会很难，但我还是想去做！ 本文写于：2025.04.18 STM32开发板学习——第一节： [1-1]课程简介第40节: [11-5] 硬件SPI读…...

编程日记 2025/8/9 14:22:03

vue3学习笔记之属性绑定

属性绑定 1. 基本语法在 Vue 3 里，使用 : 或者 v-bind: 来进行属性绑定。这两种写法是等价的，: 是 v-bind: 的缩写形式。以下是示例代码： <template><img :src"imageUrl" alt"An exa…...

编程日记 2025/8/15 5:19:16

C++ 面向对象关键语法详解：override、虚函数、转发调用和数组引用传参-策略模式

int A(参数...) override { return 某个对象.A(参数...);} 一.目标本文将用一个简单的“数学运算器”例子，从零解释以下 C 语法特性： virtual 虚函数 override 重写关键字函数体内部的“转发调用” 数组引用作为函数参数适合初学者和希望加深…...

编程日记 2025/8/16 10:35:29

Spring_MVC 快速入门指南

Spring_MVC 快速入门指南一、Spring_MVC 简介 1. 什么是 Spring_MVC？ Spring_MVC 是 Spring 框架的一个模块，用于构建 Web 应用程序。它基于 MVC（Model-View-Controller）设计模式，将应用程序分为模型（M…...

编程日记 2025/8/12 4:56:30

Starrocks 数据均衡DiskAndTabletLoadReBalancer的实现

背景最近在研究了一下 Starrocks的tablet的Rebalance的能力，这里进行记录一下本文基于 StarRocks 3.3.5 结论数据的rebalance 主要以两种模式来进行： 按照磁盘的使用率进行移动，如果每个BE的磁盘使用率不足tablet_sched_balance_load_…...

编程日记 2025/8/16 17:54:09

设计模式之工厂方法模式

1. 核心思想工厂方法模式（Factory Method Pattern）将对象的创建过程延迟到子类。具体来说，定义一个创建对象的接口（抽象工厂），但由子类决定实例化哪个具体类。这种方式解耦了对象的创建和使用&#xff0c…...

编程日记 2025/8/16 17:55:34

ubuntu学习day3

3 编译与调试 3.1 gcc/g编译器当我们进行编译的时候，要使用一系列的工具，我们称之为工具链。SDK就是编译工具链的简写，我们所使用的是gcc系列编译工具链。使用-v参数来查看gcc的版本，从而确定某些语法特性是否可用，…...

编程日记 2025/8/16 17:51:48

【从零实现高并发内存池】申请、释放内存过程联调测试与大于256KB内存申请全攻略

📢博客主页：https://blog.csdn.net/2301_779549673 📢博客仓库：https://gitee.com/JohnKingW/linux_test/tree/master/lesson 📢欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！ &…...

编程日记 2025/8/16 17:49:45

main.ts文件 //引入暗黑模式样式 import "element-plus/theme-chalk/dark/css-vars.css"; style.scss文件 // 设置默认主题色 :root {--base-menu-min-width: 80px;--el-color-primary-light-5: green !important;--route--view--background-color: #fff !import…...

编程日记 2025/8/16 17:50:03

第八周作业

1、使用Sqlmap工具完成对DVWA数据库的注入过程，要求按照库、表、列、内容的顺序进行注入使用kali自带的sqlmap工具进行 (1)爆破库名 sqlmap -u "http://10.0.0.5:8080/vulnerabilities/sqli/?id1&SubmitSubmit#" -p id --cookie "PHPSESSID…...

编程日记 2025/8/16 17:53:13

工作督导 | 具有边缘型人格障碍倾向的高危来访者，咨询师如何应对？

一个学校心理中心，可能同时有几十位乃至数百位同学在接受咨询，其中大约10-20%是重点难点个案，一次督导如果只能督导1-2个个案，不足以保障所有危重难个案的有如何处理恰当、方向正确、快速解决、高效工作，是学校心理咨询…...

编程日记 2025/8/10 23:48:54

c++ map与unordered_map的比较

c map与unordered_map的比较在c的STL库中，有map与unordered_map这两种名字十分相似的容器，但是他们的区别还是很大，下面我们从底层实现、性能特性和适用场景进行逐一比较底层实现 std::mapstd::unordered_map底层数据结构红黑树&…...

编程日记 2025/8/5 16:53:54

新手蓝桥杯冲击国一练习题单(四)

2025蓝桥杯省赛已结束，接下来是冲击国赛的时间此题单为算法基础精选题单，包含蓝桥杯常考考点以及各种经典算法，可以帮助你打牢基础，查漏补缺。本题单目标是冲击蓝桥杯省一国一，团体程序天梯赛个人国三、XCPC区域赛铜…...

编程日记 2025/8/5 16:53:52

PyTorch深度学习框架60天进阶学习计划 - 第45天：神经架构搜索（一）

PyTorch深度学习框架60天进阶学习计划 - 第45天：神经架构搜索（一） 第一部分：详解DARTS的可微分搜索空间大家好！欢迎来到我们PyTorch深度学习框架进阶学习计划的第45天。今天我们将深入探讨神经架构搜索(Neural Arch…...

编程日记 2025/8/16 1:37:49

【java 13天进阶Day04】常用API、正则表达式，泛型、Collection集合API

Math类的使用。 Math用于做数学运算。Math类中的方法全部是静态方法，直接用类名调用即可。方法： public static int abs(int a) 获取参数a的绝对值public static double ceil(double a) 向上取整public static double floor(double a) 向下取整public s…...

编程日记 2025/8/16 17:51:50

leetcode 309. Best Time to Buy and Sell Stock with Cooldown

目录题目描述第一步，明确并理解dp数组及下标的含义第二步，分析并理解递推公式 1.求dp[i][0] 2.求dp[i][1] 3.求dp[i][2] 第三步，理解dp数组如何初始化第四步，理解遍历顺序代码题目描述这道题与第122题的区别就是卖…...

编程日记 2025/8/16 17:54:09

RAG 实战｜用 StarRocks + DeepSeek 构建智能问答与企业知识库

文章作者： 石强，镜舟科技解决方案架构师赵恒，StarRocks TSC Member 👉 加入 StarRocks x AI 技术讨论社区 https://mp.weixin.qq.com/s/61WKxjHiB-pIwdItbRPnPA RAG 和向量索引简介 RAG（Retrieval-Augmented Gen…...

编程日记 2025/8/15 9:55:27

Java拼团项目

一些记录环境配置首先是把配置安装好，jdk1.8，maven3.8.8，docker，idea，脚手架然后创建工程，通过小傅哥的脚手架从远程把一些包，依赖拉过来然后在gitcode上边创建仓库，把代码提交…...

编程日记 2025/8/14 22:01:58

力扣每日打卡 2364. 统计坏数对的数目 (中等)

力扣 2364. 统计坏数对的数目中等前言一、题目内容二、解题方法1. 哈希函数12. 哈希函数22.官方题解2.1 方法一：使用 sqrt 函数前言这是刷算法题的第十四天，用到的语言是JS 题目：力扣 2364. 统计坏数对的数目 (中等) 一、题目内容给你…...

编程日记 2025/8/15 12:01:22

R语言之.rdata文件保存及加载

在 R 中，.rdata 文件是通过 save() 函数创建的。使用 save() 函数可以将一个或多个 R 对象保存到 .rdata 文件中。使用 load() 函数可以将 .rdata 文件中的对象恢复到当前工作环境中。 1.创建并保存对象到.rdata 假设有一个基于 iris 数据集训练的线性回归模型&a…...

编程日记 2025/8/16 17:54:06

神经网络优化 - 小批量梯度下降之批量大小的选择

上一博文学习了小批量梯度下降在神经网络优化中的应用： 神经网络优化 - 小批量梯度下降-CSDN博客在小批量梯度下降法中，批量大小(Batch Size)对网络优化的影响也非常大，本文我们来学习如何选择小批量梯度下降的批量大小。一、批量大小的…...

编程日记 2025/8/16 17:55:57

开源AI守护每一杯------奶茶咖啡店视频安全系统的未来之力

连锁饮品奶茶咖啡店视频安全系统以开源AI技术为引擎，将后厨管理从“被动查漏”升级为“主动防控”，让消费者从“担心卫生”变为“放心下单”。解决方案亮点：技术驱动，全面防护 1. 实时监控与AI识别：秒级捕捉隐患亮…...

编程日记 2025/8/16 17:51:31

音视频元素

目录 HTMLMediaElement网络状态 (networkState)就绪状态 (readyState)错误代码 (error.code) video属性方法事件 audio HTMLMediaElement HTMLMediaElement 是 HTML5 中和元素的基类，定义了它们共享的属性、方法和事件。无论你使用的是音频还是视频元素&#xff0…...

编程日记 2025/8/16 17:53:14

音视频小白系统入门课-2

本系列笔记为博主学习李超老师课程的课堂笔记，仅供参阅课程传送门：音视频小白系统入门课音视频基础ffmpeg原理往期课程笔记传送门： 音视频小白系统入门笔记-0音视频小白系统入门笔记-1 课程实践代码仓库：传送门音视频编解…...

编程日记 2025/8/16 8:40:20

时序逻辑电路——序列检测器

文章目录一、序列检测二、牛客真题1. 输入序列连续的序列检测（输入连续、重叠、不含无关项、串行输入）写法一：移位寄存器写法二：Moore状态机写法三：Mealy状态机一、序列检测序列检测器指的就是将一个指定的序列&…...

编程日记 2025/8/16 17:53:16

#systemverilog# 进程控制问题#（八）关于#0 问题的使用（三）

今天，我们继续研究一下上一节讨论的问题。其实，还有一个小问题，我们来探讨一下。 `timescale 1ns/10psmodule tb_top(); reg clk; reg reset;initial begin reset = 0; #10 reset = 1; #15 reset = 0; #50 $finish; endinitial beginfor(int i = 0; i < 4 ; i++)fork #…...

编程日记 2025/8/16 17:51:51

k8s低版本1.15安装prometheus+grafana进行Spring boot数据采集

目录一、背景： 二、实施过程 1）.安装地址：https://github.com/prometheus-operator/kube-prometheus 2).安装方式两种， 3）.安装Prometheus需要对照k8s集群版本。 4）.拉去prometheus 5）.导…...

编程日记 2025/8/14 5:26:40

Spring-Ioc容器的加载过程？

大家好，我是锋哥。今天分享关于【SpringIoC的实现机制是什么？】面试题。希望对大家有帮助； Spring-Ioc容器的加载过程？ 1000道互联网大厂Java工程师精选面试题-Java资源分享网 Spring IoC容器的加载过程是指在应用启动时&…...

编程日记 2025/8/16 17:49:45

kaamel Privacy agent：AI赋能的隐私保护技术解决方案

智能隐私合规解决方案在当今数字经济环境下，有效的隐私合规已成为企业运营的基础要求。全球范围内已有超过120项隐私法规生效，这对企业的数据处理流程提出了严峻挑战。kaamel Privacy agent作为专门为隐私合规领域设计的AI引擎，通过自动化技…...

编程日记 2025/8/16 17:55:32

从零到上线！AI生成SpringBoot项目脚手架实战（含K8s+Docker配置）

在 Java 开发领域,搭建 Spring Boot 项目脚手架是一项耗时且繁琐的工作。传统方式下,开发者需要手动配置各种依赖、编写基础代码,过程中稍有疏忽就可能导致配置错误,影响开发进度。如今,随着 AI 技术的迅猛发展,飞算 JavaAI 的出现为开发者带来了全新解决方案,让自动生成 Sprin…...