Swagger UI和Swagger CodeGen有什么区别?
我在https://swagger.io/tools/上读到了描述。看起来Swagger Editor、UI和CodeGen是完全不同的工具。如果我想生成.Net服务器存根并可视化它们,这是否意味着我需要同时使用UI和CodeGen?
Swagger UI和Swagger CodeGen有什么区别?
我在https://swagger.io/tools/上读到了描述。看起来Swagger Editor、UI和CodeGen是完全不同的工具。如果我想生成.Net服务器存根并可视化它们,这是否意味着我需要同时使用UI和CodeGen?
是的,它们是不同的工具,用于不同的目的。
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