关闭

[置顶] Swagger-Editor开发环境搭建

标签: nodejs百度语言Swagger
2541人阅读 评论(1) 收藏 举报
分类:

前言

        上一篇文章我们有提到Swagger做接口的定义是采用yaml语言的,当然,yaml是个啥,大家自行百度。阿福在此不做赘述了。但是,今天我们要来讲的是yaml支持比较好的Swagger-Editor开发环境的搭建。


环境准备

        实际上,Swagger-Editor是基于 NodeJs 开发的,那么,就一定是需要Node的开发环境的啦!安装最新版的Node。直接去到NodeJs中文网,毕竟翻墙的梯子不是每个人都有,而且就算你有,呵呵,拖一个东西下来也不容易啊。链接如下:

NodeJs中文网

        下载最新版的开发环境即可,当然,这里的话你安装之后会顺便把npm安装上给你。npm是什么?这个暂时不操心,可以理解为maven一类的包管理工具。安装好后,测试下,* node -v*,你会看到当前的版本!看到了的话,恭喜你!
        好了下面环境准备好了,让我们进入正式流程撒!


下载 安装

        这个时候,我们需要从Github上clone最新的nodejs的包。指令如下:

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

        接下来,只需要温柔的进入到Swagger-Editor的目录里面。你就会看到如下的一个目录。


ed


        好了,我们来简单的看一下这里面都有啥?
dist里面毫无疑问放置的是一些静态的文件了,然后那个node_models放置的是你在package.json中定义的那些类库。我们只要看一下README.md就可以知道如何用了。下面,我们看看怎么去开始?
        首先,* npm install *去安装需要的modules,这将会把所有依赖的包安装上,当然,会有些许的warning,这里要记住,一定下载最新版的NodeJs啊。
        在很多别的教程里,会让我们在装上http-server,但是你仔细一点的话就会发现,在packge.json里面实际上是声明了http-server的啦。
好了,现在就可以启动了!
        退回到上一级目录,然后http-server 目录,直接就可以看到下面的信息!


Starting up http-server, serving swagger-editor-master
Available on:
  http://192.168.253.1:8080
  http://172.18.33.1:8080
  http://127.0.0.1:8080
Hit CTRL-C to stop the server

        接下来,访问那个Url,就可以看到美好得画面了!wd


        好了,接下来就可以尽情的使用了,实际上这个编辑器是有线上的版本的,但是苦于网速实在是好坑啊!本地有一个还是比较好的。啊哈哈哈


总结

        本文主要讲述了Swagger-Editor的本地安装,当然,阿福在这里实际上有句话要说,因为觉得不体系化的去写一下Swaager实在是有违天理。于是,后面的文章会按照我接下来放出的一张思维导图!


wd


        期待!也希望能带给大家收获!

0
0
查看评论

swagger环境的搭建(swagger-editor|swagger-ui)

swagger环境的搭建swagger-editor、swagger-ui
  • ron03129596
  • ron03129596
  • 2016-12-10 17:18
  • 18762

Swagger Editor本地开发环境搭建

Swagger Editor本地开发环境搭建 转自:http://blog.csdn.net/wangmeng951011/article/details/67640375 环境准备         ...
  • yueguanyun
  • yueguanyun
  • 2017-05-19 13:46
  • 2650

Windows 搭建swagger editor 和swagger ui

一,搭建swagger editor 要求:node.js环境 1,安装node.js 2, npm install; 3, git clone https://github.com/swagger-api/swagger-editor.git cd swagger-editor np...
  • u013796473
  • u013796473
  • 2017-07-12 18:20
  • 955

swagger-editor

  • 2016-02-22 10:15
  • 2.17MB
  • 下载

Node.js +Swagger Editor + Swagger-UI 环境搭建

安装node.js下载node.js最新版 https://nodejs.org/en/download/ 点击 安装器 node-v6.11.1.pkg 开始安装 一路下一步,安装完成 node.js安装后验证 npm -v node -v 下载Swagger-Editorhttps:...
  • ruglcc
  • ruglcc
  • 2017-07-26 22:02
  • 2167

swagger 学习笔记

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。Swagger的目标是对REST API定义一个标准的和语言无关的接口,可让人和计算机无需访问源码、文档或网络流量监测就可以发现和理解服务的能力。当通过Swagger进行正确定义,用户可以理解...
  • good_night_honey
  • good_night_honey
  • 2015-09-17 22:11
  • 4755

swagger-editor====本地部署到http-server

github 上的swagger-editor:https://github.com/swagger-api/swagger-editor,作为参考 按照github上的方法,没有尝试成功。直接download下来解压文件,提示少了个bundle.js。崩溃啊。 但是=======这是一个华...
  • HelloWorld94
  • HelloWorld94
  • 2016-06-21 18:45
  • 3375

Swagger环境搭建之非依赖代码法

前言Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此...
  • wantnrun
  • wantnrun
  • 2016-10-08 10:04
  • 4264

(Swagger)一个终端和后台开发对api接口管理工具

Swagger包括库、编辑器、代码生成器等很多部分,这里我们主要讲一下Swagger Editor。这是一个完全开源的项目,并且它也是一个基于Angular的成功案例,我们可以下载源码并自己部署它,也可以修改它或集成到我们自己的软件中。
  • jiadabin
  • jiadabin
  • 2016-07-18 11:44
  • 10197

【swagger】前后端分离联调利器——swagger安装和使用

一、前言      互联网发展越来越迅速,近来项目中使用了前后端分离的模式。前端开发使用Angular4,后端开发使用SSM框架。这样的话就有了前后端联调的问题,接口数据类型,接口返回参数等等问题。项目初期的时候使用postman进行测试,...
  • kisscatforever
  • kisscatforever
  • 2017-11-16 17:17
  • 417
    个人资料
    • 访问:117250次
    • 积分:2149
    • 等级:
    • 排名:千里之外
    • 原创:99篇
    • 转载:8篇
    • 译文:1篇
    • 评论:46条