如何使用Java Mapstruct实现User实体到UserDto的映射？

你遇到的这个问题确实是实体转DTO过程中非常常见的场景——默认的简单映射（不管是手写空方法还是一些工具的默认规则）没办法自动识别嵌套对象里的字段到DTO的扁平属性上。下面给你几种实用的解决方案：

1. 手动映射（最直观、可控性强） #

这是最直接的方式，自己实现映射逻辑，完全掌控每一步，还能避免空指针异常：

public UserDto userToUserDto(User user) {
    if (user == null) {
        return null;
    }
    
    UserDto userDto = new UserDto();
    userDto.setIdUser(user.getIdUser());
    
    // 处理嵌套的Job字段，先判空再取值
    if (user.getJob() != null) {
        userDto.setJobId(user.getJob().getIdJob());
    }
    
    return userDto;
}

这种方式适合映射逻辑简单的场景，没有依赖第三方库，也不会有黑盒问题。

2. 使用MapStruct（编译期生成代码，性能优异） #

MapStruct是专门用于对象映射的库，它会在编译阶段生成对应的映射实现类，不会用到反射，性能很好，还能处理复杂的映射规则。

首先定义一个映射接口，通过@Mapping注解指定嵌套字段的映射关系：

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;

// 如果是Spring项目，可以指定componentModel为"spring"，方便注入
@Mapper(componentModel = "spring")
public interface UserMapper {
    // 明确指定source是user.job.idJob，target是userDto.jobId
    @Mapping(source = "job.idJob", target = "jobId")
    UserDto userToUserDto(User user);
}

之后你直接注入这个接口使用即可，MapStruct会帮你生成完整的映射实现，包括空值处理等细节。

3. 使用ModelMapper（反射型工具，配置简单） #

ModelMapper是基于反射的映射工具，配置起来很灵活，适合快速开发场景。你只需要显式配置一次嵌套字段的映射规则：

import org.modelmapper.ModelMapper;

public class UserConverter {
    private final ModelMapper modelMapper = new ModelMapper();

    public UserDto userToUserDto(User user) {
        // 配置User到UserDto的映射规则：把User的job属性转成UserDto的jobId
        modelMapper.typeMap(User.class, UserDto.class)
            .addMapping(
                User::getJob, 
                (dest, value) -> dest.setJobId(((Job) value).getIdJob())
            );
        
        return modelMapper.map(user, UserDto.class);
    }
}

不过要注意，因为是基于反射，它的性能比手动映射和MapStruct要差一些，适合映射场景不多的项目。

内容的提问来源于stack exchange，提问作者Rodrigo R