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

实体与DTO如何转换

news 2025/7/14 11:46:56

下面是一些常用的转换库：

  1. Dozer

    该项目目前不活跃，并且很可能在未来被弃用。

  2. ModelMapper

    一个智能对象映射库，可自动将对象相互映射。它采用基于约定的方法，同时提供简单、重构安全的应用程序接口（API）来处理特定用例。

  3. MapStruct

    它是一个代码生成器，它基于约定优于配置的方法，极大地简化了 Java Bean 类型之间的映射实现。生成的映射代码使用简单的方法调用，因此执行速度快、类型安全且易于理解。

  4. Orika

    是一个 Java Bean 映射框架，它（除其他功能外）可以递归地将数据从一个对象复制到另一个对象。它在开发多层应用程序时非常有用。

  5. Selma

    它一方面是一个注解处理器，能够在编译时生成处理字段到字段映射的 Java 代码；另一方面，它是一个运行时库，用于实例化和调用生成的映射器。

ModelMapper的使用。

<dependency><groupId>org.modelmapper</groupId><artifactId>modelmapper</artifactId><version>3.2.1</version>
</dependency>

在Spring环境下，建议配置如下的Bean以方便我们进行转换。

@Configuration
public class ModelMapperConfig {@Beanpublic ModelMapper modelMapper() {return new ModelMapper() ;}
}

如果你不是在Spring环境，那么你可以在使用的时候直接new创建即可。

2.2 准备实体类&DTO

订单实体类

public class Order {private String orderNumber ;private double orderAmount ;private double tax ;private Customer customer ;private Address shippingAddress ;// getter and setter
}
public class Customer {private String userId ;private String firstName ;private String lastName ;private String email ;// getter and setter
}
public class Address {private String addressLine1 ;private String street ;private String city ;private String postalCode ;// getter and setter
}

下面是我们希望进行转换的DTO对象。

public class OrderDto { public  String orderNumber ;private double orderAmount ;private double tax ; private Customer customer ;private Address shippingAddress ;// getters and setters
}

接下来，我们将围绕上面定义的类进行讲解。

再写个静态的Service


@Service
public class OrderService {public Order queryOrder() {Order order = new Order() ;order.setOrderAmount(266.6D) ;order.setTax(1.5D) ;order.setOrderNumber("PACK-00001") ;Customer customer = new Customer("U00001", "Pack", "AKF", "66666@qq.com") ; order.setCustomer(customer) ;Address address = new Address("XJ0001", "HTYJ", "WLMQ", "830000") ;order.setShippingAddress(address) ;return order ;}
}

该Service用来模拟查询Order对象。

2.3 定义门面Facade

在本示例中，我将使用 Facade 层来简化服务层，如下定义：


@Component
public class OrderFacade {private final ModelMapper modelMapper;public OrderFacade(ModelMapper modelMapper) {this.modelMapper = modelMapper ;}public OrderDto convert(Order order) {return convertToOrderDto(order) ;}private OrderDto convertToOrderDto(Order order) {OrderDto orderDto = this.modelMapper.map(order, OrderDto.class);return orderDto;}
}

该Facade非常简单就是调用ModelMapper方法进行数据类型的转换。

2.4 定义Controller

@RestController
@RequestMapping("/orders")
public class OrderController {private final OrderFacade orderFacade;private final OrderService orderService ;public OrderController(OrderFacade orderFacade, OrderService orderService) {this.orderFacade = orderFacade;this.orderService = orderService ;}@GetMapping(value = "/{id}")public ResponseEntity<OrderDto> getOrder(@PathVariable("id") String id) {Order order = this.orderService.queryOrder() ;OrderDto orderDto = this.orderFacade.convert(order) ;return ResponseEntity.status(HttpStatus.OK.value()).body(orderDto) ;}
}

3. ModelMapper更多用法

3.1 自定义映射

首先，修改DTO属性如下：


public class OrderDto {public String number;// ...
}

这里我们希望的是number字段能对应到Order中的orderNumber属性，是否能自动匹配呢？执行如下代码


OrderDto dto = mapper.map(order, OrderDto.class) ;
System.out.println(dto) ;

输出结果

OrderDto2 [number=PACK-00001, orderAmount=266.6, tax=1.5, ...]

能够正确的映射。但是如果两个字段完全没有相似会如何呢？修改DTO如下：


public class OrderDto2 {private double money ;// ...
}

 我们期望的是该money对应到Order中的orderAmount上，运行上面代码：

OrderDto2 [number=PACK-00001, money=0.0,...]

在这种完全没有相似的情况下，就需要我们自定义映射

ModelMapper mapper = new ModelMapper() ;
mapper.typeMap(Order.class, OrderDto.class).addMappings(mapping -> {mapping.map(src -> src.getOrderAmount(), OrderDto::setMoney) ;
}) ;

这里添加了Order到OrderDto转换的映射，将Order中的orderAmount映射到OrderDto中的money。

我们继续修改OrderDto添加如下属性: 我们希望将Customer中的firstName映射到这里的name，可以如下添加映射： 

public class OrderDto {private String name ;// ...
}

我们希望将Customer中的firstName映射到这里的name，可以如下添加映射：


typeMap.addMapping(order -> order.getCustomer().getFirstName(), OrderDto::setName
) ;

 

这就告知在映射时将Customer中的firstName映射到DTO的name属性上。

3.2 跳过属性

如果你希望某些属性不进行映射，你可以如下操作

typeMap.addMappings(mapping -> mapping.skip(OrderDto::setTax));

映射时将忽略DTO中的tax属性。

3.3 属性值转换

转换器允许在映射源属性到目标属性时进行自定义转换，如下示例：


Converter<String, String> toUpperCase = ctx -> ctx.getSource() == null ? null : ctx.getSource().toUpperCase() ;
typeMap.addMappings(mapping -> mapping.using(toUpperCase).map(Order::getOrderNumber, OrderDto::setNumber)
) ;

如上我们将Order中的orderNumber值转换为大写后映射到DTO的number属性。

3.4 条件映射

目标属性的映射可以有条件地进行，方法是在映射的同时提供一个条件，如下示例：


Condition<String, String> condition = ctx -> !"Pack-00001".equals(ctx.getSource());
typeMap.addMappings(mapping -> mapping.when(condition).map(Order::getOrderNumber, OrderDto2::setNumber)) ;

这里添加条件，只有Order中的orderNumber属性值不为 "Pack-00001"时才进行映射。

http://www.lryc.cn/news/466912.html

相关文章：

  • Docker 安装Postgres和PostGIS，并制作镜像
  • ES6：let和const命令解读以及变量的解构赋值
  • java-collection集合整理0.9.4
  • ParallelsDesktop20最新版本虚拟机 一键切换系统 游戏娱乐两不误
  • 现代C语言：C23标准重大更新
  • Maven进阶——坐标、依赖、仓库
  • Android中的内存泄漏及其检测方式
  • 【雷电模拟器命令合集操作大全】官方文档整理贴
  • redis的配置文件解析
  • Python中的元组和列表
  • 【AI战略思考7】粮草筹集完毕和我的朋友分类
  • 科大讯飞AI开发者大赛颁奖典礼，万码优才荣获前三甲！
  • Redis 哨兵机制
  • linux-磁盘io情况、性能排查
  • NC 单据模板自定义项 设置参照，比如部门参照、自定义参照等
  • table-cascade 使用
  • Android SELinux——策略文件配置结构（八）
  • 【数据结构与算法】队列——数据世界中的“有序使者”
  • yolov11 部署 TensorRT，预处理和后处理用 C++ cuda 加速，速度快到飞起
  • 国际期货收费行情源CTP推送式/期货配资软件开发对接行情源的技术性说明
  • 上拉电阻和下拉电阻在电路中的作用（一）
  • 怎么轻松把图片存入二维码？图片生成二维码的简单3步技巧
  • perl双引号内字符串的反斜线转义
  • 【编程语言】Kotlin快速入门 - 伴生对象与懒加载
  • 三、数据聚合和函数
  • Golang | Leetcode Golang题解之第500题键盘行
  • 如何实现金蝶商品数据集成到电商系统的SKU
  • 100种算法【Python版】第4篇——回溯法
  • R语言机器学习算法实战系列（九）决策树分类算法 (Decision Trees Classifier)
  • 听泉鉴宝在三个月前已布局商标注册！