Restful接口開發測試指南

一、什麼是Restful

1.1 定義

表徵狀態轉移，一種新的通信架構。通常用於HTTP。

https://www.runoob.com/w3cnote/restful-architecture.html

1.2 .net下的Restful API

.net下的Restful API採用WebAPI框架，WebAPI和SignalR都是事先服務的框架，可是SignalR面向實時性服務。而WebAPI用於構建常規的Restful API。

l 支持基於Http verb (GET, POST, PUT, DELETE)的CRUD (create, retrieve, update, delete)操做，經過不一樣的http動做表達不一樣的含義，這樣就不須要暴露多個API來支持這些基本操做。

l 請求的回覆經過Http Status Code表達不一樣含義，客戶端能夠經過Accept header來與服務器協商格式，例如服務器返回JSON格式仍是XML格式；請求的回覆格式支持 JSON，XML，而且能夠擴展添加其餘格式。

l 原生支持OData：開放數據協議（Open Data Protocol，縮寫OData）是一種描述如何建立和訪問Restful服務的OASIS標準。

l 支持Self-host或者IIS host；支持大多數MVC功能，例如Routing/Controller/Action Result/Filter/Model Builder/IOC Container/Dependency Injection。

1.3 何時須要WebAPI

如下狀況須要使用WebAPI：

l Web Service，但不須要SOAP。

l 在已有的Windows Communication Foundation框架上創建non-soap-based http服務。

l 只想發佈一些簡單的Http服務，不想使用相對複雜的WCF配置。

l 發佈的服務可能會被帶寬受限的設備訪問。

l 不須要複雜的MVC框架，Web API 與MVC的區別以下：

n MVC主要用來構建網站，既關心數據也關心頁面展現，而Web API只關注數據

n Web API支持格式協商，客戶端能夠經過Accept header通知服務器指望的格式

n Web API支持Self Host，MVC目前不支持

n Web API經過不一樣的http verb表達不一樣的動做(CRUD)，MVC則經過Action名字表達動做

n Web API內建於ASP.NET System.Web.Http命名空間下，MVC位於System.Web.Mvc命名空間下，所以model binding/filter/routing等功能有所不一樣

1.4 WebAPI實現的Restful API路由機制

參考：http://www.javashuo.com/article/p-swjpwrfq-dv.html

二、SoapUI工具模擬Restful API服務器端

2.1下載

官網下載連接：

https://www.soapui.org/downloads/thank-you-for-downloading-soapui.html

會自動下載，不然從新輸入：

https://s3.amazonaws.com/downloads.eviware/soapuios/5.5.0/SoapUI-x32-5.5.0.exe

 

2.2安裝

直接按提示安裝便可，運行界面：

2.3建立Rest project

點擊左側「Projects」，以下：

運行New Rest Project，以下：

錄入：http://localhost:8080/api/test以後，點OK，出來以下界面：

增長一個Get參數id，以下：

到此完成了test的接口定義。

2.3建立Mock服務

右鍵點擊左側的「http://localhost:8080」,彈出以下窗口：

執行「Generate REST Mock service」，則顯示：

修更名字爲Mock服務，點OK，則顯示：

注意運行端口已經被改成8089.

 

到此，成功創建模擬Restful服務器。

 

三、RESTClient工具模擬Restful API前端

3.1下載

官網連接：https://www.wiztools.org/index.html

編譯後的下載連接：https://github.com/wiztools/rest-client/releases

下載文件：restclient-ui-3.7.1.zip

3.2安裝

解壓到目錄：D:\restclient-ui-3.7.1

雙擊bin\restclient-ui.bat執行：

 

3.3建立

輸入剛纔在SoapUI中建立的Mock服務地址和參數，以下

點擊右側的按鈕執行：

報404錯誤，查找緣由：

查看SoapUI中有兩個Mock服務啓動：

中止一個，後再試：

返回爲空。

 

查看SoapUI的Mock服務的response 1：

是空的，增長一段json數據：

從新啓動Mock服務。

 

而後返回RESTClient：

大功告成！！！