1.异步调用 Web 服务
static void Main(string[] args)
{
Console.WriteLine("In main before call to GetData!");
GetData();
Console.WriteLine("Back in main after call to GetData!");
Console.ReadKey();
}
private static async void GetData()
{
HttpClient httpClient = new HttpClient();
HttpResponseMessage response = null;
response = await httpClient.GetAsync("http://services.odata.org/Northwind/Northwind.svc/Regions");
if (response.IsSuccessStatusCode)
{
Console.WriteLine("Response Status Code and Reason Phrase: " + response.StatusCode + " " + response.ReasonPhrase);
string responseBodyAsText = response.Content.ReadAsStringAsync().Result;
Console.WriteLine("Received payload of " + responseBodyAsText.Length + " characters");
//Console.WriteLine(responseBodyAsText);
}
}
来看看下面方法解释:
因为 HttpClient 使用 GetAsync 方法调用,且使用了 await,所以 Main 方法输出到屏幕的消息先显示,而 GetData
调用中的数据后显示。
对 GetAsync 返回一个 HttpResponseMessage
对象。表示包含的标题、状态和内容的响应。检查响应的 IsSuccessStatusCode
属性,可以确定请求是否成功。
2.标题
HttpClient 的 DefaultRequestHeaders
属性允许设置或改变标题。使用 Add
可以给集合添加标题。下面意义相同。
//httpClient.DefaultRequestHeaders.Add("Accept", "application/json");
httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
标题和标题值会与这个 HttpClient 实例发送的每个请求一起发送。
下面的例子说明了如何在响应和请求中遍历标题。
static void Main(string[] args)
{
GetData();
Console.ReadKey();
}
private static void GetData()
{
HttpClient httpClient = new HttpClient();
HttpResponseMessage response = null;
httpClient.DefaultRequestHeaders.Add("Accept", "application/json;odata=verbose");
Console.WriteLine("Request Headers:");
//请求的标题
EnumerateHeaders(httpClient.DefaultRequestHeaders);
Console.WriteLine();
response = httpClient.GetAsync("http://services.odata.org/Northwind/Northwind.svc/Regions").Result;
if (response.IsSuccessStatusCode)
{
Console.WriteLine("Response Headers:");
EnumerateHeaders(response.Headers); //结尾的标题
}
}
-
HttpHeaders
是HttpRequestHeaders
和HttpResponseHeaders
的基类。 -
HttpHeaders
对象定义的为KeyValuePair<string, IEnumerable<string>>
。这表示每个标题在集合中都可以有多个值。因此要改变标题中的值,就需要先删除原来的值,添加新值。
private static void EnumerateHeaders(HttpHeaders headers)
{
foreach (var header in headers)
{
var value = "";
foreach (var val in header.Value)
{
value = val + " ";
}
Console.WriteLine("Header: " + header.Key + " Value: " + value);
}
}
因为标题值可以有多个,标题值部分也必须迭代,所以在循环内部还有一个循环,来枚举所有找到的值。
3.HttpContent
响应中的 Content
属性返回一个 HttpContent
对象。例子中使用 ReadAsStringAsync
返回内容的字符串表示。顾名思义,这是一个异步调用,但这个例子没使用异步调用功能。调用 Result 会阻塞该调用,直到 ReadAsStringAsync 方法执行完毕。
var client = new HttpClient();
//GetAsync 方法也接受一个 CancellationToken
HttpResponseMessage response = await client.GetAsync("http://www.baidu.com");
response.EnsureSuccessStatusCode();
string html = await response.Content.ReadAsStringAsync();
Console.WriteLine(html);
其他从 HttpContent
对象获取数据的方法有 ReadAsByteArrayAsync
(返回数据的字节数组)和 ReadAsStreamAsync
(返回一个流)。也可以使用 LoadIntoBufferAsync
把内容加载到内存缓存中。
Headers
属性返回 HttpCotentHeaders
对象。它工作方式与前面例子的请求和响应标题相同。
4.HttpMessageHandler
- 作为 HttpClient 构造函数的参数,就可以定制请求。
- 默认使用
WebRequestHandler
对象。 - 有许多属性可以设置 ClientCertificates、Pipelining、CachePolity、ImpersonationLevel 等。
class Program
{
static void Main(string[] args)
{
GetData();
Console.ReadKey();
}
private static void GetData()
{
HttpClient httpClient = new HttpClient(new MessageHandler("error"));
HttpResponseMessage response = null;
Console.WriteLine();
response = httpClient.GetAsync("http://services.odata.org/Northwind/Northwind.svc/Regions").Result;
Console.WriteLine(response.StatusCode);
}
}
public class MessageHandler : HttpClientHandler //HttpClientHandler 继承自 HttpMessageHandler
{
string displayMessage = "";
public MessageHandler(string message)
{
displayMessage = message;
}
protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, System.Threading.CancellationToken cancellationToken)
{
Console.WriteLine("In DisplayMessageHandler " + displayMessage);
if (displayMessage == "error")
{
var response = new HttpResponseMessage(System.Net.HttpStatusCode.BadRequest); //创建要返回的响应 把状态设置为 BadRequest
var tsc = new TaskCompletionSource<HttpResponseMessage>();
tsc.SetResult(response); //注意响应在 HttpResponseMessage 任务中 SetResult 方法设置
return tsc.Task;
}
return base.SendAsync(request, cancellationToken);
}
}
检查 displayMessage ,是否为“error”。如果是,就创建要返回的响应,把状态设为 BadRequest
。接下来只创建了要返回的 Task
。注意响应在 HttpResponseMessage
任务中通过 SetResult
方法设置。
添加定制处理器程序有很多理由。设置处理程序管道,是为添加多个处理程序。除了默认的处理程序外,还有 DelegatingHandler
,它执行一些代码,再把调用委托给内部或下一个处理程序。 HttpClientHandler
是最后一个处理程序,它把请求发送到地址。
每个添加的 DelegatingHandler
都调用下一个或内部的处理程序,最后一个是基于 HttpClientHandler
处理程序。