通过重建Hosting系统理解HTTP请求在ASP.NET Core管道中的处理流程[上]:采用管道处理请求

简介:

之所以称ASP.NET Core是一个Web开发平台,而不是一个单纯的开发框架,源于它具有一个极具扩展性的请求处理管道,我们可以通过对这个管道的定制来满足各种场景下的HTTP处理需求。ASP. NET Core应用的很多特性,比如路由、认证、会话、缓存等,都是通过对管道的定制来实现的。我们甚至可以通过管道定制在ASP.NET Core平台上创建我们自己的Web框架,实际上MVC和SingalR这两个重要的Web框架也是采用这样的方式创建的。 [本文已经同步到《ASP.NET Core框架揭秘》之中] [源代码从这里下载]

目录
一、从Hello World说起
二、管道的构成
三、管道的定制

一、从Hello World说起

HTTP协议自身的特性决定了任何一个Web应用的工作方式都是监听、接收并处理HTTP请求,并在最终对请求予以响应,HTTP请求处理是管道式设计典型的应用场景。具体来说,我们根据具体的HTTP处理请求构建一个管道,接收到的HTTP请求消息想水一样流入这个管道,组成这个管道的各个环节依次对它作相应的处理。处理的结果同样转变成消息逆向流入这个管道进行处理,并最终转变成回复给客户端的HTTP响应。ASP.NET Core的消息处理管道从设计的角度来讲是非常简单的,但是从具体实现的角度则相对复杂并相对难以理解,为了让读者朋友们通过本章对此具有深刻的理解,我们从简单的部分讲起。

为了使读者朋友们能够以最直观的感受认识ASP.NET Core的消息处理管道,我们来创建一个最简单的Hello World程序。这是一个控制台应用,整个程序由如下所示的五行代码组成。当我们运行这个程序之后,一个名为KestrelServer的服务器将会启动并绑定到本机上的5000端口进行请求监听。针对所有接收到的请求,我们都有会响应一个“Hello World”字符串。

   1: public class Program
   2: {
   3:     public static void Main()
   4:     {
   5:         new WebHostBuilder()
   6:             .UseKestrel()
   7:             .Configure(app => app.Run(async context=> await context.Response.WriteAsync("Hello World")))            
   8:             .Build()
   9:             .Run();
  10:     }
  11: }

这个程序涉及到一个名为WebHost重要的对象, 它可以看成是Web应用的宿主,启动Web应用本质上就是启动作为宿主的WebHost对象。WebHostBuilder是WebHost的创建者,我们调用它的Build方法创建相应的WebHost。当我们调用WebHost的扩展方法Run启动应用的时候,用于监听、接收、处理和响应HTTP请求的管道随之被建立。那么在这个过程中,通过调用Configure方法注册到WebHostBuilder上的委托对象(委托类型为Action<IApplicationBuilder>)将用于管道的定制。总的来说,ASP.NET Core管道由WebHost在启动的时候构建,WebHostBuilder则是后者的创建者,下图揭示了三者之间的关系。

clip_image001 

二、管道的构成

HTTP请求处理流程始于对请求的监听与接收,终于对请求的响应,这两项工作均由同一个对象来完成,我们称之为 “服务器(Server)” 。尽管ASP.NET Core的请求处理管道可以被自由地订制,但是该管道必须有一个Server,Server是整个管道的 “龙头” 。在上面的这个Hello World应用中,在调用WebHostBuilder的Build方法创建一个WebHost之前,我们调用了它的一个扩展方法UseKestrel,这个方法的作用就是为后续构建的管道注册一个名为KestrelServer的Server。

随着WebHost的Start方法(当我们调用WebHost的扩展方法Run时,它的Start方法会自动被调用)的调用,定制的管道会被构建出来,管道的服务器将会绑定到一个预设的端口(比如KestrelServer默认采用5000作为监听端口)开始监听请求。HTTP请求一旦抵达,Server会并将其标准并分发给管道后续的节点,我们将管道中位于服务器之后的节点称为“中间件(Middleware)”。每个中间件都具有各自独立的功能,比如我们有专门实现路由功能的中间件,有专门实施用户认证的中间件。所谓的管道定制体现在根据具体的需求选择对应的中间件组成最终处理请求的管道。下图揭示了由一个服务器和一组中间件构成的请求处理管道。

clip_image002

一个建立在ASP.NET Core之上的应用一般都是根据某个框架开发的,一般来说,开发框架本身就是通过某一个或者多个中间件构建的。以ASP.NET Core MVC这个最著名的开发框架为例,它实际上是借助于一个叫做 “路由” 的中间件实现了请求地址与Controller/Action之间的映射,并在此基础实现了激活Controller、执行Action以及呈现View等一系列的功能。所以应用程序可以视为某个中间件的一部分,如果一定要将它独立出来,整个请求处理管道将呈现出如下图所示的结构。

clip_image003 

三、管道的定制

在演示的Hello World程序中,我们在调用扩展方法UseKestrel注册KestrelServer服务器之后,还调用WebHostBuilder如下一个名为Configure的扩展方法注册了一个类型为Action<IApplicationBuilder>的委托对象。从请求处理管道的角度来讲,注册这个委托对象的目的在于对构建的管道进行定制,说得更加具体一点,我们利用这个类型为管道注册需要的中间件。演示实例中注册的这个委托对象调用ApplicationBuilder的扩展方法Run注册了一个中间件来为每个请求响应一个 “Hello World” 字符串。

   1: public static IWebHostBuilder Configure(this IWebHostBuilder hostBuilder, Action<IApplicationBuilder> configureApp) 

除了通过调用WebHostBuilder的Configure方法注册一个Action<IApplicationBuilder>类型的委托,注册中间定义管道的逻辑更多地还是定义在一个单独的类型中。由于管道的定制总是在应用启动(Startup)的时候进行,我们一般称这个用于定制管道的类型为“启动类型”,并在大部分情况下会直接命名为Startup。按照约定,通过注册中间件定制管道的操作会实现在名为Configure的方法中,方法的第一个参数类型必须是IApplicationBuilder接口,后面可定义任意数量和类型的参数,当这个方法被ASP.NET Core框架调用的时候,这些参数会采用依赖注入的方式来提供。启动类型可以通过调用WebHostBuilder的扩展方法UseStartup<T>进行注册,如下面的代码与前面演示的实例是完全等效的。

   1: public class Program
   2: {
   3:     public static void Main()
   4:     {
   5:         new WebHostBuilder()
   6:             .UseKestrel()
   7:             .UseStartup<Startup>()
   8:             .Build()
   9:             .Run();
  10:     }
  11:     public class Startup
  12:     {
  13:         public void Configure(IApplicationBuilder app)
  14:         {
  15:             app.Run(async context => await context.Response.WriteAsync("Hello World"));
  16:         }
  17:     }
  18: }

在真正的项目开发中,我们会利用ApplicationBuilder注册相应的中间件进而构建一个适合当前请求处理需求的管道。如下面的代码片段所示,我们除了按照如上的方式调用扩展方法UseMvc注册了支撑MVC框架的中间件(实际上是一个实现路由的中间件)之外,我们还通过调用其它的扩展方法注册了相应的中间件实现了对静态文件的访问(UseStaticFiles)、错误页面的呈现(UseExceptionHandler)以及基于ASP.NET Identity Framework的认证(UseIdentity)。

   1: public class Startup
   2: {
   3:     public void Configure(IApplicationBuilder app)
   4:     {
   5:         app.UseExceptionHandler("/Home/Error");
   6:         app.UseStaticFiles();
   7:         app.UseIdentity();           
   8:  
   9:         app.UseMvc();
  10:     }
  11: }

 


通过重建Hosting系统理解HTTP请求在ASP.NET Core管道中的处理流程[上]:采用管道处理请求
通过重建Hosting系统理解HTTP请求在ASP.NET Core管道中的处理流程[中]:管道如何处理请求
通过重建Hosting系统理解HTTP请求在ASP.NET Core管道中的处理流程[下]:管道如何创建

作者:蒋金楠
微信公众账号:大内老A
微博: www.weibo.com/artech
如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注个人公众号(原来公众帐号 蒋金楠的自媒体将会停用)。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
相关文章
|
21天前
|
开发框架 .NET 开发者
简化 ASP.NET Core 依赖注入(DI)注册-Scrutor
Scrutor 是一个简化 ASP.NET Core 应用程序中依赖注入(DI)注册过程的开源库,支持自动扫描和注册服务。通过简单的配置,开发者可以轻松地从指定程序集中筛选、注册服务,并设置其生命周期,同时支持服务装饰等高级功能。适用于大型项目,提高代码的可维护性和简洁性。仓库地址:&lt;https://github.com/khellang/Scrutor&gt;
39 5
|
1天前
|
缓存 应用服务中间件 Apache
HTTP 范围Range请求
HTTP范围请求是一种强大的技术,允许客户端请求资源的部分内容,提高了传输效率和用户体验。通过正确配置服务器和实现范围请求,可以在视频流、断点续传下载等场景中发挥重要作用。希望本文提供的详细介绍和示例代码能帮助您更好地理解和应用这一技术。
37 19
|
4天前
|
前端开发 C# 开发者
.NET使用Umbraco CMS快速构建一个属于自己的内容管理系统
.NET使用Umbraco CMS快速构建一个属于自己的内容管理系统
24 12
|
9天前
|
JSON JavaScript 前端开发
什么是HTTP POST请求?初学者指南与示范
HTTP POST请求是一种常用的HTTP方法,主要用于向服务器发送数据。通过合理设置请求头和请求主体,可以实现数据的可靠传输。无论是在客户端使用JavaScript,还是在服务器端使用Node.js,理解和掌握POST请求的工作原理和应用场景,对于Web开发至关重要。
122 18
|
4天前
|
Web App开发 前端开发 调度
一款基于 .NET + Blazor 开发的智能访客管理系统
一款基于 .NET + Blazor 开发的智能访客管理系统
|
4天前
|
开发框架 JavaScript 前端开发
精选2款.NET开源的博客系统
精选2款.NET开源的博客系统
|
4天前
|
前端开发 JavaScript C#
基于.NET8+Vue3开发的权限管理&个人博客系统
基于.NET8+Vue3开发的权限管理&个人博客系统
|
9天前
|
JSON 数据格式
.net HTTP请求类封装
`HttpRequestHelper` 是一个用于简化 HTTP 请求的辅助类,支持发送 GET 和 POST 请求。它使用 `HttpClient` 发起请求,并通过 `Newtonsoft.Json` 处理 JSON 数据。示例展示了如何使用该类发送请求并处理响应。注意事项包括:简单的错误处理、需安装 `Newtonsoft.Json` 依赖,以及建议重用 `HttpClient` 实例以优化性能。
51 2
|
26天前
|
Web App开发 大数据 应用服务中间件
什么是 HTTP Range请求(范围请求)
HTTP Range 请求是一种非常有用的 HTTP 功能,允许客户端请求资源的特定部分,从而提高传输效率和用户体验。通过合理使用 Range 请求,可以实现断点续传、视频流播放和按需加载等功能。了解并掌握 HTTP Range 请求的工作原理和应用场景,对开发高效的网络应用至关重要。
63 15
|
6天前
|
开发框架 算法 中间件
ASP.NET Core 中的速率限制中间件
在ASP.NET Core中,速率限制中间件用于控制客户端请求速率,防止服务器过载并提高安全性。通过`AddRateLimiter`注册服务,并配置不同策略如固定窗口、滑动窗口、令牌桶和并发限制。这些策略可在全局、控制器或动作级别应用,支持自定义响应处理。使用中间件`UseRateLimiter`启用限流功能,并可通过属性禁用特定控制器或动作的限流。这有助于有效保护API免受滥用和过载。 欢迎关注我的公众号:Net分享 (239字符)
25 0