Swagger UI和Swagger CodeGen有什么不同？

Question

Swagger UI和Swagger CodeGen有什么不同？

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

Answer 1

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

Swagger UI是一个文档渲染器，基本上是一个超文本标记语言页面。您将其指向一个OpenAPI定义(YAML或JSON文件)，Swagger UI就会生成看起来像like this的文档。你可以把它放在你的网站上。

Swagger Editor是一个编辑器，您可以在其中手动编写OpenAPI定义，或者加载/粘贴任意OpenAPI定义以检查语法错误。Swagger Editor还集成了Swagger Codegen，可通过"Generate Server“和"Generate Client”菜单访问。

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