Java对象转换方案分析与mapstruct实践-CSDN博客

本文链接：https://blog.csdn.net/2401_84411847/article/details/137935221

2 BeanUtil类

BeanUtil.copyProperties()结合手写get、set，对于简单的转换直接使用BeanUtil，复杂的转换自己手工写get、set。该方案的痛点就在于代码编写效率低、冗余繁杂还略显丑陋，并且BeanUtil因为使用了反射invoke去赋值性能不高。

只能适合bean数量较少、内容不多、转换不频繁的场景。

apache.BeanUtils

org.apache.commons.beanutils.BeanUtils.copyProperties(do, entity);

这种方案因为用到反射的原因，同时本身设计问题，性能比较差。集团开发规约明确规定禁止使用。

Java对象转换方案分析与mapstruct实践

spring.BeanUtils

org.springframework.beans.BeanUtils.copyProperties(do, entity);

这种方案针对apache的BeanUtils做了很多优化，整体性能提升不少，不过还是使用反射实现比不上原生代码处理，其次针对复杂场景支持能力不足。

Java对象转换方案分析与mapstruct实践

3 beanCopier

BeanCopier copier = BeanCopier.create(CarDO.class, CarDTO.class, false);

copier.copy(do, dto, null);

这种方案动态生成一个要代理类的子类,其实就是通过字节码方式转换成性能最好的get和set方式,重要的开销在创建BeanCopier，整体性能接近原生代码处理，比BeanUtils要好很多，尤其在数据量很大时，但是针对复杂场景支持能力不足。

4 各种Mapping框架

分类

Object Mapping 技术从大的角度来说分为两类，一类是运行期转换，另一类则是编译期转换：

运行期反射调用 set/get 或者是直接对成员变量赋值。这种方式通过invoke执行赋值，实现时一般会采用beanutil, Javassist等开源库。运行期对象转换的代表主要是Dozer和ModelMaper。
编译期动态生成 set/get 代码的class文件，在运行时直接调用该class的 set/get 方法。该方式实际上仍会存在 set/get 代码，只是不需要开发人员自己写了。这类的代表是：MapStruct,Selma,Orika。

分析

无论哪种Mapping框架，基本都是采用xml配置文件 or 注解的方式供用户配置，然后生成映射关系。
编译期生成class文件方式需要DTO仍然有set/get方法，只是调用被屏蔽；而运行期反射方式在某些直接填充 field的方案中，set/get代码也可以省略。
编译期生成class方式会有源代码在本地，方便排查问题。
编译期生成class方式因为在编译期才出现java和class文件，所以热部署会受到一定影响。
反射型由于很多内容是黑盒，在排查问题时，不如编译期生成class方式方便。参考GitHub上工程java-object-mapper-benchmark可以看出主要框架性能比较。
反射型调用由于是在运行期根据映射关系反射执行，其执行速度会明显下降N个量级。
通过编译期生成class代码的方式，本质跟直接写代码区别不大，但由于代码都是靠模板生成，所以代码质量没有手工写那么高，这也会造成一定的性能损失。

Java对象转换方案分析与mapstruct实践

综合性能、成熟度、易用性、扩展性，mapstruct是比较优秀的一个框架。

三 Mapstruct使用指南

1 Maven引入

Java对象转换方案分析与mapstruct实践

2 简单入门案例

DO和DTO

这里用到了lombok简化代码，lombok的原理也是在编译时去生成get、set等被简化的代码。

@Data

public class Car {

private String make;

private int numberOfSeats;

private CarType type;

}

@Data

public class CarDTO {

private String make;

private int seatCount;

private String type;

}

定义Mapper

@Mapper中描述映射，在编辑的时候mapstruct将会根据此描述生成实现类：

当属性与其目标实体副本同名时，它将被隐式映射。
当目标实体中的属性具有不同名称时，可以通过@Mapping注释指定其名称。

@Mapper

public interface CarMapper {

@Mapping(source = “numberOfSeats”, target = “seatCount”)

CarDTO CarToCarDTO(Car car); }

使用Mapper

通过Mappers 工厂生成静态实例使用。

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “numberOfSeats”, target = “seatCount”)

CarDTO CarToCarDTO(Car car);

}

Car car = new Car(…);

CarDTO carDTO = CarMapper.INSTANCE.CarToCarDTO(car);

getMapper会去load接口的Impl后缀的实现类。

Java对象转换方案分析与mapstruct实践

通过生成spring bean注入使用，Mapper注解加上spring配置，会自动生成一个bean，直接使用bean注入即可访问。

@Mapper(componentModel = “spring”)

public interface CarMapper {

@Mapping(source = “numberOfSeats”, target = “seatCount”)

CarDTO CarToCarDTO(Car car);

}

自动生成的MapperImpl内容

如果配置了spring bean访问会在注解上自动加上@Component。

Java对象转换方案分析与mapstruct实践

3 进阶使用

逆向映射

如果是双向映射，例如从DO到DTO以及从DTO到DO，正向方法和反向方法的映射规则通常是相似的，并且可以通过切换源和目标来简单地逆转。

使用注解@

InheritInverseConfiguration 指示方法应继承相应反向方法的反向配置。

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “numberOfSeats”, target = “seatCount”)

CarDTO CarToCarDTO(Car car);

@InheritInverseConfiguration

Car CarDTOToCar(CarDTO carDTO);

}

更新bean映射

有些情况下不需要映射转换产生新的bean，而是更新已有的bean。

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “numberOfSeats”, target = “seatCount”)

void updateDTOFromCar(Car car, @MappingTarget CarDTO carDTO);

集合映射

集合类型（List，Set，Map等）的映射以与映射bean类型相同的方式完成，即通过在映射器接口中定义具有所需源类型和目标类型的映射方法。MapStruct支持Java Collection Framework中的多种可迭代类型。

生成的代码将包含一个循环，该循环遍历源集合，转换每个元素并将其放入目标集合。如果在给定的映射器或其使用的映射器中找到用于集合元素类型的映射方法，则将调用此方法以执行元素转换，如果存在针对源元素类型和目标元素类型的隐式转换，则将调用此转换。

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “numberOfSeats”, target = “seatCount”)

CarDTO CarToCarDTO(Car car);

List carsToCarDtos(List cars);

Set integerSetToStringSet(Set integers);

@MapMapping(valueDateFormat = “dd.MM.yyyy”)

Map<String, String> longDateMapToStringStringMap(Map<Long, Date> source);

}

编译时生成的实现类：

Java对象转换方案分析与mapstruct实践

多个源参数映射

MapStruct 还支持具有多个源参数的映射方法。例如，将多个实体组合成一个数据传输对象。

在原案例新增一个Person对象，CarDTO中新增driverName属性，根据Person对象获得。

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “car.numberOfSeats”, target = “seatCount”)

@Mapping(source = “person.name”, target = “driverName”)

CarDTO CarToCarDTO(Car car, Person person); }

编译生成的代码：

Java对象转换方案分析与mapstruct实践

默认值和常量映射

如果相应的源属性是null ，则可以指定默认值以将预定义值设置为目标属性。在任何情况下，都可以指定常量来设置这样的预定义值。默认值和常量被指定为字符串值。当目标类型是原始类型或装箱类型时，String 值将采用字面量，在这种情况下允许位/八进制/十进制/十六进制模式，只要它们是有效的文字即可。在所有其他情况下，常量或默认值会通过内置转换或调用其他映射方法进行类型转换，以匹配目标属性所需的类型。

@Mapper

public interface SourceTargetMapper {

SourceTargetMapper INSTANCE = Mappers.getMapper( SourceTargetMapper.class );

@Mapping(target = “stringProperty”, source = “stringProp”, defaultValue = “undefined”)

@Mapping(target = “longProperty”, source = “longProp”, defaultValue = “-1”)

@Mapping(target = “stringConstant”, constant = “Constant Value”)

@Mapping(target = “integerConstant”, constant = “14”)

@Mapping(target = “longWrapperConstant”, constant = “3001”)

@Mapping(target = “dateConstant”, dateFormat = “dd-MM-yyyy”, constant = “09-01-2014”)

@Mapping(target = “stringListConstants”, constant = “jack-jill-tom”)

Target sourceToTarget(Source s);

}

自定义映射方法或映射器

在某些情况下，可能需要手动实现 MapStruct 无法生成的从一种类型到另一种类型的特定映射。

可以在Mapper中定义默认实现方法，生成转换代码将调用相关方法：

@Mapper

public interface CarMapper {

CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

@Mapping(source = “numberOfSeats”, target = “seatCount”)

@Mapping(source = “length”, target = “lengthType”)

CarDTO CarToCarDTO(Car car);

default String getLengthType(int length) {

if (length > 5) {

return “large”;

} else {

return “small”;

}

也可以定义其他映射器，如下案例Car中Date需要转换成DTO中的String：

public class DateMapper {

public String asString(Date date) {

return date != null ? new SimpleDateFormat( “yyyy-MM-dd” ).format( date ) : null;

}

public Date asDate(String date) {

try {

return date != null ? new SimpleDateFormat( “yyyy-MM-dd” ).parse( date ) : null;

} catch ( ParseException e ) {

throw new RuntimeException( e );

}

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

面试题总结

其它面试题（springboot、mybatis、并发、java中高级面试总结等）

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！**

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

面试题总结

其它面试题（springboot、mybatis、并发、java中高级面试总结等）

[外链图片转存中…(img-t2LzjgfO-1713441653846)]

[外链图片转存中…(img-SjQKLcFR-1713441653848)]

[外链图片转存中…(img-fbkMyqOE-1713441653849)]

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！