Restful接口開發(fā)測試指南

1、什么是Restful

1.1?定義

表征狀態(tài)轉(zhuǎn)移，一種新的通訊架構(gòu)。一般用于HTTP。

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

1.2?.net下的Restful API

.net下的Restful API采用WebAPI框架，WebAPI和SignalR都是事先服務(wù)的框架，但是SignalR面向?qū)崟r性服務(wù)。而WebAPI用于構(gòu)建常規(guī)的Restful API。

l?支持基于Http verb (GET, POST, PUT, DELETE)的CRUD (create, retrieve, update, delete)操作，通過不同的http動作表達(dá)不同的含義，這樣就不需要暴露多個API來支持這些基本操作。

l?請求的回復(fù)通過Http Status Code表達(dá)不同含義，客戶端可以通過Accept header來與服務(wù)器協(xié)商格式，例如服務(wù)器返回JSON格式還是XML格式；請求的回復(fù)格式支持 JSON，XML，并且可以擴(kuò)展添加其他格式。

l?原生支持OData：開放數(shù)據(jù)協(xié)議（Open Data Protocol，縮寫OData）是一種描述如何創(chuàng)建和訪問Restful服務(wù)的OASIS標(biāo)準(zhǔn)。

l?支持Self-host或者IIS host；支持大多數(shù)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服務(wù)。

l?只想發(fā)布一些簡單的Http服務(wù)，不想使用相對復(fù)雜的WCF配置。

l?發(fā)布的服務(wù)可能會被帶寬受限的設(shè)備訪問。

l?不需要復(fù)雜的MVC框架，Web API 與MVC的區(qū)別如下：

n?MVC主要用來構(gòu)建網(wǎng)站，既關(guān)心數(shù)據(jù)也關(guān)心頁面展示，而Web API只關(guān)注數(shù)據(jù)

n?Web API支持格式協(xié)商，客戶端可以通過Accept header通知服務(wù)器期望的格式

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

n?Web API通過不同的http verb表達(dá)不同的動作(CRUD)，MVC則通過Action名字表達(dá)動作

n?Web API內(nèi)建于ASP.NET System.Web.Http命名空間下，MVC位于System.Web.Mvc命名空間下，因此model binding/filter/routing等功能有所不同

1.4?WebAPI實現(xiàn)的Restful API路由機(jī)制

參考：https://www.cnblogs.com/landeanfen/p/5501490.html

2、SoapUI工具模擬Restful API服務(wù)器端

2.1下載

官網(wǎng)下載鏈接：

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創(chuàng)建Rest project

點擊左側(cè)“Projects”，如下：

運行New Rest Project，如下：

錄入：http://localhost:8080/api/test之后，點OK，出來如下界面：

增加一個Get參數(shù)id，如下：

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

2.3創(chuàng)建Mock服務(wù)

右鍵點擊左側(cè)的“http://localhost:8080”,彈出如下窗口：

執(zhí)行“Generate REST Mock service”，則顯示：

修改名字為Mock服務(wù)，點OK，則顯示：

注意運行端口已經(jīng)被改為8089.

?

到此，成功建立模擬Restful服務(wù)器。

?

3、RESTClient工具模擬Restful API前端

3.1下載

官網(wǎng)鏈接：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執(zhí)行：

?

3.3創(chuàng)建

輸入剛才在SoapUI中創(chuàng)建的Mock服務(wù)地址和參數(shù)，如下

點擊右側(cè)的按鈕執(zhí)行：

報404錯誤，查找原因：

查看SoapUI中有兩個Mock服務(wù)啟動：

停止一個，后再試：

返回為空。

?

查看SoapUI的Mock服務(wù)的response 1：

是空的，增加一段json數(shù)據(jù)：

重新啟動Mock服務(wù)。

?

然后返回RESTClient：

大功告成?。?！