欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

ASP.NET MVC HttpClient

程序员文章站 2022-06-11 13:02:11
...

使用System.Net.Http命名空间中的 HttpClient 类可向 WebService 发送 POST 和 GET 请求并检索响应数据。System.Net.Http命名空间中的类可为现代 HTTP 应用提供编程接口。System.Net.Http命名空间和相关的System.Net.Http.Headers命名空间提供的 HTTP 客户端组件,允许用户通过 HTTP 使用现代的 WebService。

HttpClient 类用于通过 HTTP 发送和接收数据,它提供了一个用于从 URI 所标识的资源发送 HTTP 请求和接收 HTTP 响应的基类。该类可用来向 WebService 发送 GET、PUT、POST、DELETE以及其他请求。

ASP.NET MVC4 中自带 HttpClient 类,用于接收HttpResponseMessage和发送HttpRequestMessage。HttpClient 包含在System.Net.Http.dll程序集中,用户接收和发送 HTTP 请求,该类适用于 .NET4+ 版本。

默认情况下, HttpWebRequest 将用于向服务器发送请求,此行为可指定一个不同的通道修改在获取 HttpMessageHandler 实例的构造函数重载之一种作为参数。若需与身份验证功能或缓存,WebRequestHandler 可用于配置设置,而实例可传递给构造函数。返回的处理程序传递到采用 HttpMessageHandler 参数的构造函数重载之一。

HttpClient 的优势

  • 可在HttpClient实例上配置扩展,设置默认头部,取消未完成的请求和设置。
  • HttpClient有自己的连接池
  • HttpClient不与特定的服务器绑定,可访问任何HTTP请求。
  • HttpClient采用异步请求处理

System.Net.Http

System.Net.Http是微软在 .NET4.5 中推出的HTTP应用程序的编程接口,微软称之为“现代化的HTTP编程接口”,主要提供

  • 用户通过HTTP使用现代化的Web Service的客户端组件
  • 能够同时在客户端与服务端同时使用HTTP组件,比如处理HTTP标头和消息,为客户端和服务端提供一致的编程模型。

命名空间System.Net.HttpSystem.Net.Http.Headers提供

  • HttpClient发送和接收HTTP请求和响应
  • HttpRequestMessage 和 HttpResponseMessage 封装了RFC2616定义的HTTP消息
  • HttpHeaders封装了 RFC2616定义的HTTP标头
  • HttpClientHandler负责生成HTTP响应消息和HTTP处理程序

System.Net.Http能够处理多种类型的RFC2616定义的HTTP实体正文,System.Net.Http对HTTP消息的处理采用内职责链模式。

System.Net.Http最早是和ASP.NET MVC4同时出现的,是一个第三方组件,全称为 Microsoft HTTP Client Libraries,可以在.NET4.0中使用。随着.NET4.5发布,System.Net.Http正式成为.NET的基础类库,目前已经可以在.NET4.0/4.5、Windows Phone、Windows Store App中使用。

HttpClient组件类实例为一个会话发送HTTP请求,HttpClient实例设置为集合应用于该实例执行的所有请求。此外,没给HttpClient实例使用自己的连接池,隔离其他HttpClient实例的执行请求。HttpClient也是更具体的HTTP客户端的基类。

默认情况下,使用HttpWebRequest向服务器发送请求,此行为可通过在接受一个 HttpMessageHandler 实例作为参数的构造函数重载中指定不同的通道来更改。

如果需要身份验证或缓存,WebRequestHandler可使用配置项和实例传递给构造函数,范湖ide处理程序传递到采用 HttpMessageHandler 参数的某构造进行返回参数传递。

如果使用 HttpClient 和相关组件类的应用在System.Net.Http命名空间用于下载大量数据,可达到50MB以上。则应用程序不适用默认缓冲区。如果使用默认缓冲区,客户端内存使用量会非常大,可能导致性能显著的降低。

HttpClient 提供的方法

  • GetAsync(String)
    以异步操作将GET请求发送给指定的URI
  • GetAsync(URI)
    以异步操作将GET请求发送给指定的URI
  • GetAsync(String, HttpCompletionOption)
    以异步操作的HTTP完成选项发送GET请求到指定的URI
  • GetAsync(String, CancellationToken)
    以异步操作的取消标记发送GET请求到指定URI
  • GetAsync(Uri, HttpCompletionOption)
    以异步操作的HTTP完成选项发送GET请求到指定的URI
  • GetAsync(Uri, HttpCompletionOption, CancellationToken)
    以异步操作的HTTP完成选项和取消标记发送DELETE请求到指定的URI
  • GetAsync(Uri, HttpCompletionOption, CancellationToken)
    以异步操作的HTTP完成选项和取消标记发送DELETE请求到指定的URI
  • GetByteArrayAsync(String)
    将GET请求发送到指定URI并在异步操作中以字节数组的形式返回响应正文
  • GetByteArrayAsync(Uri)
    将GET请求发送到指定URI并在一异步操作中以字节数组形式返回响应正文
  • GetHashCode
    用作特定类型的哈希函数,继承自Object
  • GetStreamAsync(String)
    将GET请求发送到指定URI并在异步操作中以流的形式返回响应正文
  • GetStreamAsync(Uri)
    将GET请求发送到指定URI并在异步操作以流的形式返回响应正文
  • GetStreamAsync(String)
    将GET请求发送到指定URI并在异步操作中以字符串的形式返回响应正文
  • GetStringAsync(Uri)
    将GET请求发送到指定URI并在异步操作中以字符串形式返回响应正文

MaxResponseContentBufferSize

HttpClient 有MaxResponseContentBufferSize属性,表示读取相应内容是最大的字节缓存数,默认值64K。当页面内容超出64K则会抛出异常 HttpRequestException,导致GET失败。

// 手工设置最大字节缓存数,默认64KB。
HttpClient httpClient = new HttpClient(){MaxResponseContentBufferSize = 1024 * 1024};