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：

大功告成！！！