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

---

总结

理解的还是特别的深刻，需要项目的实践