Spring Boot中使用独立请求响应DTO时如何避免代码重复

针对你遇到的请求/响应DTO字段重复、Java单继承限制以及组合模式导致请求体需包裹payload的问题，推荐以下几种实用方案：

方案一：使用Lombok @Delegate实现无层级组合 #

通过Lombok的@Delegate注解，将共用字段抽离到核心类，同时让请求/响应DTO直接暴露核心类的字段，避免客户端需要嵌套payload：

代码结构 #

// 基础响应公共字段
public abstract class BaseResponseDTO {
    protected UUID id;
    protected Integer version;
    protected Date created;
    protected Date modified;
    // getter、setter 省略
}

// 抽离共用的业务字段
public class UserCoreDTO {
    private String firstName;
    private String lastName;
    // getter、setter 省略
}

// 请求DTO：通过@Delegate暴露核心类字段，客户端无需嵌套payload
public class RequestUserDTO {
    @Delegate
    private UserCoreDTO core = new UserCoreDTO();
}

// 响应DTO：继承基础响应类+@Delegate暴露核心字段，响应为扁平结构
public class ResponseUserDTO extends BaseResponseDTO {
    @Delegate
    private UserCoreDTO core = new UserCoreDTO();
}

优势 #

• 完全消除字段重复，共用字段仅在UserCoreDTO中定义一次
• 客户端请求/响应均为扁平JSON结构，无需嵌套payload
• 代码简洁，无需手动编写字段复制逻辑

注意事项 #

• 项目需引入Lombok依赖，并确保开发工具支持Lombok注解
• @Delegate会将核心类的所有getter/setter委托给当前类，Jackson可正常序列化/反序列化

方案二：使用MapStruct自动映射字段 #

如果不想引入Lombok，可通过MapStruct工具自动处理请求DTO到响应DTO的字段复制，避免手动编写重复的赋值代码：

代码结构 #

// 基础响应公共字段
public abstract class BaseResponseDTO {
    protected UUID id;
    protected Integer version;
    protected Date created;
    protected Date modified;
    // getter、setter 省略
}

// 请求DTO
public class RequestUserDTO {
    private String firstName;
    private String lastName;
    // getter、setter 省略
}

// 响应DTO：继承基础响应类+业务字段
public class ResponseUserDTO extends BaseResponseDTO {
    private String firstName;
    private String lastName;
    // getter、setter 省略
}

// MapStruct映射接口
@Mapper(componentModel = "spring")
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    // 自动映射同名字段
    ResponseUserDTO requestToResponse(RequestUserDTO request);
}

使用方式 #

在服务层处理请求时，直接调用映射器完成字段复制，再填充基础响应字段：

@Service
public class UserService {
    private final UserMapper userMapper;

    public UserService(UserMapper userMapper) {
        this.userMapper = userMapper;
    }

    public ResponseUserDTO createUser(RequestUserDTO request) {
        ResponseUserDTO response = userMapper.requestToResponse(request);
        // 填充基础响应字段
        response.setId(UUID.randomUUID());
        response.setVersion(1);
        response.setCreated(new Date());
        response.setModified(new Date());
        return response;
    }
}

优势 #

• 无需改变原有DTO结构，兼容现有代码
• MapStruct在编译期生成映射代码，性能优于反射式工具（如BeanUtils）
• 支持自定义映射规则，适配复杂字段转换场景

方案三：抽离共用字段为接口（搭配默认方法） #

虽然Java接口不能定义实例字段，但可以通过默认方法提供字段的getter/setter，结合Lombok的@Getter/@Setter简化代码：

代码结构 #

// 共用业务字段接口
public interface UserFields {
    String getFirstName();
    void setFirstName(String firstName);
    String getLastName();
    void setLastName(String lastName);
}

// 基础响应公共字段
public abstract class BaseResponseDTO {
    protected UUID id;
    protected Integer version;
    protected Date created;
    protected Date modified;
    // getter、setter 省略
}

// 请求DTO：实现共用字段接口
@Getter
@Setter
public class RequestUserDTO implements UserFields {
    private String firstName;
    private String lastName;
}

// 响应DTO：继承基础响应类+实现共用字段接口
@Getter
@Setter
public class ResponseUserDTO extends BaseResponseDTO implements UserFields {
    private String firstName;
    private String lastName;
}

优势 #

• 明确约定共用字段，提升代码可读性
• 配合MapStruct使用时，可基于接口统一映射规则

注意事项 #

• 仍需在请求/响应DTO中声明字段，只是通过接口统一方法签名，相比前两种方案仍有少量重复，但可通过MapStruct消除维护成本

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