从 Vertx 中的现有路由器生成 OpenApi 规范

Generate OpenApi Specification from existing routers in Vertx

我正在尝试为 Vert.X 响应式应用程序生成 swagger 文档。当前的解决方案是将静态 YAML 文件转换为 openapi.json 文件。

这是一项非常繁重的工作,我想知道是否有办法自动完成这项工作。我知道有相反的解决方案,但因为它是一个现有的应用程序,所以这是不可能的。

我找到了以下库:https://github.com/outofcoffee/vertx-oas 这是我想要的方向,但遗憾的是不是最新的。

我希望这是可能的,但我现在有点卡住了。

vertx-web-api-contract 维护人员在这里。不幸的是,由于 Vert.x Web 路由器 APIs.

的设计,我们没有 Vert.x Web 到 OpenAPI 转换的官方解决方案

从路由器开始,无法推断请求参数是什么、它们在请求中的位置、它们的模式、是否需要它们、它们的样式等。同样的事情适用于响应主体,其中您无法推断 body 架构。

Jax-rs 和类似的技术允许这种转换,因为它们使用一些声明性的 API(例如注释)来描述请求合同,因此转换器只需要阅读此描述以将其转换为 Open API合同

弗朗切斯科