swagger-swagger和springfox区别

swagger

swagger(符合 OpenAPI 规范,看这里) 是一个Api开发框架,支持更多语言同时输出一个通用的风格

Swagger Editor: 在一个完全专用于基于OpenAPI的API的开源编辑器上设计和编辑API。 Swagger编辑器非常适合快速入门OpenAPI(以前称为Swagger规范)规范,并支持Swagger 2.0和OpenAPI 3.0。

Swagger UI:提供了一个可视化的UI页面展示描述文件。它是根据OpenAPI(以前称为Swagger)规范自动生成的,具有可视化文档,可简化后端实现和客户端使用。

Swagger Codegen: 可以通过为使用OpenAPI(以前称为Swagger)规范定义的任何API生成服务器存根和客户端SDK来简化构建过程,因此您的团队可以更好地专注于API的实现

Swagger Hub:集成了上面所有项目的各个功能,你可以以项目和版本为单位,将你的描述文件上传到Swagger Hub中。在Swagger Hub中可以完成上面项目的所有工作,需要注册账号,分免费版和收费版。

springfox

springfox:由于Spring的流行,Marty Pitt编写了一个基于Spring的组件swagger-springmvc,用于将swagger集成到springmvc中来。而springfox则是从这个组件发展而来,
同时springfox也是一个新的项目。springfox 是一个 spring 的自动的 json api 文档生成器,目前项目有 1.x 版本和 2.x 版本
springfox-swagger-ui: 是springfox 的一个模块,其对 swagger-ui 模块进行了封装。并添加了一个/swagger-resources 接口可以列出所有swagger 资源和版本配置,通过访问项目路径加 /swagger-ui.html 来查看 api文档

总结

总结下来就是:

swagger 是一种规范。
springfox-swagger 是基于 Spring 生态系统的该规范的实现。
springfox-swagger-ui 是对 swagger-ui 的封装,使得其可以使用 Spring 的服务。
参考文档

posted @ 2020-04-13 23:50  莫己若  阅读(125)  评论(0)    收藏  举报