实体与DTO如何转换

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

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", "[e-mail]") ; 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"时才进行映射。