MapStruct简单上手

最新推荐文章于 2024-12-19 22:31:53 发布

weixin_45760485

最新推荐文章于 2024-12-19 22:31:53 发布

阅读量547

点赞数

CC 4.0 BY-SA版权

文章标签： java spring 开发语言

本文链接：https://blog.csdn.net/weixin_45760485/article/details/126712712

MapStruct是一个强大的Java库，用于生成类型安全的转换器，简化了对象到对象映射的过程。它支持VO（展示层对象）、PO（请求参数对象）和DTO（数据传输对象）之间的映射。通过注解配置，MapStruct能自动映射相同名称和类型的属性，并允许自定义转换规则。使用@Mapper和@Mapping注解，可以定制转换逻辑，包括批量转换、更新对象以及处理日期和数字格式。此外，@AfterMapping和@MappingTarget可用于转换后的自定义操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

是一种实体类的映射框架，能够通过Java注解将一个实体类的属性安全的赋值给另一个实体类。

VO

展示层对象，后端返回给前端的数据封装对象。数据库存储所有的字段，而前端展示时不需要所有的字段，将需要使用的封装为一个对象VO返回给前端。

PO

请求参数对象，controller在处理请求是传递给controller的请求数据封装对象。

DTO

数据传输对象，将来自不同数据源的数据进行封装，比如来自mysql的多张表、es、neo4j等。

依赖引入

<dependency>
  <groupId>org.mapstruct</groupId>
  <artifactId>mapstruct-jdk8</artifactId>
  <version>${org.mapstruct.version}</version>
  <groupId>org.mapstruct</groupId>
  <artifactId>mapstruct</artifactId>
  <version>${org.mapstruct.version}</version>
  <groupId>org.mapstruct</groupId>
  <artifactId>mapstruct-processor</artifactId>
  <version>${org.mapstruct.version}</version>
</dependency>

转换类示例

@Mapper(componentModel = "spring")
public interface ObjectConverter {
    ObjectConverter INSTANCE = Mappers.getMapper(ObjectConverter.class);

	@Mappings({
        @Mapping(target = "", ignore = true)
    })
    ObjectDto po2DTO(ObjectPO objectPO);
}

MapStruct默认的一些映射规则

八种基本类型 <-> 八种基本类型的包装类 <-> String类型
日期类 <-> String类型
同名同类型的属性会自动映射赋值

@Mappings和@Mapping注解

source 源目标属性的名称（转化前）
target 目标对象的属性名称（转化后）
numberFormat 格式化数字类型（如：numberFormat = “#.00” 保留两位小数）
dateFormat 格式化日期类型（如：dateFormat = “yyyy-MM-dd HH:mm:ss”)
ignore 转换为的target对象忽略某个属性@Mapping(target = "color" ignore = true)CarVO对象则不转换来自source的color属性

属性是引用类型的转换

转换类中定义抽象方法或默认方法声明引用类型属性的转换规则

// public default CarVO carDTO2CarVO(CarDTO carDTO) {}

@Mapping(source = "cid" target = "id")
@Mapping(source = "fullName" target = "name")
DriverVO DriverDTO2DriverVO(DriverDTO driverDTO);