有没有办法从 C++ 代码生成一个 swagger 规范文件？答案

【问题标题】：Is there a way to generate a swagger specification file from C++ code?有没有办法从 C++ 代码生成一个 swagger 规范文件？
【发布时间】：2019-05-10 23:24:35
【问题描述】：

我需要在用 C++ 编写的旧 API 接口上创建 HTTP API 层。我的计划是生成 Swagger 或打开 API 文件，然后将其提供给需要编写客户端（将成为新 API 的使用者）或服务器（旧 API 的包装器）的项目。

有什么东西可以加快这个要求（除了手动解析它们并创建 swagger 规范文件）？即使用 C++ 代码生成 swagger JSON/YML 文件

【问题讨论】：

你可以看看github.com/oatpp/oatpp-swagger。它提供注释 - 像 swagger-ui 生成。但它需要 oatpp 作为您的服务器框架

标签： swagger openapi swagger-codegen openapi-generator

【解决方案1】：

您已经尝试过Swagger Codegen 是一个 API，可用于多种语言，包括 C++

【讨论】：

我正在从代码中寻找相反的、招摇的规范。就像 Swagger2Feature 提供来自 JAX-RS 服务端点的 swagger 规范一样，我想要从 C++ 代码创建的动态 swagger 定义。为什么？无需为大量端点手动创建招摇。此外，对服务入口点的任何添加都将获得最新的招摇。这是我管理的：解析 C++ 代码中的服务端点定义（使用 pycparser）获取服务端点/操作的细节，然后从中生成招摇。

【解决方案2】：

答案很晚，我认为没有好消息。

如果您谈论的是 C++ 中注释的实现。据我所知Swagger Core Annotations 是Swagger Core Project 的一部分，您可以在文档中找到：

Swagger Core 是 OpenAPI 规范的 Java 实现。当前版本支持 JAX-RS2。

Prerequisites 也说：

您需要在$PATH 中安装并提供以下内容：

Java 8

Apache maven 3.0.4 或更高版本

Jackson 2.4.5 或更高版本

【讨论】：