Swagger UI和Swagger CodeGen有什么区别？

Question

Swagger UI和Swagger CodeGen有什么区别?

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

- Cloe

Answer 1

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

Swagger UI 是一个文档渲染器，基本上是一个 HTML 页面。您将其指向一个 OpenAPI 定义（YAML 或 JSON 文件），Swagger 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

- Helen