如何使用程序調用webApi接口

如何使用程序調用webApi接口

在C#中,傳統調用HTTP接口通常有兩種辦法:html

  • WebRequest/WebResponse組合的方法調用
  • WebClient類進行調用。

第一種方法抽象程度較低,使用較爲繁瑣;而WebClient主要面向了WEB網頁場景,在模擬Web操做時使用較爲方便,但用在RestFul場景下卻比較麻煩,在Web API發佈的同時,.NET提供了兩個程序集:System.Net.HttpSystem.Net.Http.Formatting。這兩個程序集中最核心的類是HttpClient。在.NET4.5中帶有這兩個程序集,而.NET4須要到Nuget裏下載Microsoft.Net.Http和Microsoft.AspNet.WebApi.Client這兩個包才能使用這個類,更低的.NET版本就只能表示遺憾了只能用WebRequest/WebResponse或者WebClient來調用這些API了。web

在使用中,System.Net.Http這個程序集提供了HttpClient類以及相關的HTTP調用,而System.Net.Http.Formatting提供了一些針對HttpClient的幫助擴展,更好地支持了內容協商、Content建立等功能。下面我就和你們一塊兒寫一下這個例子:json

public class Person

    {

        public long Id { get; set; }

        public string Name { get; set; }

 

        public int Age { get; set; }

 

        public string Sex { get; set; }

 

        public override string ToString() {

            return $"Id={Id} Name={Name} Age={Age} Sex={Sex}";

        }

    }
class Program

   {

       static void Main(string[] args) {

           var client = new HttpClient();
           //基本的API URL
           client.BaseAddress = new Uri("http://localhost:22658/");
           //默認但願響應使用Json序列化(內容協商機制,我接受json格式的數據)
           client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); 
           //運行client接收程序
           Run(client);
           Console.ReadLine();
       }
       //client接收處理(都是異步的處理)
       static async void Run(HttpClient client) {
           //post 請求插入數據
           var result = await AddPerson(client);
           Console.WriteLine($"添加結果:{result}"); //添加結果:true
           
           //get 獲取數據
           var person = await GetPerson(client);
           //查詢結果:Id=1 Name=test Age=10 Sex=F
           Console.WriteLine($"查詢結果:{person}"); 

           //put 更新數據
           result = await PutPerson(client);
           //更新結果:true
           Console.WriteLine($"更新結果:{result}"); 

           //delete 刪除數據
           result = await DeletePerson(client);
           //刪除結果:true
           Console.WriteLine($"刪除結果:{result}"); 
       }
       
       //post
       static async Task<bool> AddPerson(HttpClient client) {
           //向Person發送POST請求,Body使用Json進行序列化
           return await client.PostAsJsonAsync("api/Person", new Person() { Age = 10, Id = 1, Name = "test", Sex = "F" }) 
                               //返回請求是否執行成功,即HTTP Code是否爲2XX
                               .ContinueWith(x => x.Result.IsSuccessStatusCode);  
       }
       
       //get
       static async Task<Person> GetPerson(HttpClient client) {
           //向Person發送GET請求
           return await await client.GetAsync("api/Person/1") 
           //獲取返回Body,並根據返回的Content-Type自動匹配格式化器反序列化Body內容爲對象
                                    .ContinueWith(x => x.Result.Content.ReadAsAsync<Person>(                             
                   new List<MediaTypeFormatter>() {new JsonMediaTypeFormatter()/*這是Json的格式化器*/
                                                   ,new XmlMediaTypeFormatter()/*這是XML的格式化器*/}));
       }
       
       //put
       static async Task<bool> PutPerson(HttpClient client) {
           //向Person發送PUT請求,Body使用Json進行序列化
           return await client.PutAsJsonAsync("api/Person/1", new Person() { Age = 10, Id = 1, Name = "test1Change", Sex = "F" }) 
                               .ContinueWith(x => x.Result.IsSuccessStatusCode);  //返回請求是否執行成功,即HTTP Code是否爲2XX
       }
       //delete
       static async Task<bool> DeletePerson(HttpClient client) {
           return await client.DeleteAsync("api/Person/1") //向Person發送DELETE請求
                              .ContinueWith(x => x.Result.IsSuccessStatusCode); //返回請求是否執行成功,即HTTP Code是否爲2XX
       }

}

這就完成了這組API的調用,是否是很是簡單方便?HTTPClient使用全異步的方法,而且他有良好的擴展性,我會在以後的博客中再聊這個問題。c#

OK,到此爲止一組簡單的Restful API和C#的調用客戶端就完成了,但這只是開始,Web API是一個很強大的框架,他的擴展點很是豐富,這些擴展能爲咱們的開發提供不少的幫助,下一篇博文我將爲你們帶來WEB API中Filter的使用。api

相關文章
相關標籤/搜索