问题标签 [swagger-codegen]

我在一个项目中使用 swagger 和 Feign，swagger 将采用带@RequestMapping注释的方法并创建文档。@FeightClient但是对于同时使用和注释的类和方法，这样做很奇怪@RequestMapping。那么如何大摇大摆地忽略这些api呢？哪个类的招摇做扫描工作，以便我可以学习并添加一些其他类来忽略这些由注释的 api @FeightClient？

我正在使用 swagger-codegen-2.1.6 并使用 serializableModel configOptions 通过 swagger-codegen-maven-plugin 成功生成序列化模型类。但是，我没有看到将 serialVersionUID 添加到类中，也找不到包含它的任何文档。任何帮助，将不胜感激。提前致谢。

我使用 Swagger 生成客户端存根（调用 API），这部分很好。当我尝试在组件中导入类时出现错误Module has no member of ...

在上述声明中出错。

web-api-client.ts（由 Swagger 生成的文件）具有 CollaborationClient 如下

我们的项目对单个 API 使用多个 swagger 文件，但似乎 swagger-codegen 只接受一个。在这种情况下，我们如何使用 swagger-codegen 生成代码？

java对象的swagger代码生成是否应该处理继承？

我已经在 ApiModel 注释中使用 subTypes 和鉴别器注释了我的对象，然后运行了 swagger code gen，我现在得到了所有类，但它们之间没有继承。

有没有人有这个工作的例子？

几个月来我一直在寻找漂亮的 swagger 到 HTML 转换器，但我似乎找不到任何会生成类似于 Strava API 参考的东西（https://strava.github.io/api/ v3/routes/#list）或 Paypal API 参考（https://developer.paypal.com/docs/api/payments.billing-plans#plan_create）。

他们不是唯一一个使用这个模板的人，所以我猜它是一个 HTML 生成器，我只是无法用我的谷歌搜索技能找到它。有人知道如何在不自己编码的情况下生成看起来像这样的文档吗？

我正在尝试为使用 Jersey 的 REST API 项目之一配置 Swagger。我遵循了为 Jersey-2 配置 swagger 的文档。

文档指出，成功配置后，应该能够在应用程序的上下文根目录中看到 swagger.json 和 swagger.yaml。但是我收到一个 404 错误，所以很困惑这里缺少什么。

pom.xml

Web.xml

应用程序部署在 tomcat 中，我能够获得 REST 响应

但是为以下请求获取状态 4​​04。

无法弄清楚配置中缺少什么。我是 Swagger 的新手。任何帮助深表感谢。

我正在使用 Swagger 2.0 和 swagger-codegen（实际上是 Maven 的 swagger-codegen-plugin）来指定、记录和生成 API，以 Java 作为目标语言。

该项目已设置为构建服务器存根 (JAX-RS) 和文档，Eclipse 可以识别项目 buildPath 中生成的代码。

我不确定这里的正确工作流程是什么。：-/

我认为我不应该修改生成的类，否则每当我更改 swagger 规范时，我的更改都会被覆盖，我希望随着开发的进行，随着我对 API 的更多思考，它会发生变化。

那我该怎么办？从生成的类（哪些？）继承或将它们包含在我自己的类中？

我正在使用 Spring Boot 实现 swagger 2。使用依赖项-

它运作良好。但是希望以一种在生产中不会部署 swagger 的方式来实现 swagger。是否可以将 swagger 构建与不同主机上的应用程序构建不同？

我在一个项目上玩 swagger-codegen，最后我问自己一个问题：swagger 文件的位置有什么约定吗？

这是我的情况：
我在我的项目中使用 Maven，所以我有标准的 Maven 结构：

为了使我的 REST API 使用 Swagger 生成，我必须将 swagger.json、一些小胡子模板和 .swagger-codegen-ignore 放在某处。我已经把它们（自然地？）放在 src/main/resources 中：

我已经使用正确的 swagger-codegen-maven-plugin 配置了我的 pom.xml，并将打包设置为 war，以便生成我的 war（以便将其部署在 Tomcat 中）。提取物：

在mvn install我的大摇大摆生成的文件生成并成功编译后，战争就会生成并且工作正常。
但是，在生成的战争中，在 WEB-INF/classes 文件夹中，我找到了我的 api 和 swaggerconfig 文件夹，以及 .swagger-codegen-ignore。好吧，这是正常的，因为它们被打包在 src/main/resources 中。

长话短说：我应该把这些文件放在别处吗（比如 src/main/swagger 以便 Maven 默认找到它们）？我是否应该在 maven-war-plugin 中编写一些包含/排除规则（但我觉得这不是一个好习惯）？我在 swagger Github 上没有找到明确的文档。

谢谢