在C#中,傳統調用HTTP接口通常有兩種辦法:html
第一種方法抽象程度較低,使用較爲繁瑣;而WebClient主要面向了WEB網頁場景,在模擬Web操做時使用較爲方便,但用在RestFul場景下卻比較麻煩,在Web API發佈的同時,.NET提供了兩個程序集:
System.Net.Http
和System.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