Spring Boot 2.5中DTO与SOAP Stub映射及自动生成DTO方案问询

一、能否从SOAP Stub自动生成DTO？ #

可以，但不建议直接将生成的DTO对外暴露。SOAP Stub的结构完全绑定WSDL定义，通常包含冗余字段、SOAP专属注解或类型，直接对外会把遗留系统的耦合带到REST API层，不利于API的维护和版本迭代。

如果想快速生成基础DTO做参考，可尝试：

• 基于Stub类，用IDE自带的代码生成工具（比如IntelliJ的「Generate POJO from Java Class」）导出简化版结构，之后手动移除SOAP相关依赖、调整字段，保证REST API的简洁性。
• 用jaxb2-maven-plugin结合自定义绑定文件，生成Stub时同步生成精简DTO，但这种方式配置复杂，灵活性有限。

二、手动实现映射的推荐方案 #

1. 使用MapStruct（最推荐） #

MapStruct是编译期生成映射代码的工具，性能比反射类工具（如ModelMapper）更高，且支持灵活定制映射规则。

步骤：

• 引入适配Spring Boot 2.5的依赖：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.4.2.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.4.2.Final</version>
    <scope>provided</scope>
</dependency>

• 定义映射接口：

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

    // 字段名一致时自动映射
    SoapRequestStub toSoapStub(RestRequestDto restDto);

    // 字段名不一致时，用@Mapping指定映射关系
    @Mapping(source = "restUserName", target = "soapUserFullName")
    SoapRequestStub toSoapStubWithCustomMapping(RestRequestDto restDto);
}

• 业务层直接调用：

SoapRequestStub soapStub = SoapStubMapper.INSTANCE.toSoapStub(restRequestDto);

2. 手动编写映射工具类 #

如果映射逻辑简单，或不想引入第三方依赖，可自行编写工具类：

public class DtoStubMapper {
    public static SoapRequestStub convertToSoapStub(RestRequestDto restDto) {
        SoapRequestStub stub = new SoapRequestStub();
        stub.setUserId(restDto.getId());
        stub.setUserName(restDto.getUsername());
        // 嵌套对象的映射
        stub.setAddress(convertToSoapAddress(restDto.getAddress()));
        return stub;
    }

    private static SoapAddress convertToSoapAddress(RestAddress restAddr) {
        SoapAddress soapAddr = new SoapAddress();
        soapAddr.setStreet(restAddr.getStreetName());
        soapAddr.setZipCode(restAddr.getPostalCode());
        return soapAddr;
    }
}

3. 使用ModelMapper（反射类工具） #

适合快速开发，无需编写大量映射代码，但性能略逊于MapStruct：

• 引入依赖：

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

• 配置并使用：

@Configuration
public class ModelMapperConfig {
    @Bean
    public ModelMapper modelMapper() {
        ModelMapper mapper = new ModelMapper();
        // 配置字段映射规则（字段名不一致时）
        mapper.typeMap(RestRequestDto.class, SoapRequestStub.class)
              .addMapping(RestRequestDto::getRestUserName, SoapRequestStub::setSoapUserFullName);
        return mapper;
    }
}

// 业务层注入使用
@Autowired
private ModelMapper modelMapper;

public void handleRequest(RestRequestDto restDto) {
    SoapRequestStub soapStub = modelMapper.map(restDto, SoapRequestStub.class);
}

三、注意事项 #

• 保持REST DTO独立性：REST API的DTO要根据调用方需求设计，不要绑定SOAP Stub结构，避免遗留系统变更影响REST API稳定性。
• 处理类型差异：比如SOAP Stub常用javax.xml.datatype.XMLGregorianCalendar，而REST DTO多用java.time.LocalDateTime，需在映射时做类型转换（MapStruct可通过自定义转换器实现）。
• 空值处理：根据业务需求配置映射时的空值策略，比如是否忽略空字段或设置默认值。

内容的提问来源于stack exchange，提问作者Gerardo Donnarumma