Java REST API如何优化复用对象层级结构并扩展Room字段？

这个问题我之前也碰到过，那种每个层级都要继承并重写getter/setter来转换类型的方案，不仅代码冗余，后续维护起来也挺头疼的。这里有几个更优雅的思路可以解决你的问题：

1. 泛型重构原有层级（最推荐的长期方案） #

核心思路是把上层的Street和House改成泛型类，让它们可以适配不同类型的Room，这样既不用修改原有类，也不用复制整个层级结构。示例代码如下：

// 通用Street类，支持任意House类型
public class Street<H extends House<?>> {
    private String streetName;
    private List<H> houses;

    // 标准getter和setter
    public String getStreetName() { return streetName; }
    public void setStreetName(String streetName) { this.streetName = streetName; }
    public List<H> getHouses() { return houses; }
    public void setHouses(List<H> houses) { this.houses = houses; }
}

// 通用House类，支持任意Room类型
public class House<R extends Room> {
    private int number;
    private List<R> rooms;

    // 标准getter和setter
    public int getNumber() { return number; }
    public void setNumber(int number) { this.number = number; }
    public List<R> getRooms() { return rooms; }
    public void setRooms(List<R> rooms) { this.rooms = rooms; }
}

// 原有基础Room类
public class Room {
    private int roomId;
    private int roomWidth;

    // 标准getter和setter
    public int getRoomId() { return roomId; }
    public void setRoomId(int roomId) { this.roomId = roomId; }
    public int getRoomWidth() { return roomWidth; }
    public void setRoomWidth(int roomWidth) { this.roomWidth = roomWidth; }
}

// 扩展的Room类，仅添加额外字段
public class ExtendedRoom extends Room {
    private String extraField;

    // 额外字段的getter和setter
    public String getExtraField() { return extraField; }
    public void setExtraField(String extraField) { this.extraField = extraField; }
}

这样一来：

• 第一个API直接使用Street<House<Room>>作为请求/响应类型
• 第二个API则使用Street<House<ExtendedRoom>>
  完全复用了上层的Street和House结构，不需要任何冗余的继承代码，扩展性也非常好——以后如果要再扩展其他字段，只需要新建Room的子类即可。

2. 组合+对象映射工具（适合已有老代码的兼容方案） #

如果不想重构原有类，可以用组合方式定义新的DTO，再配合MapStruct这类对象映射工具自动完成转换，避免手动写类型转换逻辑。

首先定义新的DTO类（仅扩展Room部分）：

// 新的HouseDTO，包含扩展后的Room
public class HouseDTO {
    private int number;
    private List<ExtendedRoom> rooms;

    // getter和setter
}

// 新的StreetDTO
public class StreetDTO {
    private String streetName;
    private List<HouseDTO> houses;

    // getter和setter
}

// 扩展的Room类
public class ExtendedRoom extends RoomForRest1 {
    private String extraField;
    // getter和setter
}

然后用MapStruct编写映射器：

@Mapper
public interface StreetMapper {
    StreetMapper INSTANCE = Mappers.getMapper(StreetMapper.class);

    StreetDTO toStreetDTO(StreetForRest1 street);
    HouseDTO toHouseDTO(HouseForRest1 house);
    ExtendedRoom toExtendedRoom(RoomForRest1 room);
}

在新API的业务逻辑中，只需要一行代码就能完成转换：

StreetDTO streetDTO = StreetMapper.INSTANCE.toStreetDTO(originalStreet);

MapStruct会自动生成类型转换的实现代码，比手动写继承转换要简洁得多，也不容易出错。

3. Jackson混合注解（轻量级字段扩展方案） #

如果你的项目是基于Spring Boot这类使用Jackson做JSON序列化的框架，还可以用Jackson的混合注解来实现“虚拟扩展”，不需要修改原有实体类，也不需要新建上层DTO。

首先定义一个混合类，声明需要添加的字段：

public interface ExtendedRoomMixIn {
    @JsonProperty("extraField")
    String getExtraField();

    @JsonProperty("extraField")
    void setExtraField(String extraField);
}

然后在新API的配置中，给原有RoomForRest1类绑定这个混合类：

@Configuration
public class NewApiJacksonConfig {
    @Bean
    public ObjectMapper newApiObjectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.addMixIn(RoomForRest1.class, ExtendedRoomMixIn.class);
        return objectMapper;
    }
}

最后给新API指定使用这个自定义的ObjectMapper：

@RestController
@RequestMapping("/new-api")
public class NewApiController {
    @Autowired
    @Qualifier("newApiObjectMapper")
    private ObjectMapper objectMapper;

    // API接口方法，使用objectMapper处理请求/响应
}

这个方案的好处是完全不需要修改原有实体结构，适合只在API序列化层面扩展字段的场景；缺点是业务逻辑中无法直接操作新增的字段，只能在JSON处理时生效。

内容的提问来源于stack exchange，提问作者f.ald