DOClever,Postman,Swagger对比及使用

1、简述

	接口文档	特点	持续集成	自动化测试	mock	数据兼容性	依赖
Postman	满分	轻量，线上填写	依托于 newman	可以	支持	Swagger,rap
Swagger	满分		依托于postman 或根据api自研	依赖Postman	支持，需开发
RAP	满分	阿里出品，老牌		不支持	支持
DOClever	满分	开源免费，新 ，界面好看	不支持	简单，平台编写测试用例， 支持定时任务	支持，贼简单	Swagger，Postman ，RAP数据导入	node,npm, robomongo

 

2、DOClever实用

根据官方文档进行安装

https://github.com/sx1989827/DOClever

然而我想安装在CentOS7上，文档中只提供了mac,windows和Ubuntu的安装方式。

故尝试安装方法为：

2.1安装node和npm(略)

2.2安装MongoDB

vi /etc/yum.repos.d/mongodb-org-3.4.repo

，插入以下内容

[mongodb-org-3.4]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.4/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.4.asc

安装MongoDB

yum install -y mongodb-org

修改配置

vi /etc/mongod.conf

把bindIP改成 0.0.0.0所有的机器都可以访问

启动mogodb
 

systemctl start mongod.service
systemctl stop mongod.service //停止
systemctl restart mongod.service //重启

 

链接mongodb

mongo 127.0.0.1:27017

3.安装DOClever

3.1下载源码

git clone https://gitee.com/sx1989827/SBDoc.git 

3.2安装和注册

mv SBDoc DOClever
node DOClever/Server/bin/www

会让你输入MongoDB地址

mongodb://127.0.0.1:27017/DOClever

请注意在之前的mongoDB中建一个库DOClever并且随便插入一条数据

use DOClever
db.DOClever.insert({"name":"test"})

启动后发现线程没有办法后台运行，所以请安装forever守护进程

npm install -g cnpm 
/appl/bin/node_8/lib/node_modules/cnpm/bin/cnpm install forever -g
/appl/bin/node_8/lib/node_modules/forever/bin/forever start /appl/bin/DOClever/Server/bin/www

http://172.19.3.133:19527/DOClever

至此安装成功

2.3导入数据

我们首先尝试导入swagger的数据，swagger导出数据非常容易，就是项目访问地址后面加/v2/api-docs即可

http://172.19.3.129:8080/memservice/v2/api-docs

我们把刚才的swagger地址填入

其他主要的使用细节，这里就不赘述了，详细请看官方文档。

http://doclever.cn/controller/read/read.html#5a532f98b7731a2ba86093b3

2.4api抓取

由于此工具不支持持续集成，没有提供对外接口，故我们尝试一下抓取网络查看能否通过外部调用的方式实现。

我们看到所需要的参数有这么些。

简单实现的话直接抄一个post应该可以。不过事实上，由于其本身的开源特性，完全可以通过二次开发来实现持续集成的功能。

 

 

3、postman

postman是谷歌的一款非常好用的工具，可以用来做手工的接口测试，也能实现简单的接口自动化持续集成

 

3.1环境依赖

nodejs，newman

 

3.2nodejs安装（略）

3.3 newman安装

npm install -g newman

newman -v

newman的命令十分简单，run -h一目了然

假如想输出报告。请见官方文档

注意，输出html类型的报告可能需要额外安装

https://github.com/postmanlabs/newman-reporter-html

 

3.4postman安装

直接官网Windows下载安装

3.5导入

可以导入raml,wadl,swagger格式数据

导入数据

http://172.19.3.129:8080/memservice/v2/api-docs

OK导入成功

页面基本操作

3.6导出

在collection右边的...可以选择导出，导出的json可以用作Newman测试，也可以传输到别的接口文档管理软件中。

 

4、swagger

(待续)