restful-api開發(fā)與測(cè)試

1、RESTful API開發(fā)與測(cè)試,平臺(tái)功能模塊簡(jiǎn)介,一、RESTful 簡(jiǎn)述二、RESTful API編寫規(guī)范三、RESTful API在SSM中的實(shí)現(xiàn)四、RESTful API測(cè)試,一、RESTful簡(jiǎn)述,REST（英文：Representational State Transfer，簡(jiǎn)稱REST）描述了一個(gè)架構(gòu)樣式的網(wǎng)絡(luò)系統(tǒng)，比如 web 應(yīng)用程序。REST 指的是一組架構(gòu)約束條件和原則。滿足這些約束條件和原則的應(yīng)用程序或

2、設(shè)計(jì)就是 RESTful；Web 應(yīng)用程序最重要的 REST 原則是，客戶端和服務(wù)器之間的交互在請(qǐng)求之間是無(wú)狀態(tài)的；在服務(wù)器端，應(yīng)用程序狀態(tài)和功能可以分為各種資源。,二、 RESTful API編寫規(guī)范,1、協(xié)議API與用戶的通信協(xié)議，總是使用HTTPs協(xié)議。2、域名應(yīng)該盡量將API部署在專用域名之下：https://api.example.com如果確定API很簡(jiǎn)單，不會(huì)有進(jìn)一步擴(kuò)展，可以考慮放在主域名下：htt

3、ps://example.com/api/,二、 RESTful API編寫規(guī)范,3、版本（Versioning）應(yīng)該將API的版本號(hào)放入U(xiǎn)RL：https://api.example.com/v1/ 另一種做法是，將版本號(hào)放在HTTP頭信息中，但不如放入U(xiǎn)RL方便和直觀。4、路徑（Endpoint）路徑又稱"終點(diǎn)"（endpoint），表示API的具體網(wǎng)址。在RESTful架構(gòu)中，每個(gè)網(wǎng)址代表一種

4、資源（resource），所以網(wǎng)址中不能有動(dòng)詞，只能有名詞，而且所用的名詞往往與數(shù)據(jù)庫(kù)的表格名對(duì)應(yīng)。一般來(lái)說(shuō)，數(shù)據(jù)庫(kù)中的表都是同種記錄的"集合"（collection），所以API中的名詞也應(yīng)該使用復(fù)數(shù)。,二、 RESTful API編寫規(guī)范,4、路徑（Endpoint）舉例來(lái)說(shuō)，有一個(gè)API提供動(dòng)物園（zoo）的信息，還包括各種動(dòng)物和雇員的信息，則它的路徑應(yīng)該設(shè)計(jì)成下面這樣：https://api.ex

5、ample.com/v1/zoos https://api.example.com/v1/animals https://api.example.com/v1/employees,二、 RESTful API編寫規(guī)范,5、HTTP動(dòng)詞對(duì)于資源的具體操作類型，由HTTP動(dòng)詞表示。常用的HTTP動(dòng)詞有下面五個(gè)（括號(hào)里是對(duì)應(yīng)的SQL命令）：GET（SELECT）：從服務(wù)器取出資源（一項(xiàng)或多項(xiàng)）。 POST（CREAT

6、E）：在服務(wù)器新建一個(gè)資源。 PUT（UPDATE）：在服務(wù)器更新資源（客戶端提供改變后的完整資源）。 PATCH（UPDATE）：在服務(wù)器更新資源（客戶端提供改變的屬性）。 DELETE（DELETE）：從服務(wù)器刪除資源。,,二、 RESTful API編寫規(guī)范,5、HTTP動(dòng)詞還有兩個(gè)不常用的HTTP動(dòng)詞：HEAD：獲取資源的元數(shù)據(jù)。 OPTIONS：獲取信息，關(guān)于資源的哪些屬性是客戶端可以改變的。,,二、

7、 RESTful API編寫規(guī)范,5、HTTP動(dòng)詞下面是一些例子：GET /zoos：列出所有動(dòng)物園 POST /zoos：新建一個(gè)動(dòng)物園 GET /zoos/ID：獲取某個(gè)指定動(dòng)物園的信息 PUT /zoos/ID：更新某個(gè)指定動(dòng)物園的信息（提供動(dòng)物園的全部信息） PATCH /zoos/ID：更新某指定動(dòng)物園的信息（提供動(dòng)物園的部分信息） DELETE /zoos/ID：刪除某個(gè)動(dòng)物園 GET /z

8、oos/ID/animals：列出某個(gè)指定動(dòng)物園的所有動(dòng)物 DELETE /zoos/ID/animals/ID：刪除某個(gè)指定動(dòng)物園的指定動(dòng)物,,二、 RESTful API編寫規(guī)范,6、過(guò)濾信息（Filtering）如果記錄數(shù)量很多，服務(wù)器不可能都將它們返回給用戶。API應(yīng)該提供參數(shù)，過(guò)濾返回結(jié)果。下面是一些常見(jiàn)的參數(shù)：?limit=10：指定返回記錄的數(shù)量 ?offset=10：指定返回記錄的開始位置。 ?

9、page=2&per_page=100：指定第幾頁(yè)，以及每頁(yè)的記錄數(shù)。 ?sortby=name&order=asc：指定返回結(jié)果按照哪個(gè)屬性排序，以及排序順序。 ?animal_type_id=1：指定篩選條件 參數(shù)的設(shè)計(jì)允許存在冗余，即允許API路徑和URL參數(shù)偶爾有重復(fù)。比如，GET /zoo/ID/animals 與 GET /animals?zoo_id=ID 的含義是相同的,,,二、 RESTf

10、ul API編寫規(guī)范,7、狀態(tài)碼（Status Codes）200 OK - [GET]：服務(wù)器成功返回用戶請(qǐng)求的數(shù)據(jù)，該操作是冪等的（Idempotent）。 201 CREATED - [POST/PUT/PATCH]：用戶新建或修改數(shù)據(jù)成功。 202 Accepted - [*]：表示一個(gè)請(qǐng)求已經(jīng)進(jìn)入后臺(tái)排隊(duì)（異步任務(wù)） 204 NO CONTENT - [DELETE]：用戶刪除數(shù)據(jù)成功。 400 INVALID R

11、EQUEST - [POST/PUT/PATCH]：用戶發(fā)出的請(qǐng)求有錯(cuò)誤，服務(wù)器沒(méi)有進(jìn)行新建或修改數(shù)據(jù)的操作，該操作是冪等的。 401 Unauthorized - [*]：表示用戶沒(méi)有權(quán)限（令牌、用戶名、密碼錯(cuò)誤）。 403 Forbidden - [*] 表示用戶得到授權(quán)（與401錯(cuò)誤相對(duì)），但是訪問(wèn)是被禁止的。 404 NOT FOUND - [*]：用戶發(fā)出的請(qǐng)求針對(duì)的是不存在的記錄，服務(wù)器沒(méi)有進(jìn)行操作，該操作是冪等的。

12、406 Not Acceptable - [GET]：用戶請(qǐng)求的格式不可得（比如用戶請(qǐng)求JSON格式，但是只有XML格式）。 410 Gone -[GET]：用戶請(qǐng)求的資源被永久刪除，且不會(huì)再得到的。 422 Unprocesable entity - [POST/PUT/PATCH] 當(dāng)創(chuàng)建一個(gè)對(duì)象時(shí)，發(fā)生一個(gè)驗(yàn)證錯(cuò)誤。 500 INTERNAL SERVER ERROR - [*]：服務(wù)器發(fā)生錯(cuò)誤，用戶將無(wú)法判斷發(fā)出的請(qǐng)求是

13、否成功。,,,,二、 RESTful API編寫規(guī)范,8、錯(cuò)誤處理（Error handling）如果狀態(tài)碼是4xx，就應(yīng)該向用戶返回出錯(cuò)信息。一般來(lái)說(shuō)，返回的信息中將error作為鍵名，出錯(cuò)信息作為鍵值即可：{ error: "Invalid API key" },,,二、 RESTful API編寫規(guī)范,9、返回結(jié)果針對(duì)不同操作，服務(wù)器向用戶返回的結(jié)果應(yīng)該符合以下規(guī)范：GET /collect

14、ion：返回資源對(duì)象的列表（數(shù)組） GET /collection/resource：返回單個(gè)資源對(duì)象 POST /collection：返回新生成的資源對(duì)象 PUT /collection/resource：返回完整的資源對(duì)象 PATCH /collection/resource：返回完整的資源對(duì)象 DELETE /collection/resource：返回一個(gè)空文檔,,,,二、 RESTful API編寫規(guī)范,

15、10、Hypermedia APIRESTful API最好做到Hypermedia，即返回結(jié)果中提供鏈接，連向其他API方法，使得用戶不查文檔，也知道下一步應(yīng)該做什么。比如，當(dāng)用戶向api.example.com的根目錄發(fā)出請(qǐng)求，會(huì)得到這樣一個(gè)文檔：{"link": { "rel": "collection https://www.example.com/zoo

16、s", "href": "https://api.example.com/zoos", "title": "List of zoos", "type": "application/vnd.yourformat+json" }},,,,二、 RESTful API編寫規(guī)范,10、Hype

17、rmedia API上面代碼表示，文檔中有一個(gè)link屬性，用戶讀取這個(gè)屬性就知道下一步該調(diào)用什么API了。rel表示這個(gè)API與當(dāng)前網(wǎng)址的關(guān)系（collection關(guān)系，并給出該collection的網(wǎng)址），href表示API的路徑，title表示API的標(biāo)題，type表示返回類型。,,,,三、RESTful API SSM實(shí)現(xiàn),1、GET類型API實(shí)現(xiàn)2、DELETE類型API實(shí)現(xiàn)3、POST類型API實(shí)現(xiàn)4、PUT類型A

18、PI實(shí)現(xiàn)以上API均采用JSON格式數(shù)據(jù)傳輸,三、RESTful API SSM實(shí)現(xiàn),1、GET類型API實(shí)現(xiàn),三、RESTful API SSM實(shí)現(xiàn),2、DELETE類型API實(shí)現(xiàn),三、RESTful API SSM實(shí)現(xiàn),3、POST類型API實(shí)現(xiàn),三、RESTful API SSM實(shí)現(xiàn),4、PUT類型API實(shí)現(xiàn),四、RESTful API 測(cè)試,1、編碼測(cè)試2、工具測(cè)試,四、RESTful API 測(cè)試,1、編碼測(cè)試a、j