RESTful 想必大家都耳熟能詳。

但是為什么要有 RESTful，RESTful 到底是什么意思。

為什么稱之為 RESTful 架構(gòu)？

我不用 RESTful 不行嗎？

什么樣才叫真正的 RESTful ？

其實(shí)網(wǎng)上 RESTful 的文章有挺多的，不過有些講的糊里糊涂的，而且很大部分都忽略了 HATEOAS。

在之前的面試中面試官就問過我，你怎么理解 RESTful 的，英文全稱是啥？為什么叫這個名字?

當(dāng)時我人都傻了。

面試官不講武德，針對我這個剛出社會的小伙子。

其實(shí)有很多人也稀里糊涂的，也包括我自己。

就面向資源唄，不加動詞咯，還能咋滴，我加動詞不也能用嗎？

而且我之前還特不能理解，為啥這叫架構(gòu)？

我特意搜索了下架構(gòu)的解釋。

軟件架構(gòu)是有關(guān)軟件整體結(jié)構(gòu)與組件的抽象描述，用于指導(dǎo)大型軟件系統(tǒng)各個方面的設(shè)計(jì)。

整體結(jié)構(gòu)與組件的抽象描述。

RESTful 哪有什么組件和結(jié)構(gòu)之間的玩意？

所以就至今我寫下這篇文章的時候我也理解不了為什么叫 RESTful 架構(gòu)。

可能是我對架構(gòu)的理解太狹隘，還不到火候。

我個人只能理解成 RESTful 風(fēng)格的 API 設(shè)計(jì)，也就是說 RESTful 只是一種指導(dǎo)風(fēng)格，就像我們 Java 要用駝峰命名法。

那不用駝峰命名法代碼就不能跑了嗎？

當(dāng)然能跑，這只是一種希望大家都能遵循的規(guī)范。

對 RESTful 而言我覺得算不上規(guī)范，只能說指導(dǎo)風(fēng)格。

來讓我們正式的進(jìn)入對 RESTful 的剖析。

REST

REST 不是一個單詞，是 Representational State Transfer 的縮寫。

直譯過來就是表述性狀態(tài)轉(zhuǎn)移。

我對這個名字蒙了一年多，就不能說點(diǎn)能聽得懂的嘛。

從提出 REST 的論文中我翻了翻，沒有明說但是表達(dá)的意思是其實(shí)它還有個主語 Resource 。

所以是資源的表述性狀態(tài)轉(zhuǎn)移。

稍微可以理解一點(diǎn)了。

我們先不管什么狀態(tài)轉(zhuǎn)移，大致先有點(diǎn)感覺。

知道 REST 之后 RESTful 就不難解釋了，加 ful 就是變形容詞了，比如 wonderful girl。

至此對名字稍微解釋了一下，疑惑還在沒事，咱們慢慢理。

REST 的核心

核心就是資源，用 URL 定位資源，用 HTTP 動詞來描述所要做的操作。

HTTP的提供了很多動詞：GET、PUT、POST、DELETE......

這些動詞都是有含義的。

比如 GET 就是獲取資源，是查詢請求。

PUT 指的是修改資源，是冪等的。

POST 也是修改(新增也是一種修改)，指的是不冪等的操作。

所以根據(jù)這些規(guī)范我們都能得知這次交互的一些動作，所以 RESTful 風(fēng)格正確的使用姿勢如下：

比如獲取一個 user。

錯誤姿勢：GET /getUserById?userId=1。

正確姿勢：GET /users/1。

再比如新增 user。

錯誤姿勢：POST /addUser （省略body）。

正確姿勢：POST /users （省略body）。

可以看到 HTTP 的動詞其實(shí)就能指代你要對資源做的操作，所以不需要在 URL 上做一些東西，就把 URL 表明的東西看作一個資源即可。

這里注意要用對 HTTP 動詞，比如一個獲取資源的請求用 PUT，用了也能獲取資源但是這不合適。

其實(shí)更深一步的理解是 ?HTTP 是一個協(xié)議。

協(xié)議其實(shí)就是約定好的一個東西，協(xié)議就規(guī)定 GET 是獲取資源，那你非得在 URL 上再重復(fù)一遍或者所有請求不論增刪改都用 GET 這個動作，這其實(shí)就是沒有完全遵循這個協(xié)議。

可以說只是把 HTTP 當(dāng)成一個傳輸管道，而不是約定好的協(xié)議。

這其實(shí)是對 HTTP 更深一層的認(rèn)識，我認(rèn)為也是 RESTful 被推出的原因。

當(dāng)然理想很豐滿，現(xiàn)實(shí)很骨感，還是有很多人就 getUserById。

不過我個人覺得問題不大，公司統(tǒng)一就行。

HATEOAS

即 Hypermedia as the Engine of Application State 的縮寫，翻譯過來就是作為應(yīng)用狀態(tài)引擎的超媒體。

這也是 REST 提出的設(shè)計(jì)。

是不是理解不了？其實(shí)很簡單。

例子我就不自己編了，抄一下 stackoverflow 回答上的例子。

比如你請求獲取用戶列表：

GET?/users
Accept:?application/json+userdb

此時的返回應(yīng)該是：

200?OK
Content-Type:?application/json+userdb

{
????"users":?[
????????{
????????????"id":?1,
????????????"name":?"Emil",
????????????"country:?"Sweden",
????????????"links":?[
????????????????{
????????????????????"href":?"/user/1",
????????????????????"rel":?"self",
????????????????????"method":?"GET"
????????????????},
????????????????{
????????????????????"href":?"/user/1",
????????????????????"rel":?"edit",
????????????????????"method":?"PUT"
????????????????},
????????????????{
????????????????????"href":?"/user/1",
????????????????????"rel":?"delete",
????????????????????"method":?"DELETE"
????????????????}
????????????]
????????},
????????{
????????????"id":?2,
???????????....省略.....
????????}
????],
????"links":?[
????????{
????????????"href":?"/user",
????????????"rel":?"create",
????????????"method":?"POST"
????????}
????]
}

重點(diǎn)就是這個 links，結(jié)果會返回你能對這個資源所做的操作。

比如對于 userId 是 1 的，你調(diào)用PUT /user/1就是做修改這個用戶，DELETE /user/1就是刪除這個用戶。

最外層的 links 告訴你用 POST /user 就能再創(chuàng)建一個用戶。

這里還有個隱藏信息，可以看到外層的 links 沒有返回 DELETE 的信息，說明此時客戶端無法刪除用戶！

所以說 RESTful API 還需要再返回此時能對資源做的操作，這樣客戶端就知道它能做什么。

它也不需要管具體怎么做，反正返回里面會告訴它 DELETE 就這樣這樣，POST 就這樣這樣。

沒告訴它的就是不能做的。

然后這個時候再去理解下資源的表述性狀態(tài)轉(zhuǎn)移，是不是感覺來了？

如果說上一 part 提到用 HTTP 的動詞來指代動作， URL 僅表示資源的現(xiàn)實(shí)是骨感的。

那么 HATEOAS 的現(xiàn)實(shí)就是骨灰。

基本上沒幾家公司會這么做。

就我個人而言這玩意沒啥用。

它的出發(fā)點(diǎn)是讓客戶端從響應(yīng)就能得知對資源操作的入口，并且通過響應(yīng)得知哪些動作能執(zhí)行。

聽起來好像有點(diǎn)用，但是就我目前的功力，我只能看到響應(yīng)變得十分冗余。

最后

這篇文章關(guān)于 RESTful API 具體的寫法我就提到一些，還有挺多的就自己查資料吧。

文章的目的是為了讓你理解 RESTful API，我再總結(jié)一下重點(diǎn)。

HTTP 是協(xié)議，不是傳輸通道。（對協(xié)議不理解的看我之前的 HTTP 分析）

所以協(xié)議約定了很多東西，推薦我們按照協(xié)議的用法進(jìn)行客戶端和服務(wù)端的交互。

也就是 RESTful 表明的面向資源，通過 HTTP 動作 + URL 上的資源。

RESTful 還提到了 HATEOAS，雖說基本上沒什么公司會這樣使用，但是它能讓你更好的理解 REST 這個名字的含義。

RESTful 是一種風(fēng)格，你是否采用這種風(fēng)格對你的程序運(yùn)行沒有影響，類比駝峰命名來思考。

簡而言之，RESTful?就是不要在 URL 上表現(xiàn)出動作，用 HTTP 動詞代表動作，URL 上只做資源。

僅此而已。

至于要不要嚴(yán)格遵循 RESTful 風(fēng)格，我個人的看法是公司內(nèi)部保持一致就行。

那種工作遇到很細(xì)節(jié)的場景的還是別了，這種問你上司比較合適。

參考：

https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm#sec_5_2

http://www.ruanyifeng.com/blog/2011/09/restful.html

https://stackoverflow.com/questions/671118/what-exactly-is-restful-programming/3950863#3950863

https://en.wikipedia.org/wiki/HATEOAS