用openapi3 json和SpringDoc呈现HAL格式的链接
用openapi3 json和SpringDoc呈现HAL格式的链接
提问于 2022-11-28 20:48:23
我正在运行一个Springdoc应用程序，支持，并使用Springdoc插件生成OpenAPIv3文档。然而，当我调用REST端点时，我得到了HAL格式的JSON ("_links")中的链接。但是生成的OpenAPIv3文档为链接提供了一种不同的格式(“链接”)。
如何获得生成的OpenAPIv3文档来匹配HAL格式的链接？
我找到的唯一资源是这个链接：https://github.com/springdoc/springdoc-openapi/issues/446，但是，给出的解决方案包括使用我没有使用的spring-数据-rest(我需要吗？)
我还尝试添加@EnableHyperMediaSupport，它表示它配置了JSON呈现，但这对OpenAPIv3文档没有任何影响。
回答 1
Stack Overflow用户
回答已采纳
发布于 2022-11-30 01:01:16
答案很简单，我需要引入依赖项(https://springdoc.org/#spring-hateoas-support)。在JSON文档中提取这一点之后，没有额外的配置就正确生成了(我不需要@EnableHypermediaSupport或spring rest)。
但是，如果您正在使用Swagger，请注意它将自动生成伪“additionalProperty”链接作为资源模式的示例。这只是在Swagger中，如果您查看生成的openapiv3 json，结构是正确的(cf：https://github.com/springdoc/springdoc-openapi/issues/237)。要解决这个问题，您可以提供您自己的资源架构示例。
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接：
https://stackoverflow.com/questions/74606308
复制相关文章
相似问题
腾讯云开发者
