c#进阶（6）—— 网络通信基础知识

1、HttpClient 类

(1)、HttpClient 类 用于发送HTTP 请求，接收请求的响应。

(2)、HttpClient 类 派生于 HttpMessageInvoker类，此基类负责执行 SendAsync(),SendAsync() 方法调用是异步的，可以编写一个完全异步的系统来调用Web服务。

2、实例

(1)、发出异步的Get 请求。

namespace InternetCommunicate
{
    class Program
    {
        private const string baiduUrl = "http://www.baidu.com.cn";
        private const string googleUrl = "http://www.google.com";

        static void Main(string[] args)
        {
        }

        /// <summary>
        /// 异步调用Get方法
        /// </summary>
        /// <returns></returns>
        public async Task GetDataSimpleAsync()
        {
            //实例化一个httpClient 对象，该对象是线程安全的,
            //client 对象可以处理多个请求，HttpClient 每个实例都维护自己的线程池，
            //HttpClient 实例之间的请求被隔离，调用Dispose方法释放资源。
            using (var client = new HttpClient())
            {
                //调用 GetAsync(),给他传递要调用的方法地址，把HTTP GET 请求发送给服务器，
                //GetAsync() 返回一个 HttpResponseMessage对象，包含
                //(1)、标题
                //(2)、状态
                //(3)、内容
                HttpResponseMessage response = await client.GetAsync(baiduUrl);
                //如果请求成功
                if(response.IsSuccessStatusCode)
                {
                    Console.WriteLine($"Response Status Code:{(int)response.StatusCode}" +
                        $"{response.ReasonPhrase}");
                    //通过ReadAsStringAsync方法，把返回的内容检索为一个字符串。
                    string responseBodyAsText = await response.Content.ReadAsStringAsync();
                    Console.WriteLine($"Received payLoad of {responseBodyAsText.Length} characters");
                    Console.WriteLine(responseBodyAsText);
                    Console.ReadLine();
                }
            }
        }
    }
}

 (3)、传递httpheader（标题）

发出请求时，没有设置或改变任何标题，但HttpClient 的DefaultRequestHeaders 属性允许设置或改变标题，使用Add 方法可以给集合添加标题，设置标题和标题值后，会与HttpClient 实例发送的每个请求一起发送。

在本示例中，添加以json作为格式的标题值。代码如下：

    /// <summary>
        /// 展示http 标题
        /// </summary>
        /// <param name="title"></param>
        /// <param name="httpHeaders"></param>
        public static void ShowHeaders(string title,HttpHeaders httpHeaders)
        {
            foreach (var header in httpHeaders)
            {
                string value = string.Join("  ", header.Value);
                Console.WriteLine($"Header:{header.Key} Value:{value}");
            }
        }

        /// <summary>
        /// 设置httpHeader 传递标题的信息
        /// </summary>
        /// <returns></returns>
        public async Task GetDataWithHeadersAsync()
        {
            try
            {
                using(var client = new HttpClient())
                {
                    //添加作为json数据格式的标题值
                    client.DefaultRequestHeaders.Add("Accept", "application/json;odata=verbose");
                    //DefaultRequestHeaders 获取与每个请求一起发送的值
                    ShowHeaders("Request Headers:", client.DefaultRequestHeaders);
                    //获取http 响应头的值
                    HttpResponseMessage response = await client.GetAsync(googleUrl);
                    ShowHeaders("Response Headers:", response.Headers);
                }
            }
            catch (Exception ex)
            {
                throw ex;
            }
        }

(4)、用HttpMessageHandler自定义请求

创建一个派生于HttpClientHandler的类，重写SendAsync()方法，该方法需要返回一个Task,对于错误的情况，不需要调用异步方法，只用Task.FromResult返回即可。

public class SampleMessageHandler:HttpClientHandler
    {
        private string _message;

        public SampleMessageHandler(string message)
        {
            _message = message;
        }

        protected override Task<HttpResponseMessage> SendAsync(
            HttpRequestMessage request,CancellationToken cancellationToken)
        {
            if(_message == "error")
            {
                var response = new HttpResponseMessage(HttpStatusCode.BadRequest);
                return Task.FromResult<HttpResponseMessage>(response); 
            }
            return base.SendAsync(request, cancellationToken);
        }
    }
        /// <summary>
        /// 用HttpMessageHandler自定义请求
        /// </summary>
        /// <returns></returns>
        public static async Task GetDataWithMessageHandlerAsync()
        {
            //如果消息是error，把响应的状态码设置为bad request
            var client = new HttpClient(new SampleMessageHandler("error"));
            HttpResponseMessage responseMessage = await client.GetAsync(googleUrl);
            //etc
        }

(5)、使用SendAsync 创建HttpRequestMessage

使用SendAsync，可以对定义请求有更多的控制，重载HttpRequestMessage类的构造函数，传递HttpMethod的一个值，GetAsync方法用Get方式创建一个HTTP请求。

使用HttpMethod 不仅可以发送GET、POST、PUT和DELETE 请求，还可以发送HEAD、OPTIONS和Trace。

具体代码如下：

        /// <summary>
        /// 使用SendAsync 创建HttpRequestMessage
        /// </summary>
        /// <returns></returns>
        private async Task GetDataAdvanceAsync()
        {
            using(var client = new HttpClient())
            {
                var request = new HttpRequestMessage(HttpMethod.Get, googleUrl);
                HttpResponseMessage response = await client.SendAsync(request);
            }
        }