如何在 Java 中将 DTO 多个字段映射到实体单个字段？

如何将 DTO 中的多个字段映射到实体的单个字段，反之亦然

问题陈述

在对象映射过程中，有时需要将 DTO（数据传输对象）中的多个字段映射到实体中的单个字段，反之亦然。这在诸如将姓名拆分为名和姓等场景中很常见。

MapStruct 解决方案

MapStruct 是一款轻量级且强大的 Java 库，用于生成对象映射实现。它通过使用注解和编译时处理来实现映射，从而简化了过程。

创建映射接口

@Mapper
public interface ContactMapper {
    ContactDto toContactDto(Contact contact);
    Contact toContact(ContactDto contactDto);
}

注解映射方法

@Mapper
public interface ContactMapper {
    @Mapping(target = "name", source = {"fname", "lname"})
    ContactDto toContactDto(Contact contact);
    @Mapping(target = "fname", source = "name", ignore = true)
    @Mapping(target = "lname", source = "name", ignore = true)
    Contact toContact(ContactDto contactDto);
}

使用 @Mapping 注解，指定将 fname 和 lname 映射到 name。

ModelMapper 解决方案

ModelMapper 是另一个流行的 Java 对象映射库，它通过反射和代码生成来实现映射。

创建映射配置

ModelMapper modelMapper = new ModelMapper();
modelMapper.getConfiguration().setFieldMatchingEnabled(true);
modelMapper.addMappings(new PropertyMap<Contact, ContactDto>() {
    @Override
    protected void configure() {
        using(new ConcatenateStringsConverter(",", false)).map(source.getFname(), source.getLname()).set(destination.getName());
    }
});

使用 PropertyMap 类自定义如何将 fname 和 lname 映射到 name。

结论

MapStruct 和 ModelMapper 都是功能强大的对象映射库。对于需要将多个字段映射到单个字段的情况，MapStruct 由于其简洁性（基于注解）和编译时处理而脱颖而出。ModelMapper 提供了更大的灵活性，因为它允许通过代码生成创建自定义转换器。

常见问题解答

1. 如何处理复杂类型之间的映射？

答：MapStruct 和 ModelMapper 都支持复杂类型的映射。可以使用嵌套映射或自定义转换器来实现。

2. 可以在运行时修改映射行为吗？

答：是的，ModelMapper 允许在运行时动态修改映射行为。MapStruct 则仅允许在编译时修改。

3. 如何处理循环引用？

答：MapStruct 和 ModelMapper 都提供机制来处理循环引用。MapStruct 使用 @Context 注解，而 ModelMapper 使用 PropertyMap 的 setSkipNulls 方法。

4. 如何自定义映射过程？

答：MapStruct 和 ModelMapper 都允许通过创建自定义映射器或转换器来自定义映射过程。

5. 哪种库更适合我的用例？

答：如果需要简洁性和编译时处理，则选择 MapStruct。如果需要更大的灵活性（例如自定义转换器），则选择 ModelMapper。