RESTful 有用吗？ HTTP 有 GET POST 就足够了？

不少程序员都是这么认为的，基于 HTTP API 的服务，只要用 GET 请求和 POST 请求就足够了。像 RESTful 这样的大量使用 PUT ， DELETE 请求是不必要的。

真的吗，我来举一个例子。

假设有一类资源 ResourceXYZ ，对其有增删查改的操作。如果只使用 GET POST 之类的设计方式，那么很可能会设计以下的请求接口：

POST .../addResourceXYZ
POST .../delResourceXYZ
GET .../getResourceXYZ?resourceId=resourceId
POST .../updateResourceXYZ

如果按照 RESTful 的设计方式，很可能会设计以下的请求接口

POST .../ResourceXYZs
DELETE .../ResourceXYZ/{resourceId}
GET .../ResourceXYZ/{resourceId}
PUT .../ResourceXYZ/{resourceId}

现在假设，客户端要获取该资源，其 ID 为 resourceId 。如果成功，那么一切都好说。如果失败， Restful 的处理方式是，通过 HTTP status 返回错误码来表示原因，例如 404 表示该资源不存在。

那么只用 GET POST 两种方法的方式呢？响应请求

GET .../getResourceXYZ?resourceId=resourceId

的时候能不能也用 404 呢？

按照 404 的语义，响应 404 是不对的：因为客户端请求的 URL 实际上是正确的，只是对应的参数没有找到对应的结果很多时候，就只能靠响应 200 然后返回空数据或者空对象来处理了。例如 Content-type 为 application/json 时，可以返回 {} 或者

{
    "error": "not found",
    "code": 404
}

这样就会要求客户端，必须处理 HTTP 回复的具体内容，而不能只处理头部。那么客户端要怎么处理这个 json 呢要先解析 json ，然后尝试分别这是一个资源的内容，还是一个错误提示。

对于强类型语言例如 C/C++ OC Swift 写的客户端来说，恐怕就忍不住要问候服务端程序员一家了。

更重要的是……

没有库会支持这种拍脑袋式的设计。

全文完，欢迎拍砖。

hysterin

2017-02-17 16:57:35 +08:00

@noli

不不不，您误会了，先跟你道个歉。这里不是来歪楼的，确实是表达敬意。只是可能态度不太端正。

事实上我是做品牌的，您的回复全程我都有关注。

虽然内容准确与否有待商榷，毕竟是争议性话题，而且大家各有立场，无法说出个绝对正义。但是您的回复，非常精彩，公关级的撕逼。除了有几楼稍微过激之外，真的是很厉害。
----------------------------------------------------------------------------------------
顺便回复 @silva 小伙伴，悄悄跟你说，别说论坛了，我曾经认识过一个妹子还能在淘宝约。。平台不重要，重要的是你想不想约。。想约就总有上钩的人的。。。

baconrad

2017-02-17 17:27:56 +08:00

@noli

那兩句話只是想提醒自己，不要再犯同樣的錯誤。

兩年前看到 Restful 的設計方式後，真的覺得自己撿到了一塊寶，興奮地和當時合作的後端介紹它的規範和理念，然後討論著該如何導入之後的項目裡。

但以結果來說我錯在太堅持，全部依賴 Restful 設計原則，導致任何需求必須把它捏成 Restful 能夠接受的樣子，還得告訴自己 Restful 果然很棒，什麼都做得到。

「當時的我們就像拿著鎚子的小孩，所有的東西都想拿鎚子來敲。」

Restful 可以解決大部分的需求，我同意，
但不是所有需求都得用 Restful 解，即使它做得到。

離題了，
但這是那兩句話的原意。