解读大内老A的《.NET Core框架本质》

老A说的一句话让我很受启发,想要深入了解框架,你要把精力聚焦在架构设计的层面来思考问题。而透彻了解底层原理,最好的笨办法就是根据原理对框架核心进行重建或者说再造。看起来没有捷径,也是最快的捷径。

  相信很多读者已经看过老A写的这篇文章《200行代码,7个对象——让你了解ASP.NET Core框架的本质》,这是一篇模仿和重建的典范。重建说白了就是模仿,模仿有一个前置条件就是你对底层原理要烂熟于心。否则画虎难画骨,原本要画虎,最后出来的是只猫。

要理解原理就要去阅读源码,就像新人学开车,如何使用尚且磕磕碰碰,更何况让你去了解汽车的构造和引擎。

  所以老A是引路人,我像个门外汉一样对前辈的文章解读不下5遍。我有几个疑问,1.为什么是7个对象?2.这些对象如何分类,如何排序?3.这些对象发明的那个“无”是什么?

  在我深入学习和解读的时候,我越加感觉到老A的这篇文章很值得去深入解读,所谓知其然,知其所以然,这样在编码过程才会游刃有余,以下开始我个人的解读。

  • 委托

  • 构建模式

  • 适配器模式


public class Program

{

    public static void Main()

    => new WebHostBuilder()

        .UseKestrel()

        .Configure(app => app.Use(context => context.Response.WriteAsync("Hello World!")))

        .Build()

        .Run();

}

  以上是原文的代码,我们可以看到WebHostBuilder、Server(即Kestrel)、ApplicationBuilder(即app)三大重要的对象,如下图所示:

640?wx_fmt=png

  WebHostBuilder这个父亲生出WebHost这个孩子,WebHost又生成整个ASP.NET Core最核心的内容,即由Server和中间件(Middleware)构成的管道Pipeline。我们看下Pipeline的放大图:

640?wx_fmt=png

  继续把Pipeline拆开,有个很重要的ApplicationBuilder对象,里面包含MiddlewareRequestDelegate。至于HttpContext是独立共享的对象,贯穿在整个管道中间,至此7大对象全部出场完毕。

Configure是个什么玩意?看下代码:


public IWebHostBuilder Configure(Action<IApplicationBuilder> configure)

{

    _configures.Add(configure);

    return this;

}

  我们看到他是一个接受IApplicationBuilder的委托!继续刨根问底,IApplicationBuilder是什么玩意?看下源码:


public interface IApplicationBuilder

{

    IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware);

    RequestDelegate Build();

}

  他是一个注册中间件和生成Application的容器,那么Application是什么呢?源码没有这个对象,但是看代码(如下所示)我们可以知道他是真正的委托执行者(Handler),执行是一个动作可以理解为app,我猜想这是取名为ApplicationBuilder的原因。


public RequestDelegate Build()

{

    _middlewares.Reverse();

    return httpContext =>

    {

        RequestDelegate next = _ => { _.Response.StatusCode = 404; return Task.CompletedTask; };

        foreach (var middleware in _middlewares)

        {

            next = middleware(next);

        }

        return next(httpContext);

    };

}

  更详细的过程可以参考下面这张图(图片来源),

640?wx_fmt=png

  WebHostBuilder开始Build的那一刻开始,WebHost被构造,Server被指定,Middlewares被指定,等WebHost真正启动的时候,Server开始监听,收到请求后,Middleware开始执行。

到此,一个完整的ASP.NET Core的流程就简单的走完了。接下来,我们跟着老A一个一个对象的详细介绍。

1.HttpContext

这个对象应该是最容易理解的,也是我们在编程时候遇到的最多的,最重要的(没有之一)对象。请看这个对象的简要代码:


public class HttpContext

{          

    public  HttpRequest Request { get; }

    public  HttpResponse Response { get; }

}

public class HttpRequest

{

    public  Uri Url { get; }

    public  NameValueCollection Headers { get; }

    public  Stream Body { get; }

}

public class HttpResponse

{

    public  NameValueCollection Headers { get; }

    public  Stream Body { get; }

    public int StatusCode { getset;}

}

  我们知道一个Http事务包括最核心的Request(输入)和Response(输出),所以HttpContext包含这两个核心的东西。

  老A建议大家从管道的角度来理解该对象的作用,管道和HTTP请求流程一脉相承。在Server接收到请求后,HttpContext被创建。

  在服务器和中间件,中间件之间通过什么来传递信息?就是共享上下文,这个上下文就是HttpContext。可以说HttpContext是根据HTTP请求原理包裹的在管道之间的共享的一个上下文对象。

  为什么这里要把HttpContext放在第一个来介绍,因为这是一个最基础的对象。这7大对象的讲解顺序,我感觉是从底层基础开始讲起,再层层往上,最后到WebHostBuilder。

640?wx_fmt=png


2.RequestDelegate


  这个委托太重要了,和HttpContext一样,老A建议大家从管道的角度来理解这个委托。我们再复习一下管道的含义,如图所示:

640?wx_fmt=png

  这里的管道:Pipeline = Server + Middlewares

  还能更简单一点吗?可以的:如下图所示

640?wx_fmt=png

  这里的管道:Pipeline =Server + HttpHandler

  多个Middlewares构成一个HttpHandler对象,这是整个管道的核心,那么应该如何用代码来表示呢?

  老A讲到:“既然针对当前请求的所有输入和输出都通过HttpContext来表示,那么HttpHandler就可以表示成一个Action<HttpContext>对象”。

  但是由于ASP.NET Core推崇异步编程,所以你应该想得到Task对象,那么HttpHandler自然就可以表示为一个Func<HttpContext,Task>对象。由于这个委托对象实在太重要了,所以我们将它定义成一个独立的类型。下图展示的就是整个RequestDelegate的设计思路

640?wx_fmt=png

1

public delegate Task RequestDelegate(HttpContext context);

  这就是委托的由来!

  • 为什么是委托,而不是别的函数?

  委托是架构设计的底层技术,非常常见。因为委托可以承载约定的函数,遵循开闭原则,能很好的把扩展对外进行开放,保证了底层架构的稳定性。


3.Middleware


  这个对象比较费解。根据源码我们知道Middleware也是一个委托对象(代码如下所示),中间件其实就是一个Func<RequestDelegateRequestDelegate>对象:

1

private readonly List<Func<RequestDelegate, RequestDelegate>> _middlewares = new List<Func<RequestDelegate, RequestDelegate>>();

  该对象的输入和输入都是RequestDelegate,为什么要这么设计呢?我们想一下,当前中间件处理完成后需要将请求分发给后续中间件进行处理,他如何让后续的中间件参与当前的请求呢?所以他必须要拿到代表后续中间件管道构成的那个Handler。

如下图所示,也就是说,后续三个中间件构成的管道就是一个输入,执行完毕后,当前中间件也将被“融入”这个管道(此时该新管道就会由四个中间件构成的一个委托链),然后再输出给你由所有的中间件构成的新管道。如下图所示:

640?wx_fmt=png

4.ApplicationBuilder

  这又是一个builder,可见builder模式在ASP.NET Core有非常广泛的应用。但是该Builder构建的不是Application,到构建什么内容呢?从下面代码声明我们可以看到他有两个功能。

  从Use的使用来看,第一个功能是注册器,他把一个个中间件串联成一个管道。


public interface  IApplicationBuilder

{

    IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware);

    RequestDelegate Build();

}

  第二个功能是Build,如下所示:


public class ApplicationBuilder : IApplicationBuilder

{

    private readonly List<Func<RequestDelegate, RequestDelegate>> _middlewares = new List<Func<RequestDelegate, RequestDelegate>>();

    public RequestDelegate Build()

    {

        _middlewares.Reverse();

        return httpContext =>

        {

            RequestDelegate next = _ => { _.Response.StatusCode = 404; return Task.CompletedTask; };

            foreach (var middleware in _middlewares)

            {

                next = middleware(next);

            }

            return next(httpContext);

        };

    }

    public IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware)

    {

        _middlewares.Add(middleware);

        return this;

    }

}

  Build真正做的事情是循环组装中间件,最后把组装好的委托链进行返回。从_middlewares.Reverse();我们又可以知道,对于委托链来说,中间件的注册顺序和执行顺序是相反的,这里需要进行反转,然后才能保证先注册的中间件先执行。


5.Server


Server对象相对比较简单,我们看下他的接口定义:


public interface IServer

{

    Task StartAsync(RequestDelegate handler);

}

  我们可以看到Server有个启动函数StartAsync,StartAsync内部封装了RequestDelegate中间件,同时内部也会new一个HttpContext(features),这样Server、RequestDelegate、HttpContext三者就全部聚齐了。


public class HttpListenerServer : IServer

{

    private readonly HttpListener _httpListener;

    private readonly string[] _urls;

    public HttpListenerServer(params string[] urls)

    {

        _httpListener = new HttpListener();

        _urls = urls.Any()?urls: new string[] { "http://localhost:5000/"};

    }

    public async Task StartAsync(RequestDelegate handler)

    {

        Array.ForEach(_urls, url => _httpListener.Prefixes.Add(url));   

        _httpListener.Start();

        Console.WriteLine("Server started and is listening on: {0}"string.Join(';', _urls));

        while (true)

        {

            var listenerContext = await _httpListener.GetContextAsync();

         Console.WriteLine("{0} {1} HTTP/{2}",

                    listenerContext.Request.HttpMethod,

                    listenerContext.Request.RawUrl,

                    listenerContext.Request.ProtocolVersion);

                var feature = new HttpListenerFeature(listenerContext);

                var features = new FeatureCollection()

                    .Set<IHttpRequestFeature>(feature)

                    .Set<IHttpResponseFeature>(feature);

                var httpContext = new HttpContext(features);

                Console.WriteLine("[Info]: Server process one HTTP request start.");

                await handler(httpContext);

                Console.WriteLine("[Info]: Server process one HTTP request end.");

                listenerContext.Response.Close();

        }

    }

}

public static partial class Extensions

{

    public static IWebHostBuilder UseHttpListener(this IWebHostBuilder builder, params string[] urls)

    => builder.UseServer(new HttpListenerServer(urls));

  通过以上代码分析,我们可以画个图做总结:

640?wx_fmt=png

  • 适配器模式

由于ASP.NET Core可以支持不同的WebServer,比如Kestrel和IIS,不同的WebServer返回的HttpContext各不相同,所以这里又增加了一个中间层进行适配。这个中间层是什么呢?如下图所示,就是IRequestFeature和IResponseFeature。这一层是典型的适配器模式。

640?wx_fmt=png

  这里重点讲解的7大对象,这个适配器模式的实现细节暂且略过。

 6.WebHost


public interface IWebHost

{

    Task StartAsync();

}

  根据这段定义,我们只能知道简单知道WebHost只要是用来启动什么对象用的,具体什么对象似乎都可以。直到我们看了实现,如下代码所示:


public class WebHost : IWebHost

{

    private readonly IServer _server;

    private readonly RequestDelegate _handler;

    public WebHost(IServer server, RequestDelegate handler)

    {

        _server = server;

        _handler = handler;

    }

    public Task StartAsync() => _server.StartAsync(_handler);

}

  通过StartAsync,我们知道WebHost是用来启动管道的中间件的,管道是在作为应用宿主的WebHost对象启动的时候被构建出来的。

  而WebHost是如何被创建的呢?接下来就要讲他的父亲WebHostBuilder

7.WebHostBuilder


public class WebHostBuilder : IWebHostBuilder

{

    private IServer _server;

    private readonly List<Action<IApplicationBuilder>> _configures = new List<Action<IApplicationBuilder>>();  

    public IWebHostBuilder Configure(Action<IApplicationBuilder> configure)

    {

        _configures.Add(configure);

        return this;

    }

    public IWebHostBuilder UseServer(IServer server)

    {

        _server = server;

        return this;

    }  

    public IWebHost Build()

    {

        var builder = new ApplicationBuilder();

        foreach (var configure in _configures)

        {

            configure(builder);

        }

        return new WebHost(_server, builder.Build());

    }

}

  我们看到该对象有个Build方法,内部返回一个WebHost对象,这就是父亲的职责,负责生娃,他的娃就是WebHost。生出来的时候,给孩子一个ApplicationBuilder作为食物。而这个食物其实是包裹起来的,展开来看就是一个个RequestDelegate委托链。


public interface IWebHostBuilder

{

    IWebHostBuilder UseServer(IServer server);

    IWebHostBuilder Configure(Action<IApplicationBuilder> configure);

    IWebHost Build();

}

  父亲除了创建WebHost之外,他还提供了注册服务器的UseServer方法和用来注册中间件的Configure方法。说到Configure方法,我们一定还记得ApplicationBuilder方法的Use也是一个注册器。这两个注册器有何不同呢?我们对比一下代码:

  • WebHostBuilder


public IWebHostBuilder Configure(Action<IApplicationBuilder> configure)

{

    _configures.Add(configure);

    return this;

}

  • ApplicationBuilder


public IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware)

{

    _middlewares.Add(middleware);

    return this;

}

  其中Use只是增加一个中间件,Configure输入的是中间件构成的委托链。我们看下入口函数的代码就知道了:


public static async Task Main()

{

    await new WebHostBuilder()

        .UseHttpListener()

        .Configure(app => app

            .Use(FooMiddleware)

            .Use(BarMiddleware)

            .Use(BazMiddleware))

        .Build()

        .StartAsync();

}

参加文章:

  • 深入研究 Mini ASP.NET Core

  • 一个Mini的ASP.NET Core框架的实现

  • 200行代码,7个对象——让你了解ASP.NET Core框架的本质

原文地址:https://www.cnblogs.com/jackyfei/p/10838586.html

.NET社区新闻,深度好文,欢迎访问公众号文章汇总 http://www.csharpkit.com 
640?wx_fmt=jpeg

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/315977.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Mono和.NET Core 从比翼双飞到合体

.NET 开源之路就是 Mono和.NET Core 从比翼双飞到合体&#xff1a;2001年12月-2002年2月。一个新的平台诞生了。与惠普、英特尔和其他公司一起, 创建了 ECMA-335 标准, 该标准定义了支持多种编程语言的公共语言基础结构&#xff0c;C# 和 Visual Basic. Net。 F # 于2007年晚些…

Skywalking部署常见问题以及注意事项

Skywalking部署常见问题以及注意事项IntroSkyWalking 创建与2015年&#xff0c;提供分布式追踪功能。从5.x开始&#xff0c;项目进化为一个完成功能的Application Performance Management系统。他被用于追踪、监控和诊断分布式系统&#xff0c;特别是使用微服务架构&#xff0c…

GitHub推出包管理服务,npm与Nuget全支持

GitHub 今天推出了一项名为 GitHub Package Registry 的新产品&#xff0c;它提供了软件包管理服务&#xff0c;开发者通过它可发布公共或私有软件包。官方介绍&#xff0c;GitHub Package Registry 完全集成在 GitHub 中&#xff0c;因此和 repo 一样&#xff0c;用户可以使用…

发布dotNetCore程序到Kubernetes

上一篇《Mac中搭建Kubernetes》介绍了怎样在Mac中搭建单节点的Kubernetes&#xff0c;本文将编写一个dotNetCore的示例程序&#xff0c;并发布到Kubernetes中。环境基本步骤创建dotnetCore示例项目&#xff1b;本地搭建私有registry&#xff0c;或者使用DockerHub&#xff0c;本…

[Cake] 2. dotnet 全局工具 cake

在上篇博客[Cake] 1. CI中的Cake中介绍了如何在CI中利用Cake来保持与CI/CD环境的解耦。当时dotnet 2.1还未正式发布&#xff0c;dotnet 还没有工具的支持&#xff0c;使得安装cake非常麻烦。不过随着 dotnet tool 的加入&#xff0c;这一问题得到了很好的解决。目前安装cake&am…

官博翻译 | .NET Core 即 .NET 的未来

点击上方蓝字关注“汪宇杰博客”文 / Scott Hunter译 / 汪宇杰我们在2014年11月推出了.NET Core 1.0。.NET Core 的目标是借鉴我们过去12年构建、发布和服务.NET Framework的经验去构建更好的产品。这些改进如&#xff1a;并行安装&#xff08;您可以安装新版本&#xff0c;而…

微软发布ML.NET 1.0,可一键添加机器学习模型

今天&#xff0c;我们很高兴宣布发布 ML.NET 1.0。ML.NET 是一个免费的、跨平台的开源机器学习框架&#xff0c;旨在将机器学习&#xff08;ML&#xff09;的强大功能引入.NET 应用程序。ML.NET GitHub&#xff1a;https://github.com/dotnet/machinelearning入门 http://dot.…

目前下载VS2017你可能会遇到这个坑

可能现在大伙都已经开始使用VS2019进行开发了。VS2019的下载使用也都很简单。由于工作需要&#xff0c;今天要在笔记本上安装VS2017,结果发现&#xff0c;VS2017的下载变得不是那么容易了&#xff0c;官方的下载方式也隐藏的很深&#xff0c;来来回回折腾了好一会才下载下来&am…

代码整洁之道(Clean Code)- 读书笔记

Sorry, 许久未更新文章了&#xff0c;主要因为刚刚换了一家新公司&#xff0c;忙于组建团队&#xff08;建设、招聘、流程、框架等&#xff09;与熟悉公司业务&#xff0c;还有领导给的其他工作等等&#xff0c;实在是没有时间更新了。最近在和团队分享Bob大叔的《Clean Code》…

微软Build 2019大会.NET课程视频汇总

点击上方蓝字关注“汪宇杰博客”5月6日至8日&#xff0c;微软在西雅图召开了Build 2019开发者大会。我们关注的.NET领域也迎来了许多激动人心的改进。本文汇总了Build 2019大会上关于.NET的已经公开的视频&#xff0c;欢迎大家观看学习&#xff01;// 注意&#xff1a;以下视频…

黑科技抢先尝 | Windows全新终端初体验(附代码Build全过程)

微软在几天前的build大会上展示了Windows Terminal的威力&#xff0c;由于官宣要在6月中旬才上Microsoft store&#xff0c;还有一个多月要等呢。好在代码已公布在 github, 于是决定自己 build 后体验一番。遇到不少坑&#xff0c;大概整理一下流程&#xff0c;分享给大家。如果…

aelf帮助C#工程师10分钟零门槛搭建DAPP私有链开发环境

aelf是一个可扩展的去中心化云计算区块链平台&#xff0c;支持高性能合约并行执行、原生多链数据交互、存储使用高性能分布式数据库。aelf整个系统可以在windows、osx及linux运行&#xff0c;团队在osx环境下开发&#xff0c;基于.net core DAPP开发1.安装.net core及protobufh…

Build 2019 上微软的开源动作有点不一样

微软今年举办的 Build 开发者大会可谓是抢足风头&#xff0c;大会第一天就放了不少大招&#xff1a;宣布新的命令行终端 Windows Terminal、Windows 10 的 Linux 子系统 WSL 2 将运行真正的 Linux 内核、跳过 .NET 4 宣布 .NET 5 的计划、宣布 Web 版本的 VS Code (Visual Stud…

P1437 [HNOI2004]敲砖块

P1437 [HNOI2004]敲砖块 题意&#xff1a; 在一个凹槽中放置了 n 层砖块、最上面的一层有 n 块砖&#xff0c;从上到下每层依次减少一块砖。每块砖都有一个分值&#xff0c;敲掉这块砖就能得到相应的分值&#xff0c;如下图所示&#xff1a; 14 15 4 3 2333 33 76 22 …

在kubernetes 集群内访问k8s API服务

所有的 kubernetes 集群中账户分为两类&#xff0c;Kubernetes 管理的 serviceaccount(服务账户) 和 useraccount&#xff08;用户账户&#xff09;。基于角色的访问控制&#xff08;“RBAC”&#xff09;使用“rbac.authorization.k8s.io”API 组来实现授权控制&#xff0c;允…

.NET Core之只是多看了你一眼

技术学习是一件系统性的事情&#xff0c;如果拒绝学习&#xff0c;那么自己就会落后以至于被替代。.NET也是一样&#xff0c;当开源、跨平台成为主流的时候&#xff0c;如果再故步自封&#xff0c;等待.NET的就是死路一条&#xff0c;幸好.NET Core问世了&#xff0c;社区反响积…

TOTP 介绍及基于 C# 的简单实现

TOTP 介绍及基于 C# 的简单实现IntroTOTP 是基于时间的一次性密码生成算法&#xff0c;它由 RFC 6238 定义。和基于事件的一次性密码生成算法不同 HOTP&#xff0c;TOTP 是基于时间的&#xff0c;它和 HOTP 具有如下关系&#xff1a;TOTP HOTP(K, T)HOTP(K,C) Truncate(HMAC-…

微软携手红帽,共筑开源新未来

官宣了&#xff0c;官宣了&#xff01;微软携手红帽正式推出重要力作Global Azure 公有云第一款联合管理的 OpenShift 产品&#xff0c;业界欢腾&#xff01;自此&#xff0c;微软在拥抱云计算开源之路上&#xff0c;多了一股强劲的推动力。5月初刚刚举办的全球 Red Hat Summit…

.NET Core 3.0之深入源码理解Startup的注册及运行

开发.NET Core应用&#xff0c;直接映入眼帘的就是Startup类和Program类&#xff0c;它们是.NET Core应用程序的起点。通过使用Startup&#xff0c;可以配置化处理所有向应用程序所做的请求的管道&#xff0c;同时也可以减少.NET应用程序对单一服务器的依赖性&#xff0c;使我们…

置换群,Polya引理和burnside引理(等价类计数问题)

参考文章&#xff1a; 等价类计数问题 Burnside引理&Plya定理 Burnside引理与Polya定理 置换群和Burnside引理&#xff0c;Polya定理 概念引入&#xff1a; 离散数学应该学过置换群的相关概念&#xff0c;置换本质就是映射&#xff0c;可以理解成一个正方形绕其中心逆时针…