REST如何实现多态POST端点：抽象类型需要映射到具体的JSON类型

我从事 SpringBoot 应用程序的工作。

我有以下类层次结构：

public abstract class DlqMessage {
    Long id;
    UUID employeeId;
    EventReason reason;
}

public class ContractUpdateMessage extends DlqMessage {}

public class SingleContractUpdateMessage extends DlqMessage {
    UUID benefitId;
    UUID employerId;
}

所以，班级ContractUpdateMessage and SingleContractUpdateMessage仅在几个字段上有所不同。

我有一个 REST 控制器，它使用 POST 在数据库中创建和保存新实体：

@PostMapping("/messages")
public ResponseEntity<DlqMessage> create(@RequestBody DlqMessage contractUpdateMessage) {
    DlqMesssage dlqEntry = dlqEntityService.save(contractUpdateMessage);
    return ResponseEntity.ok(dlqEntry);
}

现在，我有一个随机生成一个或另一个类的实例的测试：

 DlqMessage message = randomOneOf(contractUpdateMessageBuilder().build(), singleContractUpdateMessageBuilder().build());

然后我有一个测试帮助程序类，它使用 RestTemplate 向控制器发送 POST 请求：

ResponseEntity<DlqMesssage> response =
                crudRestClient.post("/messages/contract", message, DlqMesssage.class, null);
        return response.getBody();

并调用整个事情我最终得到以下例外：

Failed to read HTTP message: org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Can not construct instance of com.orbitbenefits.benefitsselection.server.errorrecovery.entity.DlqMessage: abstract types either need to be mapped to concrete types, have custom deserializer, or contain additional type information; nested exception is com.fasterxml.jackson.databind.JsonMappingException: Can not construct instance of com.orbitbenefits.benefitsselection.server.errorrecovery.entity.DlqMessage: abstract types either need to be mapped to concrete types, have custom deserializer, or contain additional type information

看起来 RestTemplate 甚至没有发送我的请求。

顺便说一句，当我为每个单独的子类型分割端点时，这一切都有效：

@PostMapping("/messages/contract")
public ResponseEntity<DlqMessage> create(@RequestBody ContractUpdateMessage contractUpdateMessage) {
    ContractUpdateMessage dlqEntry = (ContractUpdateMessage) dlqEntityService.save(contractUpdateMessage);
    return ResponseEntity.ok(dlqEntry);
}

@PostMapping("/messages/single")
public ResponseEntity<DlqMessage> create(@RequestBody SingleContractUpdateMessage contractUpdateMessage) {
    SingleContractUpdateMessage dlqEntry = (SingleContractUpdateMessage) dlqEntityService.save(contractUpdateMessage);
    return ResponseEntity.ok(dlqEntry);
}

然而，这看起来很难看，而且不是一个“正确”的解决方案。

基本上，我想知道是否可能以及如何实现以多态实例作为参数的 REST 端点以及如何调用这样的端点？

不能使用抽象类型 DlqMessage 的原因是因为您可能会收到如下消息：

{
  "id":300, 
  "employeeId":"d6a00fb2-058c-4bf7-9a0a-7cc538cd85f5"
}

Jackson 无法确定此消息打算映射的具体对象的类型。处理这个问题最简单的方法是定义一个类型提示，例如：

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.PROPERTY, property = "messageType")
@JsonSubTypes({
    @JsonSubTypes.Type(value=ContractUpdateMessage.class, name = "ContractUpdateMessage"),
    @JsonSubTypes.Type(value=SingleContractUpdateMessage.class, name = "SingleContractUpdateMessage")
})
public abstract class DlqMessage { ... }

这样，下次进行 API 调用时，您还必须在 JSON 对象中包含此类型提示：

{
  "id":300, 
  "employeeId":"d6a00fb2-058c-4bf7-9a0a-7cc538cd85f5",
  "messageType":"ContractUpdateMessage"
}

这样，Jackson 的默认对象映射器将使用“messageType”字段来猜测您的 API 正在接收哪种类型的 DlqMessage。

编辑：您可以在此处找到更多信息：

https://www.baeldung.com/jackson-annotations https://www.baeldung.com/jackson-annotations