javascript - Swagger-Codegen:如何将所有文件合并到一个文件中以进行客户端代码生成

Question

我刚刚开始使用 Swagger 和 NodeJS。我能够将 Swagger 实现到我的 NodeExpress 应用程序，并且还能够准确地使用 Swagger-Codegen(Typescript-Angular)生成 typescript-client-code。

我遇到的一个问题是生成的代码分布在许多不同的文件中。我希望它只输出一个文件 api.ts，它包含 API 调用和接口(interface)/模型的所有内容。

我一直在寻找解决这个问题的方法，因为随着后端的增长，很难阅读和维护生成的客户端代码。

如有任何建议或指点，我们将不胜感激。

节日快乐!谢谢

编辑:几天来我一直在寻找这个问题的答案，但仍然没有找到。我目前正在使用 ASP.NET Core 开发一个项目，他们有 NSwag，它可以实现我想用 Node Swagger 实现的功能。

Answer 1

TL;博士

您可以将所有文件编译成一个*.ts 文件，如this post 所示。 .

持续集成方法

Swagger 代码生成器简化了维护，因为它允许您从持续集成的 Angular 进行思考。

您不应该担心代码审查或美学(因为它是机器生成的代码)，而应该担心:

• API 版本控制
• 函数、方法和类签名
• 文档

如果您使用的是 Jenkins 或 Ansible 等 CI 系统，您可以自动将库部署到 private NPM account (对于 JS 和 TS)或 Maven server (对于 Java 和 Kotlin)。

保持包版本号持续更新将使 IDE 能够正确提示用户有关 API 的更新。