REST 是由 Representational State Transfer 這三個(gè)單詞前綴合成吊圾，這種架構(gòu)風(fēng)格在前幾年特別流行达椰，Restful API 的行為規(guī)范可以參考: https://docs.microsoft.com/en-us/azure/architecture/best-practices/api-design ，通常 RESTful API 返回的格式為常見的 PlianText项乒， JSON 啰劲， XML 格式。

RestSharp 是一個(gè)開源的 Http 客戶端類庫板丽，非常方便和 RESTful 格式的 Service 進(jìn)行交互,????的是呈枉，這個(gè)類庫封裝了 request 請求過程中復(fù)雜的細(xì)節(jié)，而且 RestSharp 支持同步和異步兩種請求模式埃碱。

這篇文章將會討論如何使用 RestSharp 去請求 Asp.NET Core 服務(wù)猖辫。

實(shí)現(xiàn) DefaultController

打開 DefaultController.cs 文件并用下面的代碼進(jìn)行替換。

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;

namespace RESTAPIDemo.Controllers
{
   [Route("api/[controller]")]
   [ApiController]
   public class DefaultController : ControllerBase
   {
       private readonly Dictionary<int, string> authors = new Dictionary<int, string>();
       public DefaultController()
       {
           authors.Add(1, "Joydip Kanjilal");
           authors.Add(2, "Steve Smith");
           authors.Add(3, "Michele Smith");
       }

       [HttpGet]
       public List<string> Get()
       {
           List<string> lstAuthors = new List<string>();
           foreach (KeyValuePair<int,string> keyValuePair in authors)
               lstAuthors.Add(keyValuePair.Value);
           return lstAuthors;
       }

       [HttpGet("{id}", Name = "Get")]
       public string Get(int id)
       {
           return authors[id];
       }

       [HttpPost]
       public void Post([FromBody] string value)
       {
           authors.Add(4, value);
       }

       [HttpPut("{id}")]
       public void Put(int id, [FromBody] string value)
       {
           authors[id] = value;
       }

       [HttpDelete("{id}")]
       public void Delete(int id)
       {
           authors.Remove(id);
       }
   }
}

image.gif

參考上面的 DefaultController 類砚殿，可以發(fā)現(xiàn) Action 方法的名字對應(yīng)著 Http 動詞的 GET,POST,PUT 和 DELETE啃憎，為了簡單起見，我使用了 Dictionary 來存取數(shù)據(jù)似炎，你可以用 瀏覽器 或者 Postman 或者 Fiddler 進(jìn)行測試辛萍，請注意，這里為了方便羡藐，我在 Post 方法中使用了硬編碼贩毕，實(shí)際場景中你可以用自己的方式生成唯一ID。

接下來的章節(jié)我們將會學(xué)習(xí)如何使用 RestSharp 去調(diào)用剛才構(gòu)建的 API 接口仆嗦。

安裝 RestSharp

要想使用 RestSharp辉阶，你可以使用 Visual Studio 2019 中的 NuGet package manager 可視化界面進(jìn)行安裝，或者通過 NuGet package manager console 命令行輸入如下命令：

Install-Package RestSharp

image.gif

使用 RestSharp 調(diào)用 ASP.NET Core API

一旦 RestSharp 成功引用到項(xiàng)目之后，就可以使用它了谆甜，首先, 你需要創(chuàng)建 RestClient 實(shí)例垃僚，下面的代碼展示了如何對 RestClient 進(jìn)行實(shí)例化和初始化操作，要注意的是構(gòu)造函數(shù)中的 url 配置的是 基址规辱，言外之意這不是完整的url谆棺。

RestClient client = new RestClient("http://localhost:58179/api/");

image.gif

接下來，你可以傳遞 資源名 和 請求方式 兩個(gè)參數(shù)來實(shí)例化 RestRequest 對象罕袋，下面的代碼展示了如何實(shí)現(xiàn)改淑。

RestRequest request = new RestRequest("Default", Method.GET);

image.gif

最后，你可以執(zhí)行 request 請求炫贤，再將返回的結(jié)果序列化溅固， 最后用一個(gè)合適的對象接收，就像下面代碼一樣兰珍。

IRestResponse<List<string>> response = client.Execute<List<string>>(request);

image.gif

下面是完整的可供參考的代碼清單侍郭。

using RestSharp;
using System;
using System.Collections.Generic;
namespace RESTSharpClientDemo
{
    class Program
    {
        private static RestClient client = new RestClient("http://localhost:58179/api/");

        static void Main(string[] args)
        {
            RestRequest request = new RestRequest("Default",Method.GET);
            IRestResponse<List<string>> response = client.Execute<List<string>>(request);
            Console.ReadKey();
        }
    }
}

image.gif

如果想使用 RestSharp 發(fā)送 POST 請求，可以使用如下代碼掠河。

RestRequest request = new RestRequest("Default", Method.POST);
request.AddJsonBody("Robert Michael");
var response = client.Execute(request);

image.gif

RestSharp 可以跨多個(gè) .NET 平臺使用亮元，比如說：Momo，Xarmain唠摹，Blazer 等等爆捞，這也是它為什么非常流行的原因，而且 RestSharp 支持通過泛型方式獲取結(jié)果勾拉，這個(gè)特性特別 ????煮甥，想了解更多 RestSharp 知識，可參考 Github：https://github.com/restsharp/RestSharp