Question

如果我将现有的Restful Web服务转换为尽可能的HATEOS，我一直在阅读很多关于潜在好处的内容。我理解在有效负载中提供链接的重要性，以减少消费者在记住下一个有效可用操作时的负担。但是，我似乎无法理解它将如何帮助我的Restful Web服务的消费者实现。

为了说明这一点，我从Rest In Practice关于制作咖啡订单的书中采用了这个例子： -

<order xmlns="http://schemas.restbucks.com">
  <location>takeAway</location>
  <item>
    <name>latte</name>
    <quantity>1</quantity>
    <milk>whole</milk>
    <size>small</size>
  </item>
  <cost>2.0</cost>
  <status>payment-expected</status>
  <link rel="payment" href="https://restbucks.com/payment/1234" />
</order>

基本上，这允许消费者进行<link>标签定义的付款。然而，实际上，消费者仍然需要知道该Web服务调用的所有语义，例如，使用什么方法（POST或PUT），在有效载荷中使用哪些请求参数以进行支付等。换句话说，消费者仍然需要依赖WADL文档来了解如何成功调用此Web服务。如果他们都在一个特定项目上使用GET，这些标签可能更有意义。否则，我真的没有看到在这里定义链接有多大好处...除了消费者知道他们接下来可以调用什么动作，然后参考WADL以确定如何正确调用它。

我的下一个问题是有可能以所有<link>标签结束非常重的有效载荷。例如，如果/ projects / 1 / users上的GET返回属于项目1的所有用户信息，我假设我最终会得到以下标记： -

<project>
    <users>
        <user id="12" name="mike" ... />
        <user id="23" name="kurt" ... />
        <user id="65" name="corey" ... />
    </user>
    <links>
        <link rel="self" href="http://server/projects/1/users"/>
        <link rel="create_user" href="http://server/projects/1/users"/>

        <link rel="get_user_mike" href="http://server/projects/1/users/12"/>
        <link rel="get_user_kurt" href="http://server/projects/1/users/23"/>
        <link rel="get_user_corey" href="http://server/projects/1/users/65"/>
        ...
    </links>
</project>

如果项目包含说，500个用户...我不会在有效负载中有500个用户链接吗？否则，重新设计我的Web服务以处理这种情况的最佳方法是什么？或者这在现实世界中是否可以接受？

这里非常感谢任何想法或建议。谢谢。

Answer 1

想想为什么这是正确的做法，想象你的API没有HATEOAS方法：你必须在你的文档中（或在你的WADL中，如果这是你的东西）发布每个可能的URI方案，并从这一点无法改变它们而不会破坏您的客户。

从本质上讲，您的客户将与您选择的URI布局密不可分。只需记录媒体类型中链接的位置，而不是记录链接的外观，您就可以轻松避免这种耦合程度。

也就是说，您的应用程序需要采用这种方法，这很好。请记住，您将长时间陷入URI布局。你会在good company。

Answer 2

对于您的特定示例，我认为回归HTML是有意义的。如果您在HTML中显示500个资源的列表，是否会包含指向每个资源的链接，以便用户可以获得更多信息？你可能会。 REST API没有太大区别 - 如果您返回500个资源的列表，则需要包含500个链接，以便用户可以获得有关每个资源的更多信息。

期望客户根据某些ID或名称构建URL，就像要求用户在浏览器的地址栏中手动键入URL一样。

以下是very good article，特别是：

就像HTML文件通过标签相互链接一样，或者就像XML文件通过XLink链接到彼此一样，所有状态转移都必须完全作为对表示内部链接的反应

Answer 3

只是关于500用户事物的一个侧面点：我不是专家，但我的理解是你可以安心地提供分页：

/项目/ 1 /用户/页/ 1

<links>
    ...
    <link rel="get_user_mike" href="http://server/projects/1/users/12"/>
    <link rel="get_user_kurt" href="http://server/projects/1/users/23"/>
    <link rel="get_user_corey" href="http://server/projects/1/users/65"/>
    <link rel="get_page_2" href="http://server/projects/1/users/pages/2"/>
</links>

Answer 4

这不是一个真正的答案，只是一些采用HATEOAS的技巧。您不需要包含数百个链接，您可以包含指向500的完整列表的1个链接，指向链接的分页子集的1个链接，或者在响应中包含分页子集并添加下一页链接。

响应WADL的事情，你应该使用你的内容格式的内置设施，例如：在HTML中，LINK和A元素表示客户端应该发出GET请求，FORM元素表示POST请求。显然，其他格式和API XLink和XMLHTTPRequest比HTML支持HTTP更好。您可能希望查看http://tools.ietf.org/html/draft-nottingham-link-hint

在现实世界中使用Restful Web服务是否值得实现HATEOAS？

4 个答案: