Swagger是遵守OpenAPI规范(OAS)的世界上最大的API框架开发工具,可在整个API生命周期内进行开发,从设计和文档到测试和部署。它提供了许多试用的工具来帮助开发者进行接口开发,如及时接口文档编写工具swagger-editor,前端展示swagger-ui,还有代码自动生成工具swagger-codegen。
下面会分别对这些工具进行介绍,由于Swagger的版本更新较快,功能愈发强大,所以我选择了使用swagger2进行整合,并且使用java语言进行示例。
功能强大的swagger-editor的介绍与使用 --生成API文档,兼生成服务端代码
swagger-ui生成api文档并进行测试 --API文档和接口测试
如果,你只是想在你的java spring工程里使用swagger,那么你可以直接看这篇文章
Spring Boot中使用Swagger2构建强大的RESTful API文档
如果,你觉得swagger原生的ui风格不好看,想换换风格,你可以看这篇文章
Swagger 自定义UI界面
标准
OAS标准(OpenAPI规范标准) https://www.jianshu.com/p/5365ef83252a
原文地址:https://www.cnblogs.com/jiftle/p/12272442.html
时间: 2024-10-25 06:20:53