过去两年我使用 Springfox 开发 Spring Boot 应用程序。 Springfox 为您的 REST API 生成文档和测试 ui。
但实际上Springfox项目已经死了并且不支持最新的Spring。
如何在 Spring Boot 3.4 项目中实现 swagger ui?
我自己还没有尝试过,但这看起来很有希望:
https://github.com/springdoc/springdoc-openapi
OpenAPI 3.0 是 Open API 2.0 的后继者(有时称为 Swagger,尽管这实际上是围绕 Open API 的工具)。 不确定这个项目在定制方面提供了多少以及它有多成熟,但我想它值得一试;-)
更新:
从版本 3 开始,Spring Fox 提供了对 Open API 3 的支持。请参阅发布日志了解更多详细信息。
Spring doc Open API 是未来的替代方案。
请参考以下链接
https://techsparx.com/software-development/openapi/spring-boot-rest-api-docs.html
https://github.com/RabiAPI/Evalon4J
这是一个用于生成java Restful api文档的命令行工具
支持的框架
现在它可以将您的 api 导出为 Markdown 格式。