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

发布于:2022-10-12 ⋅ 阅读:(2310) ⋅ 点赞:(2)

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


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更为活跃。



附件

本文含有隐藏内容,请 开通VIP 后查看

网站公告

今日签到

点亮在社区的每一天
去签到