Swagger UI 与 Swagger CodeGen 之间有什么区别？

Question

我阅读了https://swagger.io/tools/ 中的描述。听起来 Swagger Editor、UI 和 codeGen 是完全不同的工具。如果我想生成 .Net 服务器存根并将它们可视化，是否意味着我需要同时使用 UI 和 CodeGen？

Answer 1

是的，它们是用于不同目的的不同工具。

Swagger UI是一个文档渲染器，基本上是一个 HTML 页面。你把它指向一个OpenAPI的定义（YAML或JSON文件），扬鞭UI产生API文档，看起来像这样。您可以将其托管在您的网站上。

Swagger Editor是一个编辑器，您可以在其中手动编写 OpenAPI 定义，或加载/粘贴任意 OpenAPI 定义以检查它们是否存在语法错误。Swagger Editor 还集成了 Swagger Codegen，可通过“生成服务器”和“生成客户端”菜单访问。

Swagger Codegen是一个代码生成器。您可以使用它从 OpenAPI 定义生成服务器存根和客户端 SDK。例如，以下是使用 Swagger Codegen CLI 生成 ASP.NET 服务器存根的方法（为可读性添加了换行符）：

java -jar swagger-codegen-cli-3.0.21.jar generate
     -i https://petstore.swagger.io/v2/swagger.yaml
     -l aspnetcore
     -o .\aspnetcore-server