ReDoc + SpringFox Swagger2 + 附加模型
ReDoc + SpringFox Swagger2 + additional models
我的用例如下:
我在 Spring 引导应用程序中使用 SpringFox Swagger2 以 json 格式生成 OpenAPI-compilant 规范。在配置 Docket bean 期间,我使用它的方法 additionalModels() 添加我想要记录的模型。此模型未被任何端点明确使用。
检查生成的 /v2/api-docs 以及 swagger-ui.html 我可以确认此模型与所有其他模型一起正确放置在 "definitions" 属性 下。
另一方面,ReDoc 似乎只呈现端点及其明确使用的模型和响应。我能以某种方式强制 ReDoc 渲染那个额外的 class 吗?例如,在 API 描述中以某种方式引用它?
我不确定,但我认为这与 this issue 有关。如果是这种情况,并且 ReDoc 目前不可能 - 具有相似外观和感觉的合理替代方案是什么?
这里是 ReDoc 作者。这在 ReDoc 中尚不可行,但将来会添加对此的支持。
在当前阶段我无法提出合理的解决方法,因此请订阅您提到的问题以保持更新。
我的用例如下: 我在 Spring 引导应用程序中使用 SpringFox Swagger2 以 json 格式生成 OpenAPI-compilant 规范。在配置 Docket bean 期间,我使用它的方法 additionalModels() 添加我想要记录的模型。此模型未被任何端点明确使用。
检查生成的 /v2/api-docs 以及 swagger-ui.html 我可以确认此模型与所有其他模型一起正确放置在 "definitions" 属性 下。
另一方面,ReDoc 似乎只呈现端点及其明确使用的模型和响应。我能以某种方式强制 ReDoc 渲染那个额外的 class 吗?例如,在 API 描述中以某种方式引用它?
我不确定,但我认为这与 this issue 有关。如果是这种情况,并且 ReDoc 目前不可能 - 具有相似外观和感觉的合理替代方案是什么?
这里是 ReDoc 作者。这在 ReDoc 中尚不可行,但将来会添加对此的支持。
在当前阶段我无法提出合理的解决方法,因此请订阅您提到的问题以保持更新。