在 Spring 引导项目中记录 API 的最佳方式是什么?
What is the best way to document APIs in Spring boot project?
- 使用 SpringFox swagger
- springdoc-openapi https://springdoc.org/
- 使用 io.swagger.v3.oas.integration.SwaggerConfiguration
我会说这是基于边缘意见,但考虑使用 springdoc。 Springfox
在这一点上有很多问题,使用起来很痛苦。我在 2 年前搬到了 springdoc
,因为它支持 Spring WebFlux,对此我感到非常高兴。此外,它还支持 Kotlin Coroutines,我不确定 Springfox 是否支持。
如果您决定使用 springdoc
并且您过去使用过 Springfox
,甚至还有一个 migration guide。
- 使用 SpringFox swagger
- springdoc-openapi https://springdoc.org/
- 使用 io.swagger.v3.oas.integration.SwaggerConfiguration
我会说这是基于边缘意见,但考虑使用 springdoc。 Springfox
在这一点上有很多问题,使用起来很痛苦。我在 2 年前搬到了 springdoc
,因为它支持 Spring WebFlux,对此我感到非常高兴。此外,它还支持 Kotlin Coroutines,我不确定 Springfox 是否支持。
如果您决定使用 springdoc
并且您过去使用过 Springfox
,甚至还有一个 migration guide。