【ASP.NET Web API教程】3.4 HttpClient消息处理器

简介: 原文:【ASP.NET Web API教程】3.4 HttpClient消息处理器注:本文是【ASP.NET Web API系列教程】的一部分,如果您是第一次看本博客文章,请先看前面的内容。 3.4 HttpClient Message Handlers 3.
原文: 【ASP.NET Web API教程】3.4 HttpClient消息处理器

注:本文是【ASP.NET Web API系列教程】的一部分,如果您是第一次看本博客文章,请先看前面的内容。

3.4 HttpClient Message Handlers
3.4 HttpClient消息处理器

本文引自:http://www.asp.net/web-api/overview/web-api-clients/httpclient-message-handlers

By Mike Wasson | October 1, 2012
作者:Mike Wasson | 日期:2012-10-1

A message handler is a class that receives an HTTP request and returns an HTTP response.
消息处理器是一个接收HTTP请求并返回HTTP响应的类。

Typically, a series of message handlers are chained together. The first handler receives an HTTP request, does some processing, and gives the request to the next handler. At some point, the response is created and goes back up the chain. This pattern is called a delegating handler.
典型地,一系列消息处理器会链接在一起。第一个处理器接收HTTP请求,进行某些处理,将此请求传给下一个处理器。在处理链的某个点上创建响应,并进行回溯。这种模式称为委托(delegating)处理器(如图3-7所示)。

WebAPI3-7

图3-7. 消息处理链及委托处理器

On the client side, the HttpClient class uses a message handler to process requests. The default handler is HttpClientHandler, which sends the request over the network and gets the response from the server. You can insert custom message handlers into the client pipeline:
在客户端,HttpClient类使用消息处理器处理请求。默认的处理器是HttpClientHandler,它在网络上发送请求,并从服务器获取响应。你可以把自定义消息处理器插入到这种客户端管线之中(如图3-8所示)。

WebAPI3-8

图3-8. 消息处理管线

ASP.NET Web API also uses message handlers on the server side. For more information, see HTTP Message Handlers.
ASP.NET Web API也使用服务器端的消息处理器,更多信息参阅“HTTP消息处理器”(本系列教程第5.1小节 — 译者注)。

Custom Message Handlers
自定义消息处理器

To write a custom message handler, derive from System.Net.Http.DelegatingHandler and override the SendAsync method. Here is the method signature:
要编写自定义消息处理器,需从System.Net.Http.DelegatingHandler进行派生,并重写SendAsync方法。以下是该方法的签名:

Task<HttpResponseMessage> SendAsync(
    HttpRequestMessage request, CancellationToken cancellationToken);

The method takes an HttpRequestMessage as input and asynchronously returns an HttpResponseMessage. A typical implementation does the following:
该方法以HttpRequestMessage作为输入,并异步地返回一个HttpResponseMessage。一种典型的实现(流程)如下:

  1. Process the request message.
    处理请求消息。
  2. Call base.SendAsync to send the request to the inner handler.
    调用base.SendAsync将请求发送给内部处理器。
  3. The inner handler returns a response message. (This step is asynchronous.)
    内部处理器返回一条响应消息。(这一步是异步的。)
  4. Process the response and return it to the caller.
    处理响应,并把它返回给客户端。

The following example shows a message handler that adds a custom header to the outgoing request:
以下示例展示了一个消息处理器,它把一个自定义报头添加到输出请求:

class MessageHandler1 : DelegatingHandler 
{ 
    private int _count = 0; 
    protected override Task<HttpResponseMessage> SendAsync( 
        HttpRequestMessage request, System.Threading.CancellationToken cancellationToken) 
    { 
        _count++; 
        request.Headers.Add("X-Custom-Header", _count.ToString()); 
        return base.SendAsync(request, cancellationToken); 
    } 
}

The call to base.SendAsync is asynchronous. If the handler does any work after this call, use the await keyword to resume execution after the method completes. The following example shows a handler that logs error codes. The logging itself is not very interesting, but the example shows how to get at the response inside the handler.
base.SendAsync的调用是异步的。如果处理器在调用之后还要做一些工作,需使用await关键字,以便在方法完成之后继续执行。以下示例展示了一个对错误码进行日志的处理器。如何进行日志没多大关系,但此例展示了如何得到处理器内部的响应。

class LoggingHandler : DelegatingHandler 
{ 
    StreamWriter _writer; 
    public LoggingHandler(Stream stream) 
    { 
        _writer = new StreamWriter(stream); 
    } 
    protected override async Task<HttpResponseMessage> SendAsync( 
        HttpRequestMessage request, System.Threading.CancellationToken cancellationToken) 
    { 
        var response = await base.SendAsync(request, cancellationToken); 
        if (!response.IsSuccessStatusCode) 
        { 
            _writer.WriteLine("{0}\t{1}\t{2}", request.RequestUri,  
                (int)response.StatusCode, response.Headers.Date); 
        } 
        return response; 
    } 
    protected override void Dispose(bool disposing) 
    { 
        if (disposing) 
        { 
            _writer.Dispose(); 
        } 
        base.Dispose(disposing); 
    } 
}

Adding Message Handlers to the Client Pipeline
将消息处理器添加到客户端管线

To add custom handlers to HttpClient, use the HttpClientFactory.Create method:
要将自定义处理器添加到HttpClient,需使用HttpClientFactory.Create方法:

HttpClient client = HttpClientFactory.Create(new Handler1(), new Handler2(), new Handler3());

Message handlers are called in the order that you pass them into the Create method. Because handlers are nested, the response message travels in the other direction. That is, the last handler is the first to get the response message.
消息处理器是按照把它们传递给Create方法中的顺序来调用的。因此处理器是内嵌的,响应消息以反方向传递。即,最后一个处理器首先得到响应消息。

看完此文如果觉得有所收获,恳请给个推荐

目录
相关文章
|
1月前
|
JSON API 数据库
解释如何在 Python 中实现 Web 服务(RESTful API)。
解释如何在 Python 中实现 Web 服务(RESTful API)。
25 0
|
1月前
|
数据采集 监控 安全
各种业务场景调用API代理的API接口教程
API代理的API接口在各种业务场景中具有广泛的应用,本文将介绍哪些业务场景可以使用API代理的API接口,并提供详细的调用教程和代码演示,同时,我们还将讨论在不同场景下使用API代理的API接口所带来的好处。
|
30天前
|
API
2024常用Web支付开发讲解教程
本教程为web支付开发,讲解了最常用的两钟支付:支付宝支付和微信支付,服务器配置和API对接,学完本课程可以学会微信支付、和支付宝支付开发。
18 2
2024常用Web支付开发讲解教程
|
30天前
|
架构师 前端开发
web全栈架构师第16期教程
互联网时代已进入后半场,行业环境发生了显著变化。互联网人,尤其是技术人员,如何在加速更迭的技术浪潮中持续充电,提升自身价值,是当下必须面对的挑战。课程涉及了现下前端实际开发时所需要的各块内容,并深度对标 阿里 P6+级别所具备的知识储备及开发技能,奠定源码阅读基础和全栈开发能力。
19 3
web全栈架构师第16期教程
|
1月前
|
安全 API 数据安全/隐私保护
email api接口配置教程步骤详解
Email API是用于程序化访问邮件服务的工具,让开发者能集成邮件功能到应用中。配置Email API包括选择供应商(如SendGrid、Mailgun、AokSend),注册获取API密钥,配置API参数,及测试邮件发送。使用Email API能提升邮件发送的可靠性和效率,便于邮件管理及营销活动。AokSend支持大量验证码发送,适合高效邮件运营。
|
1月前
|
XML JSON API
通过Flask框架创建灵活的、可扩展的Web Restful API服务
通过Flask框架创建灵活的、可扩展的Web Restful API服务
|
1月前
|
缓存 监控 API
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
57 0
|
1月前
|
XML JavaScript 前端开发
Web 扫描神器:WhatWeb 保姆级教程(附链接)
Web 扫描神器:WhatWeb 保姆级教程(附链接)
52 0
|
1月前
|
存储 网络协议 安全
Web 扫描神器:Gobuster 保姆级教程(附链接)
Web 扫描神器:Gobuster 保姆级教程(附链接)
170 0
|
1月前
|
JSON API 数据格式
构建高效Python Web应用:Flask框架与RESTful API设计实践
【2月更文挑战第17天】在现代Web开发中,轻量级框架与RESTful API设计成为了提升应用性能和可维护性的关键。本文将深入探讨如何使用Python的Flask框架来构建高效的Web服务,并通过具体实例分析RESTful API的设计原则及其实现过程。我们将从基本的应用架构出发,逐步介绍如何利用Flask的灵活性进行模块化开发,并结合请求处理、数据验证以及安全性考虑,打造出一个既符合标准又易于扩展的Web应用。
645 4