前言

小编前几天在学习了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工具详解相关推荐

  1. rpm包安装和卸载,rpm查询,yum工具详解,yum仓库搭建

    rpm包安装和卸载 [root@binbinlinux Packages]# rpm -ivh zip-3.0-1.el6.x86_64.rpm    安装rpm包命令   ivh I=安装的意思in ...

  2. centos rpm 安装 perl_XtraBackup工具详解 Part 2 xtrabackup安装

    实验环境 此次实验的环境如下 MySQL 5.7.25 Redhat 6.10 1. xtrabackup版本 我们在官方网站可以看到xtrabackup有多个版本 https://www.perco ...

  3. Chrome开发者工具详解(4)-Profiles面板

    Chrome开发者工具详解(4)-Profiles面板 如果上篇中的Timeline面板所提供的信息不能满足你的要求,你可以使用Profiles面板,利用这个面板你可以追踪网页程序的内存泄漏问题,进一 ...

  4. parted工具详解

    通常我们用的比较多的一般都是fdisk工具来进行分区,但是现在由于磁盘越来越廉价,而且磁盘空间越来越大:而fdisk工具他对分区是有大小限制的,它只能划分小于2T的磁盘.但是现在的磁盘空间很多都已经是 ...

  5. Java定时任务调度工具详解之Timer篇

    Java定时任务调度工具详解之Timer篇 https://segmentfault.com/a/1190000009542398

  6. python数值转换机_用于ETL的Python数据转换工具详解

    ETL的考虑 做 数据仓库系统,ETL是关键的一环.说大了,ETL是数据整合解决方案,说小了,就是倒数据的工具.回忆一下工作这么些年来,处理数据迁移.转换的工作倒 还真的不少.但是那些工作基本上是一次 ...

  7. Java定时任务工具详解之Timer篇

    Java定时任务调度工具详解 什么是定时任务调度? ◆ 基于给定的时间点,给定的时间间隔或者给定的执行次数自动执行的任务. 在Java中的定时调度工具? ◆ Timer ◆Quartz Timer和Q ...

  8. PS调整边缘工具详解

    转载地址 : http://www.360doc.com/content/15/1129/12/4127803_516682427.shtml *"调整边缘"工具详解 (ps教程) ...

  9. valgrind和Kcachegrind性能分析工具详解

    作者: zhuyong 原文地址 一.valgrind介绍 valgrind是运行在Linux上的一套基于仿真技术的程序调试和分析工具,用于构建动态分析工具的装备性框架.它包括一个工具集,每个工具执行 ...

最新文章

  1. 代码提示_PHPStorm 支持 Laravel Facades 的代码提示
  2. Vue组件中使用Sass或者Less全局变量
  3. SAP UI5加载时的library-preload.json文件
  4. 2021年肇庆高考成绩查询,2021年肇庆高中学校排名及录取分数线排名
  5. Java中线程的生命周期-图解
  6. jq 检测元素内html变化,jq 监听 textarea 元素内容变化的方法
  7. Intel微处理器列表_百度百科
  8. Linux部署之批量自动安装系统之DHCP篇
  9. Redis 实现队列优先级
  10. 全国省市县行政代码表1
  11. 怎么下载并使用向日葵远程工具
  12. 常见对称加密、解密、破解
  13. 六级考研单词之路-四
  14. 上java培训班有用吗?Java有必要上培训班吗?
  15. php mysql 插入图片_mysql中怎样插入图片
  16. MathJax 引擎数学符号说明
  17. 96.(leaflet之家)leaflet态势标绘-进攻方向修改(燕尾)
  18. DELPHI 线程类
  19. Python 输出100-999的水仙花数
  20. 宴会泡泡机市场前景分析及研究报告

热门文章

  1. 编译安装python3.6
  2. 2020春软件构造Lab2 ADT and OOP
  3. 特斯拉向上,蔚来汽车向前
  4. 1.20 不定式 比较级
  5. 感恩工作平台心得体会_心得体会-感恩工作心得体会
  6. 已知有十六支男子足球队参加2008 北京奥运会。写一个程序,把这16 支球队随机分为4 个组
  7. U盘变为只有2M大小空间的解决方法
  8. 机器学习实现矿物识别(第二周)
  9. YTUOJ-HOMEWORK
  10. idea的文件一直在不停闪烁,并不停updating and index