领域架构对象转换利器MapStruct

架构小魔方2024-09-24 16:57:10  54

做java开发的程序员相信都读过阿里版的开发规范,可能还不只读一次,是反反复复的读那种,在阿里开发规范有这么一节应用分层。从显示层->web请求处理层->service业务逻辑层->manger通用业务处理层->dao数据持久层,上层依赖下层这么一个工程结构,这也是目前大多数企业开发使用的工程分层,每个公司大同小异。

同时为了层与层之间的解耦,也会有对应的分层领域模型,前端到web层用VO对象,显示层到Service层用DTO对象,Service层到dao数据层用DO对象,虽然这种领域分层的思想能带来层与层之间的逻辑解耦,让每层专注于自己的核心职责和逻辑,避免所有代码写在一起像一团乱麻一样,提升了代码的可读性和可维护性,但同样也带来另一个问题,层与层之间为了解耦,定义了太多的领域对象模型,对象模型之间需要进行转换,开发的成本直线上升,那么有没有办法能减少这块的工作呢?答案是肯定的。

对象转换的几种方法

一、get/set赋值方式:这种一般用于对象属性较少,如果碰到对象属性多的情况,就很容易眼花缭乱,一不小心就写错了,耗时耗力先不说,同时也会带来整个代码段非常的臃肿,几十上百行都是在get/set。

二、Apache BeanUtils:直接用apache的工具类BeanUtils.copyProperties进行对象拷贝,但使用了很多反射,做了很多校验,所以导致性能较差,一般用在对性能要求不太高的业务中去使用,如果你是使用了spring 框架,也可以使用Spring 自带的BeanUtils.copyProperties,在性能方面比它要好些,去掉了一些不必要的校验以及增加了一些缓存的机制,加快了转换的速度。

三、MapStruct:它是基于编译时的一个框架,在编译期间就将代码进行生成class文件,所以和我们使用get/set 方法的性能是一致的。

当然还有一些不是很常用的转换方法,比如通过JSON的方式进行转换,通过基于cglib的动态代理BeanCopier的方式进行转换等等。

MapStruct

一、如何使用?

拿官方的使用文档的说明作为例子

第一步:引入jar包,目前最新版本是1.6.2版本,因为是编译时生成class文件,所以还需要引入maven plugin

... 1.6.2... org.mapstruct mapstruct ${org.mapstruct.version} ... org.apache.maven.plugins maven-compiler-plugin 3.8.1 1.8 1.8 org.mapstruct mapstruct-processor ${org.mapstruct.version} ...

第二步:准备好两个需要进行转换的对象

public class Car { private String make; private int numberOfSeats; private CarType type; //constructor, getters, setters etc.}public class CarDto { private String make; private int seatCount; private String type; //constructor, getters, setters etc.}

第三步:定义转移的mapper类,如果原对象属性和目标对象属性不一致,可以使用mapping进行字段映射,一致的话就不需要进行映射了。

@Mapper public interface CarMapper { CarMapper INSTANCE = Mappers.getMapper( CarMapper.class ); @Mapping(source = "numberOfSeats", target = "seatCount") CarDto carToCarDto(Car car); }

一个简单的对象之间的转换就完成了,是不是so easy。

当然针对于一些复杂的属性转换,也可以自己自定义转换类,详细可以参考mapstrut的官方使用文档https://mapstruct.org/documentation/stable/reference/html

二、MapStruct避坑误区

对象属性转换的坑

1、MapStruct能够帮助我们在一些类型之间进行自动转换,比如Long 映射成为Integer,这个时候就会出现当Long的数值超过Integer的最大值,出现值溢出的现象

2、对于一些日期的转换,Mapstruct进行时间格式化时,采用的是默认时区UTC,这就会导致时间出现问题。

要避免此类问题,尽量避免出现原对象的属性类型与目标对象的属性一致,实在要进行转换,需要查看MapStruct生成后的源码情况时什么。

.....

和Lombok共用的坑

如果我们对象使用 Lombok 的话,使用 @Mapping指定不同字段名,编译期间可能会报错,这是因为Lombok 也是编译期时自动生成代码,这两者可能导致冲突,当 MapStruct 生成代码时,还不存在 Lombok 生成的代码。

解决这类问题的方法,就是maven plugin增加lombok。

org.apache.maven.plugins maven-compiler-plugin 3.8.1 1.8 1.8 org.mapstruct mapstruct-processor ${org.mapstruct.version} org.projectlombok lombok ${org.projectlombok.version}

当然mapstrut使用还有很多其他的误区,要避免在使用过程尽量不犯错或者是少犯错,建议多看下它编译后生成的源码文件,毕竟自动生成的代码也有可能存在问题,通过查看这些代码,也可以帮助我们了解mapstrut是如何映射的,有助于我们发现问题解决问题。

转载此文是出于传递更多信息目的。若来源标注错误或侵犯了您的合法权益,请与本站联系,我们将及时更正、删除、谢谢。
https://www.414w.com/read/1296363.html
0
随机主题
福特EVOS命名为蒙迪欧运动版, 官图发布, 搭载2.0T混动系统男单爆大冷! 男单世界冠军2-3日本选手, 无缘开门红, 球迷很意外陈哲远出道时碰到伊能静,是娱乐圈给他的最大善意英国国防大臣称: 欧洲的中立国如果还想得到保护, 就必须加入北约企业用车合规透明新选择!《披哥4》曝光嘉宾名单, 李佳琦黑泽良平在列, 李克勤带队大咖少成都: 6月起将对骑车看手机行为进行处罚当年罗杰对小香克斯说了什么, 贝加庞克对话草帽团给出答案DNF手游: 白嫖“赛丽亚的思念”称号, 新手练级注意事项楚悦辰: 5.23黄金现价2380空单进场, 目标2350“土包子”翻身记, 更新潮的燕京啤酒和年轻人做朋友!武则天已经打算还政李唐, 为何张柬之等人还要发动神龙政变?实测电脑内存条DDR5的 7600能比6400频率提升多少帧 内存条避坑指南俄罗斯从三家欧洲银行扣押了价值超过7亿欧元的资产梅西检阅防线的背后,敏锐的洞察让针对防守形同虚设。低配渡江芙蓉枪! 平民玩家的不二选择!货币工具持续支持“三大工程”突发! 2换1交易方案曝光: 乔治加盟公牛, 拉文驰援哈登小卡?求新、求变的《梦幻西游》追求的是有血有肉的角色!李彦宏吐槽AI发展速度“太慢了,AGI还要十年以上”,英语流利秒杀一大帮老对手郭德纲唱戏水平真的差吗?众多业内大佬出面力挺
最新回复(0)