使用框架來創建RESTful的web服務

想要使用Express、restify或者其他框架來創建RESTful的web服務。使用正確的http方法、URLs和頭部信息來創建語義化的RESTful API。REST即為表徵性狀態傳輸，記住這個並不是特別有用，除非你想在面試中打動別人。web開發人員討論它時通常會和SOAP（簡單對象訪問協議）做對比，通常被視為是更有協作性和更嚴謹的一種創建web APIs的方式。事實上，REST API是相對嚴格的，但是關鍵的區別在於REST在基礎的層面上擁抱http——HTTP方法本身就具備了語義。如果你曾經做過基礎表單，應該對GET和POST請求很熟悉。在REST中，這些http動詞有著特定的含義。例如，POST用於創建資源，GET表示獲取資源。Node開發者通常使用JSON來創建API。在Node中，JSON是最便於生成和讀取的結構化數據格式，它同時在客戶端的JavaScript也能很好地工作。但是REST不意味著JSON——你可以自由地使用任意數據格式。一些客戶端和服務使用XML，我們甚至看到過使用CSV和電子表格格式，如Excel。

所期待的數據格式可以在請求的Accept頭部中指定。對於JSON，它應該是application/json，而XML，則是application/xml。還有其他有用的請求頭部——Accept-Version可以用於請求不同版本的API。這允許客戶端來使用自己支持的版本，同時你可以隨意地升級伺服器而不破壞向後兼容性——你總是可以在人們更新客戶端之前更快地更新伺服器程序。

Express基於http核心模塊提供了一個輕量的封裝層，但它不包括任何數據持久化，除了在內存中的sessions和cookies。你必須決定使用哪個資料庫和資料庫模塊。restify也是如此：它不會自動從http中映射數據來做離線存儲，你需要自己找個方式來處理。

Restify和Express十分相似。其中不同的是Express有構建web應用的特性，包括了渲染模塊。相反地，restify致力於構建REST APIs，這帶來了不同的需求。Restify可以讓使用語義化的http版本頭部信息來處理多個版本的APIs變得容易，並且擁有基於事件的API來觸發和監聽和http相關的事件和錯誤。它也支持節流，你可以控制多快來處理一次響應。

下圖展示了一個典型的RESTful API，允許*page*對象創建、讀取、更新和刪除。

要開始構建REST APIs，應該考慮你的對象是怎麼樣的。想像一下你在構建一個內容管理系統：可能有頁面、用戶和圖片。如果要添加一個按鈕來允許頁面在「發布」和「草稿」之間切換，可能需要一個REST API，它支持這樣的請求：PATCH/pages/:id，你可以把按鈕和一些客戶端的JavaScript綁定，或者是一個表單攜帶或數據post提交到/pages/:id。如果你面臨的是一個Express應用程序，只有PUT/pages/:id，那麼可能需要把現有的實現改為使用PATCH的代碼。

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！