json - 是否允许将 $ref 与 JSON Schema 中的其他关键字结合使用？

Question

我正在为其中一个开源项目学习 JSON Schema。有一个关于将已经定义的模式与一些附加关键字相结合的问题。
假设我已经定义了一些可以通过引用获得的模式，例如 #/definitions/positiveInteger .
现在我想引用该类型并使用其他几个关键字对其进行扩展。例如，我想添加 enum或 description .
是否允许这样做:

{
    "$ref" : "#/definitions/positiveInteger",
    "description" : "This is positive integer with enums",
    "enum" : [ 2, 4, 6, 8 ]
}

或者我必须这样做:

{
    "allOf" : [ { "$ref" : "#/definitions/positiveInteger" } ],
    "description" : "This is positive integer with enums",
    "enum" : [ 2, 4, 6, 8 ]
}

我找不到这方面的正式引用，也不确定验证工具会如何 react 。
基本上我在这里有两个问题:

验证关键字是否应该像 enum在第一种情况下工作？

如果我包含像 description 这样的元数据关键字，会不会有任何冲突旁边 $ref像第一种情况？

我实际上更喜欢内联 $ref s 并且不要将它们包含在 allOf 中和种类，但不确定这是否合法。我什至找不到 $ref 的描述在规范中(仅举几个例子)。

Answer 1

您必须使用 allOf扩展定义。这是相关文档。

Any members other than "$ref" in a JSON Reference object SHALL be ignored.

• https://datatracker.ietf.org/doc/html/draft-pbryan-zyp-json-ref-03#section-3