簡介
近幾年微服務是如火如荼的在發展，而微服務之間的調用和漸漸的從RPC調用轉移到了HTTP調用。於是經常聽到有些同事說我們提供微服務並且暴露RESTful接口給別的系統，但是什麼是RESTful接口呢？它和REST有什麼關係呢？
別急，本文將會帶你一探究竟。
REST
REST是一種架構。
首先我們要記住的是REST是一種架構方式，並不是一種協議。它只是告訴我們應該如何去搭建一個可靠的系統。
REST的全稱是REpresentational State Transfer。中文可能不好翻譯，我們暫將其定義爲有代表性的狀態轉義。它是分佈式系統的一種架構方式。最先是由Roy Fielding在2000年他的博士畢業論文中首先提到的。
REST架構在現在的web應用中非常常見，它並不涉及到具體的編碼，它只是一種高級比的指導方案，具體的實現還是由你自己決定。
REST和RESTful API
我們剛剛講解了REST，那麼REST和RESTful API有什麼關係呢？
我們知道，API是服務和服務之間，客戶端和服務端之間溝通的橋樑，通過API之間的調用，我們可以從服務器中獲取到需要的資源信息。而RESTful API就是符合REST架構的API。
所以不是所有的HTTP協議的API都是RESTful API，它的前提是你的系統是REST架構的。
REST架構的基本原則
那麼什麼樣的系統才能被稱爲是REST架構的系統呢？根據Roy Fielding的論文描述，REST架構的系統有6個基本特徵。我們一一來說明。
Uniform interface統一的接口
在REST架構中，最爲核心的元素就是資源。我們將資源定義爲一個個的獨立的URI。一個資源用一個獨立並且唯一的URI來表示。
單個的資源不能太大也不能太小，它表示的是一個獨立的可以操作的單位。這些資源通過通用的獲取方式來進行獲取和操作。比如對資源的CURD可以分別用不同的HTTP method來表示（PUT，POST，GET，DELETE）。
同時需要對資源進行統一的命名，定義統一的link格式和數據格式。
還有一點，根據HATEOAS協議，一個資源還應該包含指向該資源或者相關資源的URI。可以能有些同學現在對這一點還有些疑惑，不過沒關係，後面我們會詳細對HATEOAS進行講解。
Spring也提供了對HATEOAS的支持，我們看一個基本的HATEOAS的請求：
GET http://localhost:8080/greeting
該請求的返回可以是這樣的：
{
"content":"Hello, World!",
"_links":{
"self":{
"href":"http://localhost:8080/greeting?name=World"
}
}
}
大家可以看到上面返回了一個代表自己URI的資源鏈接。
Client–server 客戶端和服務器端獨立
另外的一條規則就是客戶端和服務器端獨立，客戶端和服務器端互不影響，他們之間的唯一交互就是API的調用。
對於客戶端來說只要能夠通過API獲取到對應的資源即可，並不關心服務器是怎麼實現的。
而對於服務器端來說，只需要提供保持不變的API即可，自己內部的實現可以自由決定，也不需要考慮客戶端是如何使用這些API的。
這條規則對於現在的很多前後端分離的架構來說已經使用了。
Stateless無狀態
和HTTP協議一樣，REST架構中各個服務之間的API調用也是無狀態的。無狀態的意思是服務器並不保存API調用的歷史記錄，也不存儲任何關於客戶端的信息。對於服務器來說，每個請求都是最新的。
所以用戶的狀態信息是在客戶端進行保存和維護的，客戶端需要在每個接口帶上可以識別用戶的唯一標記，從而在服務器端進行認證和識別，從而獲取到對應的資源。
Cacheable可緩存
緩存是提升系統速度的利器，對於REST的資源也是一樣的，在REST中對於可緩存的資源需要標明它是可以被緩存的。
從而對應的調用方可以將這些資源進行緩存，從而提升系統的效率。
Layered system分層系統
現代的系統基本上都是分層的，在REST架構中也是一樣，只要保證對外提供的資源URI是一致的，架構並不關心你到底使用的是幾層架構。
Code on demand按需編碼
一般來說，REST架構中各個服務通常是通過JSON或者XML來進行交互的。但是這並不是硬性規定。可以返回可執行的代碼直接運行。
RESTful API的例子
我們來舉幾個常見的RESTful API的例子，來見識一下這種架構的神奇之處：
請求一個entity：
GET https://services.odata.org/TripPinRESTierService/People
根據ID請求一個entity:
GET https://services.odata.org/TripPinRESTierService/People('russellwhyte')
請求一個entity的某個屬性：
GET https://services.odata.org/TripPinRESTierService/Airports('KSFO')/Name
使用filter進行查詢：
GET https://services.odata.org/TripPinRESTierService/People?$filter=FirstName eq 'Scott'
修改數據：
POST https://services.odata.org/TripPinRESTierService/People
header:
{
Content-Type: application/json
}
body:
{
"UserName":"lewisblack",
"FirstName":"Lewis",
"LastName":"Black",
"Emails":[
"[email protected]"
],
"AddressInfo": [
{
"Address": "187 Suffolk Ln.",
"City": {
"Name": "Boise",
"CountryRegion": "United States",
"Region": "ID"
}
}
]
}
刪除數據：
DELETE https://services.odata.org/TripPinRESTierService/People('russellwhyte')
更新數據：
PATCH https://services.odata.org/TripPinRESTierService/People('russellwhyte')
header:
{
Content-Type: application/json
}
body:
{
"FirstName": "Mirs",
"LastName": "King"
}
總結
本文講解了REST和RESTful相關的概念，那麼對於其中最重要的資源如何定義呢？敬請期待後續文章。
本文已收錄於 http://www.flydean.com/01-rest-restful/
最通俗的解讀，最深刻的乾貨，最簡潔的教程，衆多你不知道的小技巧等你來發現！