在我們使用微服務(wù)的時(shí)候，各個(gè)微服務(wù)之間會(huì)經(jīng)常調(diào)用接口，但是手動(dòng)寫(xiě)Http請(qǐng)求的代碼非常繁瑣，在 Visual Studio 2019 的 .NET Core 項(xiàng)目中提供了添加連接的服務(wù)的功能，使得我們的工作變得簡(jiǎn)單容易。

一、將 Swagger 引入 WebAPI 項(xiàng)目

將 Swagger 引入 ASP.NET Core 項(xiàng)目可以使用Swashbuckle 和 ASP.NET Core 入門(mén)這篇微軟官方文檔。

創(chuàng)建一個(gè) ASP.NET Core Web API 服務(wù)
執(zhí)行以下命令引入對(duì)應(yīng)的包：

	Install-Package Swashbuckle.AspNetCore -Version 5.6.3

將 Swagger 生成器添加到 Startup.ConfigureServices 方法中的服務(wù)集合中：

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddSwaggerGen();
    }

在 Startup.Configure 方法中，啟用中間件為生成的 JSON 文檔和 Swagger UI 提供服務(wù)：

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"));
        app.UseRouting();
        app.UseEndpoints(endpoints => endpoints.MapControllers());
    }

配置完成后啟動(dòng)項(xiàng)目訪問(wèn) Swagger 頁(yè)面，

點(diǎn)擊頁(yè)面上的 /swagger/v1/swagger.json 即可跳轉(zhuǎn)到我們的URL，

例如我這里的是：http://localhost:5000/swagger/v1/swagger.json

二、添加 OpenAPI 服務(wù)引用

在解決方案中另新建一個(gè)項(xiàng)目 .NET Core 的項(xiàng)目，我這里新建的是控制臺(tái)項(xiàng)目。

在項(xiàng)目中右鍵點(diǎn)擊依賴項(xiàng)，選擇添加連接的服務(wù) ，

在出現(xiàn)的新選項(xiàng)卡中的服務(wù)引用(OpenAPI, gRPC) 中點(diǎn)擊添加按鈕。

然后選擇 OpenAPI 點(diǎn)擊下一步，

重新啟動(dòng)步驟一中的 WebAPI 項(xiàng)目，

選擇URL并填入先前的 Swagger 描述文件URL

http://localhost:5000/swagger/v1/swagger.json，點(diǎn)擊完成等待完成即可。

（如果將swagger.json下載后，在這里使用文件也是可行的）

添加后項(xiàng)目中多了一個(gè) ~/OpenAPIs/swagger.json 文件。
然后即可在代碼中直接調(diào)用接口：

    static async Task Main(string[] args)
    {
        var http = new HttpClient();
        var client = new swaggerClient("http://localhost:5000/", http);
        var result = await client.WeatherForecastAsync();
        foreach (var item in result)
        {
            Console.WriteLine($"{item.Date}, {item.TemperatureF}, {item.Summary}");
        }
    
        Console.WriteLine("Hello World!");
    }

對(duì)于已配置的服務(wù)引用由于已經(jīng)更改需要進(jìn)行更新，則直接在更多列表中的刷新選項(xiàng)即可。