Springfox Swagger Ui从现有的JSON

Question

我有一个由gradle支持的SpringBoot应用程序，我们最初只是在这里创建

REST控制器，然后使用@EnableSwagger2注释创建我们的swagger。这是很好的工作，但现在我们想要过渡到API的第一种方法。

这意味着我们现在首先创建我们的swagger.json，然后使用swagger-codegen来生成我们的SpringBoot接口/控制器，以便在我们的SpringBoot应用程序中使用。我现在试图弄清楚如何让springfox-swagger-ui使用我们创建的swagger.json，而不是在事后查看java代码来生成UI。在我看来，这是正确的方法，以避免本质上的springfox-swagger-ui在幕后重新生成swagger.json时可能出现的任何不一致。

如何配置此行为？谢谢。

Answer 1

这里是一个关于如何从现有的swagger.json创建Swagger的工作示例。

您需要编写一个具有以下端点的自定义Swagger控制器：

1. /swagger-resources端点，它返回springfox.documentation.swagger.web.SwaggerResource对象的JSON字符串表示形式。
2. /swagger-resources/configuration/ui端点，它返回springfox.documentation.swagger.web.UiConfiguration对象的JSON字符串表示形式。
3. /swagger-resources/configuration/security端点，它返回springfox.documentation.swagger.web.SecurityConfiguration对象的JSON字符串表示形式。
4. /v2/api-docs端点，它返回Swagger定义的JSON表示形式。