必威体育Betway必威体育官网
当前位置:首页 > IT技术

Swagger

时间:2019-06-30 22:43:24来源:IT技术作者:seo实验室小编阅读:72次「手机版」
 

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的规范设计

转载自: HTTPs://blog.csdn.net/dtttyc/article/details/78797546?foxhandler=RssReadRenderProcessHandler

相关阅读

分享到:

栏目导航

推荐阅读

热门阅读