swagger本地环境搭建 - jackyu126

时间:2024-03-10 17:45:55

swagger本地环境搭建

参考文档(Linux-Centos7.4 X64)

1、https://testerhome.com/topics/8168

2、https://testerhome.com/topics/9427

3.https://yq.aliyun.com/articles/773

操作步骤

步骤一、安装nodejs

1.官网下载对应版本的nodejs

2.加压tar -xvf node-v8.9.4-linux-x64.tar.xz

3.mv  node-v8.9.4-linux-x64 nodejs

4.cd /opt/nodejs/bin

5 ln -s /opt/nodejs/bin/node /usr/local/bin/node

ln -s /opt/nodejs/bin/npm /usr/local/bin/npm

6.npm -v /node -v 

步骤二、下载swagger-ui和swagger-edit

下载地址:https://github.com/swagger-api/swagger-ui

https://github.com/swagger-api/swagger-editor

步骤三、 安装http-server

使用node.js安装http-server模块,主要通过http-server模块来启用http服务,运行swagger-editor,通过命令:npm install -g http-server

不过由于某些原因,国内安装可能会非常慢,这时候我们就可以用淘宝 NPM 镜像,来加速 

首先运行命令:npm install -g cnpm --registry=https://registry.npm.taobao.org

然后可能需要重启cmd命令工具,运行:cnpm install -g http-server

这样就能很快的安装http-server了,同样的道理,如果需要安装其他模块,也可以通过cnpm来安装,然后通过cmd命令进入到Swagger-edit的根目录,运行命令

http-server -p 8000 

-p的作用是指定端口,后面的8000就是我们指定的端口,访问localhost:8000就可以进入swagger-edit就可以进入编辑界面了,左边是编辑框,右边是预览界面

 

 步骤三(通过tomcat运行swagger-editor):tomcat运行swagger-editor

首先把swagger-editor目录复制到tomcat根目录的webapps,然后运行tomcat,访问localhost:8080/swagger-editor

步骤四、部署swagger-ui

1. 创建一个空文件夹mkdir swagger

2.cd swagger,创建package.json文件:命令 touch package.json 

3.执行命令npm init:npm init package.json

4.安装express: npm install express --save

5.在swagger中创建目录public,并将刚才clone下来的Swagger UI中dist目录下的所有文件全部复制到public目录下面

6.创建并修改在swagger根目录下:创建index.js,touch index.js,内容如下:

var express = require(\'express\');
var http = require(\'http\');
var app = express(); // 接口显示页面 app.use(\'/static\', express.static(\'public\')); app.listen(8005, function () { console.log(\'app listening on port 8005!\'); });

7. 启动服务,执行如下命令:cd swagger/

  node swagger.js

打开http://127.0.0.1:8005/static/index.html,可以看到在线的官方的Demo已经在本地搭建好了。

 

步骤五、优化改造swagger-UI--配置json文件

将导出的data.json放置在swagger/public/data/下,并且修改一下swagger/public/index.html

重启node swagger.js,然后重新打开浏览器,可以看到自己根据服务端API编写的API文档

关键:如果想要自动生成接口测试用例,需要开发进行代码开发编写相关的注解