带有任何字段到 POJO 的 Json 模式

Question

我想知道为带有“anyOf”字段的 Json 模式生成 POJO 的推荐方法是什么？

例如，给定以下 json 架构：

爱好.json

{
    "anyOf": [
        { "type": {"$ref": "./exercise.json" } },
        { "type": {"$ref": "./music.json" } }
    ]    
}

练习.json

{
    "type": "object"
    "properties" {
        "hobbyType": {"type": "string"}
        "exerciseName": { "type": "string" },
        "timeSpent": { "type": "number" },
        "place": { "type": "string" }
    }
}

音乐.json

{
    "type": "object"
    "properties" {
        "hobbyType": {"type": "string"}
        "instrument": { "type": "string" },
        "timeSpent": { "type": "number" }
    }
}

如何使用 Jackson 为 Hobby.java 生成 POJO？

Answer 1

我认为有两种方法看起来很自然：

一种方法是生成一个类层次结构 Hobby，其公共字段 timeSpent 和 Music/Exercise 是具有其特定字段的子类。

另一种方法是将字段“联合”成一个 Hobby 类。

两者在语义上都是不正确的，这意味着您可以提出 JSON 架构正确验证但 Jackson 抛出错误或 POJO 中由于省略字段而缺少信息的情况。

所以我认为这里最好的方法是使用 Map 而不是 pojos。

例如，如果一个人有一个爱好，那么这个人 POJO 可能是：

class Person {
  String name;
  ...
  Map<String, Object> hobby;

或 List

Answer 2

我最终采用的方法是使用 Jackson 提供的多态编组/解组功能。

具体来说-

1. 使hobby成为一个接口并用@JsonTypeInfo和@JsonSubTypes注释它

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    property = "hobbyType",
    include = JsonTypeInfo.As.EXISTING_PROPERTY,
    visible = true
)
@JsonSubTypes({
        @Type(value = Exercise.class, name = "exercise"),
        @Type(value = Music.class, name = "music")
})
public interface Hobby {
}

1. 创建实现此接口的Exercise.java 和Music.java

@Builder
@Data
@AllArgsConstructor
public class Exercise implements Hobby {
    @JsonProperty("hobbyType")
    @Builder.Default
    @NonNull
    private final String hobbyType = "exercise";    

    @JsonProperty("exerciseName")
    private String exerciseName;

    @JsonProperty("place")
    private String place;
    //... (other fields)
}

1. 使用Hobby 进行序列化和反序列化。

// create a Hobby object
Hobby exercise = Exercise.builder().exerciseName("swimming").place("swimmingPool").build();

// serialization
String serializedHobby = new ObjectMapper.writeValueAsString(exercise)
/**
serializedHobby looks like this ->
{
    "hobbyType": "exercise",
    "exerciseName": "swimming",
    "place": "swimmingPool"
}
*/

// deserialization
Hobby deserializedObject = new ObjectMapper.readValue(jsonString, Hobby.class)
// deserializedObject.getClass() would return Exercise.java or Music.java based on the hobbyType

参考：https://www.baeldung.com/jackson-inheritance