如何将 Swagger Codegen 与 .net 核心一起使用

Question

我能够使用 Swashbuckle 将 Swagger UI 集成到我的 Web api 中。我还想探索 swagger codegen 功能。有人可以帮忙 - 我如何将 swagger codegen 集成到我的 web api 项目中？还是我需要下载任何工具？我希望它能够托管 codegen 并传递 json/raml 表单规范以在 .net 核心中生成客户端。

我在上面找不到足够的文档。

编辑：我想知道如何在我的 WEBAPI 中托管 codegen。

谢谢！

Answer 1

现在，您可以使用Nswag。有几个代码生成器实用程序 - UI、控制台、msbuild。

Answer 2

您似乎只想从 API 的 OpenApi 规范（您的 Swagger 实现提供输入）生成 C#。

要从 API 的 OpenApi 规范文件生成代码（例如 C#），您可以执行以下操作：

java -jar .\openapi-generator-cli-5.0.0-beta3.jar generate -i https://localhost:xxxx/api/v1/swagger.json -g csharp

您必须下载 OpenApi Generator Jar。或者，您可以将代码上传到 Web 生成器。但我总是会在本地运行它；你永远不知道你的代码在哪里结束。

Answer 3

您应该通过右键单击您的项目并单击管理 nuget 包来安装“Swashbuckle.AspNetCore.Swagger”nuget 包。

然后您应该将这些代码添加到您的项目启动位置，例如。 Program.cs

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();

    // Register the Swagger generator, defining one or more Swagger documents
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new Info { Title = "My API", Version = "v1" });
    });
}

public void Configure(IApplicationBuilder app)
{
    // Enable middleware to serve generated Swagger as a JSON endpoint.
    app.UseSwagger();

    app.UseMvc();
}