RAML resourceTypes和traits VS Swagger $ ref

时间:2015-01-24 02:26:22

标签: swagger raml

我非常喜欢RAML如何通过使用ResourceTypes和Traits来减少重复数量并提高API之间的一致性。

但仔细观察Swagger规范后,看来你可以通过使用$ ref来完成同样的事情。

在这种情况下RAML超过$ ref是否有优势?我错过了什么吗?

1 个答案:

答案 0 :(得分:3)

在我研究了更多内容之后,我对它的工作原理有了更深入的了解。

一个很大的区别是RAML中的ResourceTypes接受参数,这样可以提取更多代码。

此外,它只限于你可以在招摇时使用$ ref。这意味着,您无法在资源级别或http方法上应用$ ref。您可以外化的事例包括参数,响应和模型。

ResourceTypes和Traits在外部化REST中的常见模式以及在不同服务中重用它们方面更加强大