java - 使@JsonTypeInfo 属性可选

Question

我正在使用 @JsonTypeInfo 指示 Jackson 在 @class 属性中查找具体类型信息。但是，有时我不想指定 @class，特别是当可以根据上下文推断出子类型时。 最好的方法是什么？

这是一个 JSON 示例:

{ 
    "owner": {"name":"Dave"},
    "residents":[
        {"@class":"jacksonquestion.Dog","breed":"Greyhound"},
        {"@class":"jacksonquestion.Human","name":"Cheryl"},
        {"@class":"jacksonquestion.Human","name":"Timothy"}
    ]
}

我正在尝试将它们反序列化为这些类(全部在 jacksonquestion.* 中):

public class Household {
    private Human owner;
    private List<Animal> residents;

    public Human getOwner() { return owner; }
    public void setOwner(Human owner) { this.owner = owner; }
    public List<Animal> getResidents() { return residents; }
    public void setResidents(List<Animal> residents) { this.residents = residents; }
}

public class Animal {}

public class Dog extends Animal {
    private String breed;
    public String getBreed() { return breed; }
    public void setBreed(String breed) { this.breed = breed; }
}

public class Human extends Animal {
    private String name;
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
}

使用这个配置:

@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "@class")
private static class AnimalMixin {
}

//...

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.getDeserializationConfig().addMixInAnnotations(Animal.class, AnimalMixin.class);
Household household = objectMapper.readValue(json, Household.class);
System.out.println(household);

如您所见，所有者被声明为人类，而不是动物，因此我希望能够省略 @class 并让 Jackson 像往常一样推断类型。

当我运行它时，我得到了

org.codehaus.jackson.map.JsonMappingException: Unexpected token (END_OBJECT), 
   expected FIELD_NAME: missing property '@class' that is to contain type id  (for class jacksonquestion.Human)

因为“所有者”没有指定@class。

有什么想法吗？我最初的一个想法是在属性而不是类型上使用 @JsonTypeInfo。 但是，这不能用于注释列表的元素类型。 (不正确，请参阅答案)

Answer 1

原来我误解了Javadoc for @JsonTypeInfo .当我在我的问题中说

One initial thought I had was to use @JsonTypeInfo on the property rather than the type. However, this cannot be leveraged to annotate the element type of a list.

我是基于 Javadoc 中的这段引述:

When used for properties (fields, methods), this annotation applies to values: so when applied to structure types (like Collection, Map, arrays), will apply to contained values, not the container; for non-structured types there is no difference. (...) There is no per-property way to force type information to be included for type of container (structured type); for container types one has to use annotation for type declaration.

不知何故，我误读了相反的意思；类型信息将应用于容器而不是元素。显然那是错误的。所以我能够使用以下方法解决此问题:

public class Household {
   //...

   @JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "@class")
   public void setResidents(List<Animal> residents) { 
      this.residents = residents; 
   }
}

现在只有在 residents 属性中指定的 Animals 才需要 @class。