前言
當(dāng)下編寫應(yīng)用程序都流行前后端分離,后端提供對(duì)應(yīng)服務(wù)接口給前端或跨應(yīng)用程序調(diào)用,如WebAPI等。在調(diào)用這些服務(wù)接口發(fā)送HTTP請(qǐng)求,而.NET為我們提供了HttpWebRequest、HttpClient幾個(gè)類庫來實(shí)現(xiàn)。下面對(duì)C#使用HttpClient類發(fā)送HTTP請(qǐng)求數(shù)據(jù)的幾種格式。
HttpClient
HttpClient是.NET 4.5以上版提供的類(System.Net.Http),編寫的應(yīng)用程序可以通過此類發(fā)送HTTP請(qǐng)求并從WEB服務(wù)公開的資源接收HTTP響應(yīng)。HTTP請(qǐng)求包含了請(qǐng)求報(bào)文與響應(yīng)報(bào)文。下面先簡(jiǎn)單的了解它的一些屬性與方法。屬性 | 描述 |
---|
BaseAddress | 獲取或設(shè)置發(fā)送請(qǐng)求時(shí)地址。 |
DefaultProxy | 獲取或設(shè)置全局HTTP請(qǐng)求代理。 |
DefaultRequestHeaders | 獲取請(qǐng)求發(fā)送的標(biāo)題。 |
DefaultRequestVersion | 獲取或設(shè)置請(qǐng)求使用的默認(rèn)HTTP版本。 |
MaxResponseContentBufferSize | 獲取或設(shè)置讀取響應(yīng)內(nèi)容時(shí)要緩沖的最大字節(jié)數(shù)。 |
Timeout | 獲取或設(shè)置請(qǐng)求超時(shí)等待的時(shí)間。 |
方法 | 描述 |
---|
GetAsync | 異步請(qǐng)求獲取指定URI。 |
GetByteArrayAsync | 異步請(qǐng)求獲取指定URI并以字節(jié)數(shù)組的形式返回響應(yīng)。 |
GetStreamAsync | 異步請(qǐng)求獲取指定URI并以流的形式返回響應(yīng)。 |
GetStringAsync | 異步請(qǐng)求獲取指定URI并以字符串的形式返回響應(yīng)正文。 |
PostAsync | 異步將POST請(qǐng)求發(fā)送給指定URI。 |
Send | 發(fā)送帶有指定請(qǐng)求的 HTTP 請(qǐng)求。 |
SendAsync | 以異步操作發(fā)送 HTTP 請(qǐng)求。 |
數(shù)據(jù)格式
在向HTTP發(fā)起請(qǐng)求時(shí),將以什么樣的數(shù)據(jù)格式發(fā)送數(shù)據(jù),這取決于URI服務(wù)資源。而常用的類型可分為application/json、application/x-www-form-urlencoded, multipart/form-data, text/xml,其中application/json 是近年來最常用的一種。下面簡(jiǎn)單介紹每種格式。
JSON數(shù)據(jù)格式
application/json 通常是HttpClient發(fā)送JSON格式的數(shù)據(jù),通過使用HttpContent的StringContent并設(shè)置其MediaType為"application/json"。using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace Fountain.WinConsole.HttpDemo
{
internal class Program
{
static async Task Main(string[] args)
{
try
{
using (HttpClient httpClient = new HttpClient())
{
User user = new User();
user.username = "test";
user.password = "123456";
string jsonData = JsonConvert.SerializeObject(user);
// 發(fā)送請(qǐng)求數(shù)據(jù)包
StringContent content = new StringContent(jsonData, Encoding.UTF8);
// 設(shè)置HTTP 響應(yīng)上的ContentType --application/json
content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
// 請(qǐng)求訪問地址
string url = "https://127.0.0.1/api/user/login";
// 發(fā)出HTTP的Post請(qǐng)求
HttpResponseMessage response = await httpClient.PostAsync(url, content);
// 讀取返回結(jié)果
string responseContent = await response.Content.ReadAsStringAsync();
// 將字符轉(zhuǎn)對(duì)象
Result result = JsonConvert.DeserializeObject<Result>(responseContent);
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
Console.ReadLine();
}
}
}
表單數(shù)據(jù)格式
application/x-www-form-urlencoded 這種格式通常用于表單數(shù)據(jù)的提交,通過使用HttpContent的FormUrlEncodedContent 類定義實(shí)現(xiàn)。using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace Fountain.WinConsole.HttpDemo
{
internal class Program
{
static async Task Main(string[] args)
{
try
{
using (HttpClient httpClient = new HttpClient())
{
Dictionary<string,string> user = new Dictionary<string, string>
{
{ "username", "test" },
{ "password", "123456" }
};
// 發(fā)送請(qǐng)求數(shù)據(jù)包
FormUrlEncodedContent content = new FormUrlEncodedContent(user);
// 請(qǐng)求訪問地址
string url = "https://127.0.0.1/api/user/login";
// 發(fā)出HTTP的Post請(qǐng)求
HttpResponseMessage response = await httpClient.PostAsync(url, content);
// 讀取返回結(jié)果
string responseContent = await response.Content.ReadAsStringAsync();
// 將字符轉(zhuǎn)對(duì)象
Result result = JsonConvert.DeserializeObject<Result>(responseContent);
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
Console.ReadLine();
}
}
}
文件上傳格式
multipart/form-data 常用于文件上傳的數(shù)據(jù)格式,通過用MultipartFormDataContent類定義實(shí)現(xiàn)。using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace Fountain.WinConsole.HttpDemo
{
internal class Program
{
static async Task Main(string[] args)
{
try
{
using (HttpClient httpClient = new HttpClient())
{
MultipartFormDataContent multipartContent = new MultipartFormDataContent();
multipartContent.Add(new StringContent("user"), "test");
multipartContent.Add(new ByteArrayContent(File.ReadAllBytes(string.Format("{0}{1}", AppDomain.CurrentDomain.BaseDirectory, "test.jpg"))), "image", "test.jpg");
// 請(qǐng)求訪問地址
string url = "https://127.0.0.1/api/user/upload";
// 發(fā)出HTTP的Post請(qǐng)求
HttpResponseMessage response = await httpClient.PostAsync(url, multipartContent);
// 讀取返回結(jié)果
string responseContent = await response.Content.ReadAsStringAsync();
// 將字符轉(zhuǎn)對(duì)象
Result result = JsonConvert.DeserializeObject<Result>(responseContent);
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
Console.ReadLine();
}
}
}
XML數(shù)據(jù)格式
text/xml 主要用于傳輸XML格式的數(shù)據(jù),通過使用HttpContent 中的StringContent并設(shè)置其MediaType為"text/xml"。using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace Fountain.WinConsole.HttpDemo
{
internal class Program
{
static async Task Main(string[] args)
{
try
{
using (HttpClient httpClient = new HttpClient())
{
StringBuilder user = new StringBuilder();
user.AppendLine("<usrname>test</usrname>");
user.AppendLine("<password>test123456</password>");
string xmlData = user.ToString();
// 發(fā)送請(qǐng)求數(shù)據(jù)包
StringContent content = new StringContent(xmlData, Encoding.UTF8);
// 設(shè)置HTTP 響應(yīng)上的ContentType --text/xml
content.Headers.ContentType = new MediaTypeHeaderValue("text/xml");
// 請(qǐng)求訪問地址
string url = "https://127.0.0.1/api/user/login";
// 發(fā)出HTTP的Post請(qǐng)求
HttpResponseMessage response = await httpClient.PostAsync(url, content);
// 讀取返回結(jié)果
string responseContent = await response.Content.ReadAsStringAsync();
// 將字符轉(zhuǎn)對(duì)象
Result result = JsonConvert.DeserializeObject<Result>(responseContent);
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
Console.ReadLine();
}
}
}
小結(jié)
以上是C#在使用HttpClient類發(fā)起 HTTP 的Post請(qǐng)求時(shí),使用四種數(shù)據(jù)格式的方式。希望對(duì)各位有所幫助。如有不到之處,請(qǐng)多多包涵。
該文章在 2024/6/8 18:15:51 編輯過