[深刻浅出WP8.1(Runtime)]网络编程之HttpClient类

12.2 网络编程之HttpClient类

    除了可使用HttpWebRequest类来实现HTTP网络请求以外，咱们还可使用HttpClient类来实现。对于基本的请求操做，HttpClient类提供了一个简单的接口来处理最多见的任务，并为身份验证提供了适用于大多数方案的合理的默认设置。对于较为复杂的 HTTP 操做，更多的功能包括：执行常见操做（DELETE、GET、PUT 和 POST）的方法；获取、设置和删除 Cookie 的功能；支持常见的身份验证设置和模式；异步方法上提供的 HTTP 请求进度信息；访问有关传输的安全套接字层 (SSL) 详细信息；在高级应用中包含自定义筛选器的功能等。

12.2.1 Get请求获取字符串和数据流数据

    （1）获取字符串数据

    HttpClient类使用基于任务的异步模式提供了很是简化的请求操做，你能够直接调用HttpClient类GetStringAsync方法即可以获取到网络返回的字符串数据。下面咱们来看一下使用Get请求来获取网络返回的字符串，实现的代码很简洁和简单，示例代码以下所示：

    Uri uri = new Uri("http://yourwebsite.com");

    HttpClient httpClient = new HttpClient();

    // 获取网络的返回的字符串数据

    string result = await httpClient.GetStringAsync (uri);

 

    使用GetStringAsync方法是一种简化的HTTP请求，若是咱们要获取到HTTP请求所返回的整个对象HttpResponseMessage类对象可使用GetAsync方法。HttpResponseMessage对象是HTTP的相应消息对象，它包含了网络请求相应的HTTP头、数据体等信息。下面咱们使用GetAsync方法来获取网络返回的字符串信息，示例代码以下所示：

    HttpResponseMessage response = await httpClient.GetAsync(uri);

    string responseBody = await response.Content.ReadAsStringAsync();

 

    （2）获取数据流数据

    HttpResponseMessage对象的Content属性表示是返回的数据对象，是一个IHttpContent类型的对象。若是要获取的是数据流数据，能够经过它的ReadAsBufferAsync方法获取到返回的IBuffer对象，或者经过ReadAsInputStreamAsync地方获取IInputStream对象，而后再转化为Stream对象，示例代码以下所示：

    using (Stream responseStream = (await response.Content.ReadAsInputStreamAsync()).AsStreamForRead())

    {

        int read = 0;

        byte[] responseBytes = new byte[1000];

        do

        {

            // 若是read等于0表示Stream的数据以及读取完毕

            read = await responseStream.ReadAsync(responseBytes, 0, responseBytes.Length);

        } while (read != 0);

    }

 

    （3）取消网络请求

    HttpClient类发起的网络请求都是基于任务的异步方法，因此要取消其异步的操做能够经过异步任务的取消对象CancellationTokenSource对象来取消，这点和HttpWebRequest类是不一样。若是使用CancellationTokenSource对象来取消异步的请求会触发TaskCanceledException异常，这个异常须要咱们用try catch语句来捕获，即可以识别到请求是被取消的。

    private CancellationTokenSource cts = new CancellationTokenSource();

    try

    {

        // 使用CancellationTokenSource对象来控制异步任务的取消操做

        HttpResponseMessage response = await httpClient.GetAsync(new Uri(resourceAddress)).AsTask(cts.Token);

        responseBody = await response.Content.ReadAsStringAsync().AsTask(cts.Token);

        cts.Token.ThrowIfCancellationRequested();

    }

    catch (TaskCanceledException)

    {

        responseBody = "请求被取消";

    }

    // 调用Cancel方法取消网络请求

    if (cts.Token.CanBeCanceled)

    {

        cts.Cancel();

    }

 

12.2.2 Post请求发送字符串和数据流数据

    使用HttpClient类发起Post请求的编程方式也很简洁，咱们能够调用方法PostAsync(Uri uri, IHttpContent content)来直接向目标的地址Post数据，在该方法里面有两个参数其中uri就是网络的目标地址，两外一个content是指你要向目标地址Post的数据对象。在Post数据以前咱们首先把咱们的数据初始化成为一个IHttpContent对象，那么实现了IHttpContent接口的类有HttpStringContent类、HttpStreamContent类和HttpBufferContent类，这三个类分表表明了字符串类型、数据流类型和二进制类型，那么数据流类型和二进制类型是能够互相转换的区别不大。调用PostAsync方法以后会返回一个HttpResponseMessage对象，经过这个HTTP的相应消息对象咱们就能够获取Post请求以后的返回的结果信息。Post请求发送字符串和数据流数据的代码示例以下所示：

    （1）Post请求发送字符串数据

    HttpStringContent  httpStringContent = new HttpStringContent("hello Windows Phone");

    HttpResponseMessage response = await httpClient.PostAsync(uri,

                                           httpStringContent).AsTask(cts.Token);

    string responseBody = await response.Content.ReadAsStringAsync().AsTask(cts.Token);

 

    （2）Post请求发送数据流数据

    HttpStreamContent streamContent = new HttpStreamContent(stream.AsInputStream());

    HttpResponseMessage response = await httpClient.PostAsync(uri,

                                           streamContent).AsTask(cts.Token);

    string responseBody = await response.Content.ReadAsStringAsync().AsTask(cts.Token);

 

    除了使用PostAsync方法以外，咱们还可使用SendRequestAsync方法来发送网络请求，SendRequestAsync方法既可使用Get方式也可使用Post方式。SendRequestAsync方法发送的消息类型是HttpRequestMessage类对象，HttpRequestMessage类表示HTTP的请求消息类，你能够经过HttpRequestMessage对象设置请求的类型（Get/Post）和传输的数据对象。使用SendRequestAsync方法的代码示例以下所示：

    // 建立HttpRequestMessage对象

    HttpStreamContent streamContent = new HttpStreamContent(stream.AsInputStream());

    HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, new Uri(resourceAddress));

    request.Content = streamContent;

    // 发送数据

    HttpResponseMessage response = await httpClient.SendRequestAsync(request).AsTask(cts.Token);

    string responseBody = await response.Content.ReadAsStringAsync().AsTask(cts.Token);

 

12.2.3 设置和获取Cookie

    Cookie是指某些网站为了辨别用户身份、进行回话跟踪而储存在用户本地终端上的数据（一般通过加密）。那么当咱们在使用HTTP请求的时候，若是服务器返回的数据待用Cookie数据，咱们也是能够获取出来，存储在本地，下次发起HTTP请求的时候就会带上这些Cookie的数据。

    在HttpClient类的网络请求中咱们能够经过HttpBaseProtocolFilter类来获取网站的Cookie信息，HttpBaseProtocolFilter类表示是HttpClient的HTTP请求的基础协议的过滤器。获取Cookie的代码示例以下所示：

    // 建立一个HttpBaseProtocolFilter对象

    HttpBaseProtocolFilter filter = new HttpBaseProtocolFilter();

    // 经过HttpBaseProtocolFilter对象获取使用HttpClient进行过网络请求的地址的Cookie信息

    HttpCookieCollection cookieCollection = filter.CookieManager.GetCookies(new Uri(resourceAddress));

    // 遍历整个Cookie集合的Cookie信息

    foreach (HttpCookie cookie in cookieCollection)

    {

    }

 

    固然咱们在发送HTTP请求的时候也同样能够带上Cookie信息，若是服务器能够识别到Cookie信息那么就会经过Cookie信息来进行一些操做，好比Cookie信息信息带有用户名和密码的加密信息，那么就能够免去登录的步骤。在HttpClient的网路请求里面HttpCookie类表示是一个Cookie对象，建立好Cookie对象以后经过HttpBaseProtocolFilter对象的CookieManager属性来设置Cookie，而后发送网络请求，这时候的网络请求就会把Cookie信息给带上。设置Cookie的代码示例以下所示：

    // 建立一个HttpCookie对象，"id"表示是Cookie的名称，"localhost"是主机名，"/"是表示服务器的虚拟路径

    HttpCookie cookie = new HttpCookie("id", "yourwebsite.com", "/");

    // 设置Cookie的值

    cookie.Value = "123456";

    // 设置Cookie存活的时间，若是设置为null表示只是在一个会话里面生效

    cookie.Expires = new DateTimeOffset(DateTime.Now, new TimeSpan(0, 1, 8));

    // 在过滤器里面设置Cookie

    HttpBaseProtocolFilter filter = new HttpBaseProtocolFilter();

    bool replaced = filter.CookieManager.SetCookie(cookie, false);

    ……接下来能够向"yourwebsite.com"远程主机发起请求

12.2.4 网络请求的进度监控

    HttpClient的网络请求是支持进度监控，经过异步任务的IProgress<T>对象能够直接监控到HttpClient的网络请求返回的进度信息，返回的进度对象是HttpProgress类对象。在进度对象HttpProgress里面包含了下面的一些信息：Stage（当前的状态）、BytesSent（已发送的数据大小）、BytesReceived（已接收的数据大小）、Retries（重试的次数）、TotalBytesToSend（总共须要发送的数据大小）和TotalBytesToReceive（总共须要接收的数据大小）。网络请求进度监控的代码示例以下所示：

    // 建立IProgress<HttpProgress>对象

    IProgress<HttpProgress> progress = new Progress<HttpProgress>(ProgressHandler);

    // 在异步任务中加入进度监控

    HttpResponseMessage response = await httpClient.PostAsync(new Uri(resourceAddress), streamContent).AsTask(cts.Token, progress);

    // 进度监控的回调方法

    private void ProgressHandler(HttpProgress progress)

    {

        // 在这里能够经过progress参数获取到进度的相关信息

    }

本文来源于《深刻浅出Windows Phone 8.1 应用开发》

WP8.1 Runtime文章列表：http://www.cnblogs.com/linzheng/p/3998037.html

源代码下载：http://vdisk.weibo.com/s/zt_pyrfNHb99O

欢迎关注个人微博@WP林政   微信公众号：wp开发（号：wpkaifa）

WP8.1技术交流群：372552293