【问题标题】:Which HTTP method is the most appropriate to resume an asynchronous task?哪种 HTTP 方法最适合恢复异步任务?
【发布时间】:2017-08-07 15:35:48
【问题描述】:

我正在编写一个以异步方式执行某些软件安装的 Web 服务。在一种情况下,在安装过程中需要手动操作。因此我暂停了安装并等待用户请求应用程序恢复安装。

目前,我们可以通过在 /running-install 上执行 GET 请求来检索正在运行的安装,并在 /running-install/<id> 上使用 DELETE 取消安装,但我找不到用于恢复暂停安装的适当方法。
我正在考虑类似在 /running-install/<id> 上执行 PUT 的操作,其中包含 {"status":"running"} 的正文,但对我来说感觉不太合适。
谢谢你

【问题讨论】:

  • 为什么听起来不好?
  • 好吧,我觉得它有点冗长,我在徘徊我没有另一个动词可以实现相同的目标而无需提供身体。我认为的主要原因是我们不能暂停安装,所以我们不能用{"status":"paused"} 执行 PUT。如果它是“最好的”,我最终会实施它,但我想确定。

标签: rest web-services http


【解决方案1】:

哪种 HTTP 方法最适合恢复异步任务?

从语义上讲,您希望将给定任务的状态替换为新状态。对于这种情况,PUT 似乎是一个合理的选择。

引用RFC 7231:

4.3.4. PUT

PUT 方法请求目标资源的状态为 由表示定义的状态创建或替换 包含在请求消息有效负载中。 [...]

然后在请求负载中发送新状态的表示:

PUT /api/installation/1/status HTTP/1.1
Host: example.org
Content-Type: application/json

{ "value" : "running" }

例如,成功的操作可能会返回204,而尝试使用无效状态修改状态可能会返回409。


注意:这个answer 也可能有帮助。

【讨论】:

    【解决方案2】:

    如果您将该协议实现为使用 html 表示的网页序列,那么您可能会在此处使用 POST,因为您可能不希望客户端将其视为 safe interaction。

    POST方法请求目标资源根据资源自身的特定语义处理请求中包含的表示。

    这很难出错。

    要记住的是资源是集成资源。

    您应该期望集成域中的资源比您的业务域中的业务对象多得多。

    因此,如果您无法将所需的消息硬塞到可用的有限资源中,那么添加更多资源。

    根据您选择的集成协议建模方式,您可以证明 POST、PUT、DELETE 中的任何一个都是正确的。

    事实是,如果您真的在做 REST,那么提供多个 集成协议来达到相同的效果是完全合理的。超媒体客户端可以根据与书签页面上的链接相关联的语义来选择要遵循的协议。

    【讨论】:

    • 我不是这里的 POST 的忠实拥护者,正如你所说,这完全取决于我选择的模型,除非我做出一些重大改变,否则我认为它不适合我。不过还是谢谢你的详细回答。
    猜你喜欢
    • 1970-01-01
    • 2017-07-23
    • 1970-01-01
    • 1970-01-01
    • 2018-05-19
    • 1970-01-01
    • 1970-01-01
    • 2013-11-05
    • 1970-01-01
    相关资源
    最近更新 更多