如何将 JSON 模式中的属性标记为已弃用？

Question

我有一个定义 JSON 文档的 JSON 模式。有一个用例，我们希望弃用特定属性以支持引入新属性，并希望将旧属性标记为弃用。JSON 模式是否支持？

Answer 1

于 2019 年 9 月 16 日发布的 JSON 模式验证规范草案 2019-09现在定义了deprecated元数据注释：

这个关键字的值必须是一个布尔值。当此关键字的多次出现适用于单个子实例时，如果任何出现指定了真值，应用程序应该考虑弃用实例位置。

如果“deprecated”的值为 boolean true，则表示应用程序应避免使用声明的属性。这可能意味着该财产将在未来被移除。

包含 "deprecated" 且值为 true 的根模式表示正在描述的整个资源将来可能会被删除。

当通过“items”将“deprecated”关键字应用于数组中的某一项时，如果“items”是单个模式，则弃用涉及整个数组，而如果“items”是模式数组，则弃用弃用与根据子模式位置对应的 [sic] 项目相关。

省略此关键字与值为 false 具有相同的行为。

Answer 2

目前还没有，但计划在规范的未来版本中使用。关于效果的讨论发生在https://github.com/json-schema-org/json-schema-spec/issues/74

亨利于2017年9 月将其添加到草案未来里程碑中，但在我们实现它之前仍有一些问题需要解决。

更新，请参阅有关 2019-09 出版物草案的其他答案！