[原创] Springfox 3.0.0(包含swagger2-3.0.0)即OpenAPI 3的发布与系统集成
一. 前言(open api 、swagger、springfox 和springdoc简介)
open api 简介
OpenApi是业界真正的 api 文档标准,一个规范,好比java里面一个抽象的概念。
它即是一个抽象类,只是提供了一个api文档规范的抽象方法,该方法目前被两大非官方实现了,一个是springfox,另一个是springdoc。
swagger 简介
- swagger 是一个 api 文档维护组织,后来成为了 Open API 标准的主要定义者,现在最新的版本为17年发布的 Swagger3(Open Api3)。
- 国内绝大部分人还在用过时的swagger2(17年停止维护并更名为swagger3)swagger2的包名为 io.swagger,而swagger3的包名为 io.swagger.core.v3。
springfox 简介
- SpringFox是 spring 社区维护的一个项目(非官方),帮助使用者将 swagger2 集成到 Spring 中。常常用于 Spring 中帮助开发者生成文档,并可以轻松的在spring boot中使用。
- 截至2020年4月,都未支持 OpenAPI3 标准。
- 此版本实现较springdoc来讲,实现不是很规范和正式,少了很多架构上的灵活性,维护更新也不如springdoc活跃