RESTful API講解

RESTful風格

REST是REpresentational State Transfer的縮寫(一般中文翻譯爲表述性狀態轉移),REST 是一種體系結構,而 HTTP 是一種包含了 REST 架構屬性的協議,爲了便於理解,我們把它的首字母拆分成不同的幾個部分:

  • 表述性(REpresentational): REST 資源實際上可以用各種形式來進行表述,包括 XML、JSON 甚至 HTML——最適合資源使用者的任意形式;
  • 狀態(State): 當使用 REST 的時候,我們更關注資源的狀態而不是對資源採取的行爲;
  • 轉義(Transfer): REST 涉及到轉移資源數據,它以某種表述性形式從一個應用轉移到另一個應用。

簡單地說,REST 就是將資源的狀態以適合客戶端或服務端的形式從服務端轉移到客戶端(或者反過來)。在 REST 中,資源通過 URL 進行識別和定位,然後通過行爲(即 HTTP 方法)來定義 REST 來完成怎樣的功能。

實例說明:

在平時的 Web 開發中,method 常用的值是 GET 和 POST,但是實際上,HTTP 方法還有 PATCH、DELETE、PUT 等其他值,這些方法又通常會匹配爲如下的 CRUD 動作:

CRUD 動作 HTTP 方法
Create POST
Read GET
Update PUT 或 PATCH
Delete DELETE

儘管通常來講,HTTP 方法會映射爲 CRUD 動作,但這並不是嚴格的限制,有時候 PUT 也可以用來創建新的資源,POST 也可以用來更新資源。實際上,POST 請求非冪等的特性(即同一個 URL 可以得到不同的結果)使其成一個非常靈活地方法,對於無法適應其他 HTTP 方法語義的操作,它都能夠勝任。

在使用 RESTful 風格之前,我們如果想要增加一條商品數據通常是這樣的:

/addCategory?name=xxx

但是使用了 RESTful 風格之後就會變成:

/category

這就變成了使用同一個 URL ,通過約定不同的 HTTP 方法來實施不同的業務,這就是 RESTful 風格所做的事情了,爲了有一個更加直觀的理解,引用一下來自how2j.cn的圖:
在這裏插入圖片描述
RESTful API有很多工具去調試使用,這裏我們講解一種工具的使用方法:chrome瀏覽器插件 Advanced-REST-client
下載地址:https://download.csdn.net/download/qq_41837900/12007195
建議通過我的地址下載,因爲現在(2019-11-27)無法在谷歌瀏覽器插件商城找到這個插件,通過其他方法下載的插件也無法使用(缺少definitions.json文件)

Advanced-REST-client 使用

下載解壓壓縮包
在這裏插入圖片描述
打開chrome瀏覽器–》進入設置–》擴展程序
在這裏插入圖片描述
打開開發者模式–》加載已解壓的擴展程序
在這裏插入圖片描述
選擇剛剛解壓的路徑

會出現這個
在這裏插入圖片描述
瀏覽器輸入chrome://apps
點擊 Advanced-REST-client
在這裏插入圖片描述
在這裏插入圖片描述
然後會出現一個選擇選擇文件的頁面
我們選擇解壓後目錄下的definitions.json(這個文件提示要F anQi An纔可以下載 但,FaN後也不能下載,可能是我的問題)即可
在這裏插入圖片描述
使用:
GET與PUT:輸入路徑,點擊Send即可
在這裏插入圖片描述
POST與DELETE:
輸入路徑
在Payload中填寫要帶的參數
選擇Payload的內容格式
點擊Send即可
在這裏插入圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章