Spring数据rest自描述实体



我一直在使用spring数据rest和存储库。既然RESTful api应该是自我描述的,那么你将如何找到资源的属性呢?在没有API文件或某些特殊编码的情况下,这可能吗?

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

服务可以提供一种或多种媒体类型的资源。客户必须事先了解媒体类型。如果媒体类型是jpeg,你不会期望服务提供jpeg文件格式和压缩算法的描述,是吗?个人媒体类型也是如此。一个人甚至可以用一种以上的媒体类型来表示。二进制格式的描述会是什么样子?

API应该是可发现的,是的,但资源的外观是由媒体类型暗示的,并且必须为客户端所知。

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

话虽如此,根据媒体类型的不同,有一些描述标准。XML甚至有点基于这样的标准。它提供XSD或DTD。对于JSON,官方标准至少有一个草案:JSON模式。有关更多信息,请访问http://json-schema.org

最新更新