Swagger Codegen：如何将所有文件合并为一个文件以生成客户端代码

Question

我刚刚开始使用Swagger和NodeJS。我能够在我的NodeExpress应用程序中实现Swagger，并且还能够准确地使用Swagger-Codesen（Typecript-Angular）生成typecript-client-code。

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

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

任何建议或指点将不胜感激。

节日快乐！谢谢

编辑：我已经为此寻找了几天的答案，但仍然没有找到。我目前正在使用ASP. NET Core进行一个项目，他们有NSwag，它可以完成我想通过Node Swagger实现的目标。




Answer 1

Swagger使用胡子模板生成代码。为了进行更简单的更改，您可以简单地创建一个内置模板的副本并对其进行修改。

然后您可以像这样使用修改后的模板：

swagger-codegen-cli generate -t path/to/template/dir/ -i spec.json

但是，输出目录结构不能仅使用模板进行更改。为此，您需要一个自定义代码模块。您可以创建自己的或修改其中一个内置模块。

Answer 2

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

Swagger code generator简化了维护，因为它允许您从持续集成的角度进行思考。

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

• API版本控制

如果您使用的是CI系统，例如Jenkins或Anable，您可以自动将库部署到私有NPM帐户（用于JS和TS）或Maven服务器（用于Java和静态编程语言）。

保持软件包版本号持续更新将允许IDE正确提示用户API更新。