Spring-data-rest自我描述实体

时间:2014-08-28 21:07:49

标签: spring-data-rest

我一直在使用spring-data-rest和存储库。由于RESTful apis应该是自我描述的,你如何找到资源的属性?这是否可能没有API文件或一些特殊编码?

人/人的例子......如果存储库中没有人,我怎么能找到一个人的样子?也许有一个url要求服务描述Person的属性,但我找不到它。

1 个答案:

答案 0 :(得分:0)

服务可以在一种或多种媒体类型中提供资源。客户必须事先了解媒体类型。如果媒体类型是jpeg,你不会期望服务提供jpeg文件格式和压缩算法的描述,不是吗?它与人物媒体类型完全相同。一个人甚至可以用多种媒体类型来表示。如何描述二进制格式?

API应该是可发现的,是的,但资源看起来像是媒体类型所暗示的,并且必须为客户所知。

当然,你总是可以创建一个返回某种描述的服务,但这不是REST的一部分。

话虽如此,根据媒体类型,有一些描述标准。 XML甚至是基于这样的标准。它提供XSD或DTD。对于JSON,至少有一个官方标准草案:JSON Schema。有关详细信息,请参阅http://json-schema.org