问题标签 [swagger-codegen]

Swagger 代码生成器可以生成多种语言的 SDK（下面从 Github 项目页面列出）。是否有人在生产中使用任何 Swagger 自动生成的 SDK，包括 alpha/beta 版和 GA 版，如果是，哪些组织和哪些语言？

我做了一些谷歌搜索并四处询问。虽然我发现了许多部署 Swagger UI 的示例，但我还没有找到任何 Code Gen SDK。

项目页面：https ://github.com/swagger-api/swagger-codegen

语言：

更新 - 重大项目官方 SDK 跟踪（2018 年 6 月）

我在这里跟踪来自较大组织的可识别的官方代码生成 SDK，以更好地跟踪采用情况。许多将自己列为使用某些代码生成项目的组织尚未在其 GitHub 帐户上发布 SDK。

• https://github.com/grokify/api-specs/blob/master/official_codegen_sdks.tsv

更新 - 个人经历（2017 年 12 月）

我现在一直在积极地使用 Swagger Codegen for Go (2.2.3 - 2.3.1)。到目前为止，我的经验是它做得不错，但可能需要进行各种手动调整才能获得有效的 SDK，因此 GitHub 包/repo 仍然不错。您可以在我维护的 SDK 的 GitHub 问题中看到一些问题。codegen/swagger_codegen_command.sh我还在每个 repo中的文件中添加了后期处理。

• https://github.com/grokify/go-aha
• https://github.com/grokify/go-ringcentral
• https://github.com/grokify/go-visa
• https://github.com/grokify/go-voicebase-v3

更新 - 添加 OpenAPI 生成器（2018 年 7 月）

OpenAPI Generator 是 Swagger Codegen 的一个分支，所以现在也提到了这一点。

我正在学习使用 swagger code gen 从 swagger.json 文件生成一堆 csharp 文件。

在 CSharpClientCodeGen.class 中，我注意到 apiPackage 和 modelPackage 的变量会在其中生成 Api 和 Model cs 文件。我想创建一个类似于 apiPackage 和 modelPackage 的新包。

我尝试添加以下代码

然后构建客户端代码，但我没有在其中看到新的包文件夹。

不知道该怎么做。如果您能向我指出如何执行此操作的资源，那就太好了。

谢谢

我swagger-codegen用来生成我的客户端 C# 类。它可以完成工作，但是我想定制一些东西：

1）最重要的是，我如何告诉它使用哪个命名空间，或者可能是基本命名空间？现在所有生成的类都有IO.Swagger.Model命名空间，我该如何改变它？

2）我所有生成的模型都以 I 开头......就像在 ICustomer 中一样......如果类名以 2 个大写字母开头并且第一个字母是 I，有没有办法自动删除第一个 I？

3）如果 2 可以完成，有没有办法让它附加一个 : IWhatever？所以如果它试图 gen ICustomer，我想看看：

这可以做到吗？

4）对于我的最后一个问题，我使用的是这个命令行：

问题是它将它添加到路径中： src\main\csharp\IO\Swagger

有没有办法让我不把它添加到路径中？

5) 最后，也是最不重要的，它生成 4 个文件夹：Api、Client、Model和Properties. 有没有办法只生成Client和Model文件夹？

我需要能够从同一模块中的控制器更改 Angularjs 服务中变量的值。TL;DR 版本低于...

我有一个带有 RESTful API 的嵌入式系统，由 swagger 文件描述。我正在通过 Angularjs 应用程序访问它。为了创建这个应用程序，我使用了 swagger-codegen 来自动生成服务。这会导致一个服务被传递一个基本路径，该基本路径在服务内部从对 $http 的调用中使用。该服务如下所示：

在我的角度 app.js 文件中，我有以下内容：

这一切都很好。但是，我希望能够从应用程序中设置设备的基本路径（特别是 IP 地址）。但是服务一开始就启动了，我不知道如何让控制器能够更新服务变量basePath_。

我可以重写服务函数以接受基本路径作为参数，但我不想重写它们由 swagger-codegen 自动生成的服务。

我对任何解决方案持开放态度 - 寻求关于什么可能是总体上做到这一点的最佳方式的建议。

更新：2016 年 5 月 24 日 - 有人让我发布招摇的代码。这是其中一个文件的相关部分，包括初始服务功能以及方法...

我正在使用 swagger 规范使用 swagger-codegen 和 JAXRS 生成服务器端代码。

现在，我想为我的 API 获取一组示例输入作为 json 文件，并在我点击我的 API 时通过读取这些值来响应这些输入。我还想使用 slf4j 在服务器提示符上记录这些响应。

有人可以给我点参考吗？

我想使用 swagger-codegen maven 插件为我的 API 生成 JAX-RS 服务器存根，但我想使用我自己的服务实现类，而不是生成的那个。有没有办法生成除此类之外的所有内容？对于我的 API，该工具会生成四个 API 类：ProfilesApi、ProfilesApiService、ProfilesApiServiceFactory 和 ProfilesApiServiceImpl。

我当前的 Maven 配置：

我有这个大摇大摆的定义

但它给了我以下错误

✖ Swagger 错误不是有效的参数定义跳转到第 6996 行详细信息对象代码：“ONE_OF_MISSING”参数：数组 [0] 消息：“无效的参数定义”路径：数组 [5] schemaId：“ http://swagger.io /v2/schema.json# “内部：数组 [2] 级别：900 类型：“Swagger 错误”描述：“不是有效的参数定义”行号：6996

我用 C# 编写了许多 API，并使用 Swashbuckle 创建了一个“Swagger”文档网站。

对于验证 REST 调用，我在标头中使用 API 密钥。

我创建了一个页面，允许下载任何编程语言的特定客户端，如下所述：https ://generator.swagger.io

我想让用户能够使用他自己的 API 密钥生成客户端，这样他就不需要再在代码中手动设置 API 密钥了。

在我的 Swagger JSON 中，我有这个安全定义：

在 Swagger Client Generator 的页面中，我找到了允许设置客户端选项的模型，但我找不到 API 密钥如何（以及是否）可以在客户端代码中硬编码（或任何其他类型的授权）。

我想我必须设置 AuthorizationValue 对象，但没有关于它的文档（或者我找不到它）。

能够让生成的客户端库向所有请求添加任意 HTTP 标头就足够了。

在这种情况下，我们可以让它添加：

有人有想法吗？

非常感谢！

这是一个swagger-codegen-maven-plugin描述。目的是invokerPackage什么？它与 有何不同apiPackage？

我在这里留下了一个未解决的问题

我正在尝试创建一个自定义代码生成，我设法通过将文件放入代码生成项目中来使其工作，但我希望它像这样工作：https ://github.com/swagger-api/swagger-codegen#制作你自己的代码生成模块

我根本没有修改自动生成的项目，但我不断得到：

这是命令行：

我从这里得到了罐子https://mvnrepository.com/artifact/io.swagger/swagger-codegen-project/2.1.6 这就是我正在做的事情：

1. 运行 java -jar swagger-codegen-cli-2.1.6.jar meta \ -o output/myLibrary -n myClientCodegen -p com.my.company.codegen 创建服装代码生成器

2. mvn package在输出/myLibrary 中运行

3. java -cp output/myLibrary/target/myCustomCodegen-swagger-codegen-1.0.0.jar:swagger-codegen-cli-2.1.6.jar io.swagger.codegen.SwaggerCodegen generate -i https://watson-api-explorer.mybluemix.net/listings/conversation-v1-experimental.json -l com.my.company.codegen.Mycustomcodegengenerator -o outputlocation在包含 swagger-codege-cli-2.1.6.jar 和输出文件夹的文件夹中运行

如果我删除第一部分，它确实找到了类，但没有找到新语言：

我已经查看了“错误：无法找到或加载主类”问题的答案，但没有设法修复它。

这是jar的链接