Swagger工具详解
前言
小编前几天在学习了Swagger,一直都处于迷迷糊糊的,不太明白他的优势,单纯的认为只是提供给我们一个界面用于前后台的交互,其实还有很多其他的功能
What Swagger
swagger表示用于前后端分离,接口管理和测试工具集,Swagger规范定义了一系列的文件,用以描述API,这些文件被Swagger-ui显示用于展示API,也可以用于被Swagger-Codegen项目用于生产代码,我们使用Swagger进行APIDE设置
他可以帮助我们再看不到代码和源码的情况下,把我们我们去理解功能,调用我们的接口
Where Swagger
OpenAPI的前身是swagger规范
How Swagger
可以用json和YaML,另一种标记语言,可以被电脑直观识别的数据序列化格式
Swagger是描述REST API格式的一组规则(换言之,规范)。该格式是机器可读的和人类可读的。因此,它可以用来在产品经理,测试人员和开发人员之间共享文档,但也可以被各种工具用来自动执行与API相关的过程。
Swagger编辑器 - 一个基于浏览器的编辑器,您可以在其中编写OpenAPI规范。
Swagger UI - 将OpenAPI规范呈现为交互式API文档
Swagger Codegen - 根据OpenAPI规范生成服务器代码和客户端库。
Why Swagger
同时设计和记录API,从而保持蓝图和文档的同步。
人机交互,自动生成交互式API文档,以查看API的实际操作。
围绕这个框架的大型综合工具生态系统,可以让从SDK生成到测试和调试,不仅仅是设计。
强大的开源社区支持和领导框架。
区分
Swagger==实用工具
OpenAPI=规范
OpenAPI的规范是由该计划涉及来自技术领域不同领域的30多个组织,包括微软,Google,IBM和CapitalOne进行推动的,领导Swagger也是OpenAPI计划的成员,Swagger是用于实现OpenAPi规范的工具
Why Swagger工具没有改名为OpenAPI
Swagger具有Swagger UI,Swagger Editor和Swagger Codegen核心开发工具组成,由于有大量的开发人员,技术编写人员,测试人员和设计人员所以Swagger工具仍然保留了原有的品牌,虽然Swagger没有改名字但是Swagger会继续遵从OpenAPI的规范设计
总结
理解的还是特别的深刻,需要项目的实践
Swagger工具详解相关推荐
- rpm包安装和卸载,rpm查询,yum工具详解,yum仓库搭建
rpm包安装和卸载 [root@binbinlinux Packages]# rpm -ivh zip-3.0-1.el6.x86_64.rpm 安装rpm包命令 ivh I=安装的意思in ...
- centos rpm 安装 perl_XtraBackup工具详解 Part 2 xtrabackup安装
实验环境 此次实验的环境如下 MySQL 5.7.25 Redhat 6.10 1. xtrabackup版本 我们在官方网站可以看到xtrabackup有多个版本 https://www.perco ...
- Chrome开发者工具详解(4)-Profiles面板
Chrome开发者工具详解(4)-Profiles面板 如果上篇中的Timeline面板所提供的信息不能满足你的要求,你可以使用Profiles面板,利用这个面板你可以追踪网页程序的内存泄漏问题,进一 ...
- parted工具详解
通常我们用的比较多的一般都是fdisk工具来进行分区,但是现在由于磁盘越来越廉价,而且磁盘空间越来越大:而fdisk工具他对分区是有大小限制的,它只能划分小于2T的磁盘.但是现在的磁盘空间很多都已经是 ...
- Java定时任务调度工具详解之Timer篇
Java定时任务调度工具详解之Timer篇 https://segmentfault.com/a/1190000009542398
- python数值转换机_用于ETL的Python数据转换工具详解
ETL的考虑 做 数据仓库系统,ETL是关键的一环.说大了,ETL是数据整合解决方案,说小了,就是倒数据的工具.回忆一下工作这么些年来,处理数据迁移.转换的工作倒 还真的不少.但是那些工作基本上是一次 ...
- Java定时任务工具详解之Timer篇
Java定时任务调度工具详解 什么是定时任务调度? ◆ 基于给定的时间点,给定的时间间隔或者给定的执行次数自动执行的任务. 在Java中的定时调度工具? ◆ Timer ◆Quartz Timer和Q ...
- PS调整边缘工具详解
转载地址 : http://www.360doc.com/content/15/1129/12/4127803_516682427.shtml *"调整边缘"工具详解 (ps教程) ...
- valgrind和Kcachegrind性能分析工具详解
作者: zhuyong 原文地址 一.valgrind介绍 valgrind是运行在Linux上的一套基于仿真技术的程序调试和分析工具,用于构建动态分析工具的装备性框架.它包括一个工具集,每个工具执行 ...
最新文章
- 代码提示_PHPStorm 支持 Laravel Facades 的代码提示
- Vue组件中使用Sass或者Less全局变量
- SAP UI5加载时的library-preload.json文件
- 2021年肇庆高考成绩查询,2021年肇庆高中学校排名及录取分数线排名
- Java中线程的生命周期-图解
- jq 检测元素内html变化,jq 监听 textarea 元素内容变化的方法
- Intel微处理器列表_百度百科
- Linux部署之批量自动安装系统之DHCP篇
- Redis 实现队列优先级
- 全国省市县行政代码表1
- 怎么下载并使用向日葵远程工具
- 常见对称加密、解密、破解
- 六级考研单词之路-四
- 上java培训班有用吗?Java有必要上培训班吗?
- php mysql 插入图片_mysql中怎样插入图片
- MathJax 引擎数学符号说明
- 96.(leaflet之家)leaflet态势标绘-进攻方向修改(燕尾)
- DELPHI 线程类
- Python 输出100-999的水仙花数
- 宴会泡泡机市场前景分析及研究报告