在长期关注SOAP之后,我最近又重新回到了REST中,我很高兴看到所有可用的工具.我已经对JSON-Schema有点熟悉了(是的,我们都知道:JSON!= REST)所以想要一个支持它的工具.
在研究REST社区中也支持JSON-Schema的关键参与者时,我将列表缩小到RAML(raml.org)和Swagger(swagger.io).顺便说一句:两者都很优秀,我强烈推荐每一个.
在对这两种工具进行了一定程度的实验之后,最终的决定(至少对于当前的项目)是Swagger,如果你还没有使用它,请帮自己一个忙,试试你的下一个基于REST的项目.
我开始这个项目完全意识到JSON-Schema的Swagger实现是不完整的,并且觉得总会有办法解决任何缺失的功能,虽然不完美,但一切都有效.
为了获得最高质量的产品,我现在发现自己正在寻找Swagger缺乏对"oneOf"约束的支持的"最干净"的解决方案.请理解这篇文章不是一个抱怨(虽然他们自己的编辑[editor.swagger.io]利用'oneOf'约束进行语法验证,因此给出了:))但更多的是"社区如何"解决这个问题.
简而言之:如果没有'oneOf'JSON-Schema功能,Swagger社区如何应对？
请注意,我当前的项目是基于与现有项目的交互,因此请假设'oneOf'要求不是可以简单删除的要求.
提前谢谢了.
编辑:昨晚再次运行JSON-Schema规范我想到了为此目的强制'枚举'.对于那篇文章后面的人来说,枚举元素中的对象是文字的(理所当然的),必须提前知道并逐字使用.换句话说,枚举中定义的对象不能用作模式定义或替换'oneOf'.