Victools JSON模式生成器为同一类创建两个定义

Question

使用Victools的JSON模式生成器（这是基于Java类生成JSON模式），如果我将两个类与常见的Supertype相关联，并且使用 @jsontypename 。

请考虑以下代码：

@JsonTypeName("Root")
public class Root {
    private String rootName;
    ... 
    private List<SuperClass1> superclass1 = new ArrayList<SuperClass1>();
    ...
}

@JsonTypeName("SuperClass1")
@JsonTypeInfo(  use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "type")
@JsonSubTypes({ @JsonSubTypes.Type(value = Sub1.class, name = "Sub1"),
@JsonSubTypes.Type(value = Sub2.class, name = "Sub2")})
public abstract class SuperClass1 {
    String name;
    int someThingElse;
    
    Root root;

    ...
}

@JsonTypeName("Sub1")
public class Sub1 extends SuperClass1 {
    String sub1;
    ...
    Sub2 sub2;
    ...
}

@JsonTypeName("Sub2")
public class Sub2 extends SuperClass1{
    String sub2;
    ...
}

生成以下JSON架构：

{
  "$schema" : "http://json-schema.org/draft-07/schema#",
  "definitions" : {
    "Sub1" : {
      "type" : "object",
      "properties" : {
        "root" : {
          "$ref" : "#"
        },
        "sub1" : {
          "type" : "string"
        },
        "sub2" : {
          "$ref" : "#/definitions/Sub2-2"
        }
      }
    },
    "Sub2-1" : {
      "type" : "object",
      "properties" : {
        "root" : {
          "$ref" : "#"
        },
        "sub2" : {
          "type" : "string"
        }
      }
    },
    "Sub2-2" : {
      "allOf" : [ {
        "$ref" : "#/definitions/Sub2-1"
      }, {
        "type" : "object",
        "properties" : {
          "type" : {
            "const" : "json_test.Sub2"
          }
        },
        "required" : [ "type" ]
      } ]
    }
  },
  "type" : "object",
  "properties" : {
    "rootName" : {
      "type" : "string"
    },
    "superclass1" : {
      "type" : "array",
      "items" : {
        "anyOf" : [ {
          "allOf" : [ {
            "$ref" : "#/definitions/Sub1"
          }, {
            "type" : "object",
            "properties" : {
              "type" : {
                "const" : "json_test.Sub1"
              }
            },
            "required" : [ "type" ]
          } ]
        }, {
          "$ref" : "#/definitions/Sub2-2"
        } ]
      }
    }
  }
}

如果 sub1 类的属性引用 sub2 类，以及 @jsontypeinpeinfo（use = jsontypeinfo.id.class，include = jsontypeinfo.as.property，属性=“ type”））。

有人可以向我解释为什么它会生成 sub2-1 和 sub2-2 ，而不仅仅是 sub2 在“定义”部分中？

谢谢

- Jaap

Answer 1

区别在于架构生成器的内部工作：

• sub2-1 表示“原始”类型，如果您将
• sub2-2 代表 sub2-1 在杰克逊通常添加的附加“类型”属性中

，如果 sub2-1 仅引用一次，则应将其列入第二个架构，因此允许将第二个架构标记为 sub2 。至少对于 sub1 ，似乎按预期工作。

我建议您在 victools github存储库上提供一个完整的可重复示例，作为“问题”，我可以看看这是一个很容易解决的错误还是至少由您的特定设置解释。

注意：我是该库的维护者。