Restful接口开发测试指南

1、什么是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路由机制

参考：https://www.geek-share.com/detail/2675102180.html

2、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服务器。

3、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：

大功告成！！！