名词解释：swagger, openapi, springfox, springdoc

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

• Swagger vs OpenApi
• • 1. Swagger
  • 2. OpenApi
  • 3. 二者关系
• Springfox vs Springdoc
• • 1. Springfox
  • 2. Springdoc
  • 3. 二者关系
• 附件

---

Swagger vs OpenApi

1. Swagger

Swagger是一组Restful Api的设计，开发，文档生成和测试工具（API design, development, documentation and testing ），通过在代码中添加注解方式实现，其遵循OpenApi协议。Swagger通常代指OpenApi 2.0。

2. OpenApi

OpenApi就是Http Api的描述规范，基于此规范，生成了各种Api相关的工具。

3. 二者关系

Swagger代指 Open Api 2.0，是一个协议+工具的结合体。Open Api 3.0后，以单纯的规范的形式出现，剥离具体的实现。也有人用Swagger 3.0来表示 Open Api 3.0。

Springfox vs Springdoc

1. Springfox

Springfox其实是一个通过扫描代码提取代码中的信息，生成API文档的工具。API文档的格式不止Swagger的OpenAPI Specification，还有RAML，jsonapi，Springfox的目标同样包括支持这些格式。

2. Springdoc

Springdoc是一个java类库，用于自动产生Api文档，支持OpenApi 3.0。

3. 二者关系

Springdoc和Springfox比起来，Springdoc更为活跃。

附件

• OpenAPI Vs Swagger: An In-Depth Clarification
  
• difference-between-open-v2-v3-v31