ASP.NET Core的请求处理管道由一个服务器和一组中间件组成,位于 "龙头" 的服务器负责请求的监听.接收.分发和最终的响应,针对请求的处理由后续的中间件来完成.中间件最终体现为一个Func<RequestDelegate, RequestDelegate>委托,但是我们具有不同的定义和注册方式.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1505]以Func<RequestDelegate, Request…

ASP.NET Core应用具有很多读取文件的场景,如读取配置文件.静态Web资源文件(如CSS.JavaScript和图片文件等).MVC应用的视图文件,以及直接编译到程序集中的内嵌资源文件.这些文件的读取都需要使用一个IFileProvider对象.IFileProvider对象构建了一个抽象的文件系统,我们不仅可以利用该系统提供的统一API来读取各种类型的文件,还能及时监控目标文件的变化.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S401] 输出…

.NET的配置支持多样化的数据源,我们可以采用内存的变量.环境变量.命令行参数.以及各种格式的配置文件作为配置的数据来源.在对配置系统进行系统介绍之前,我们通过几个简单的实例演示一下如何将具有不同来源的配置数据构建为一个统一的配置对象,并以相同的方式读取具体配置节的内容.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [501]以键值对形式读取配置(源代码) [502]读取结构化配置(源代码) [503]将结构化配置绑定为对象(源代码) [504]将配置定义在…

我们倾向于将IConfiguration对象转换成一个具体的对象,以面向对象的方式来使用配置,我们将这个转换过程称为配置绑定.除了将配置树叶子节点配置节的绑定为某种标量对象外,我们还可以直接将一个配置节绑定为一个具有对应结构的符合对象.除此之外,配置绑定还支持针对数据.集合和字典类型的绑定.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [507]绑定配置项的值(源代码) [508]类型转换器在配置绑定中的应用(源代码) [509]复合对象的配置绑定(源代码)…

依赖注入使我们可以将依赖的功能定义成服务,最终以一种松耦合的形式注入消费该功能的组件或者服务中.除了可以采用依赖注入的形式消费承载某种功能的服务,还可以采用相同的方式消费承载配置数据的Options对象,这篇文章演示几种典型的编程模式.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [601]将配置绑定为Options对象(源代码) [602]具名Options的注册和提取(源代码) [603]Options与配置源的实时同步(匿名Options)(源代码)…

在整个软件开发维护生命周期内,最难的不是如何将软件系统开发出来,而是在系统上线之后及时解决遇到的问题.一个好的程序员能够在系统出现问题之后马上定位错误的根源并找到正确的解决方案,一个更好的程序员能够根据当前的运行状态预知未来可能发生的问题,并将问题扼杀在摇篮中.合理地利用诊断手段能够帮助我们有效地纠错和排错.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S701]TraceSource跟踪日志(源代码) [S702]基于等级的日志过滤(源代码) [S703…

一个好的程序员能够在系统出现问题之后马上定位错误的根源并找到正确的解决方案,一个更好的程序员能够根据当前的运行状态预知未来可能发生的问题,并将问题扼杀在摇篮中.诊断跟踪能够帮助我们有效地纠错和排错<几种基本诊断跟踪编程方式>提供了7个实例演示了针对TraceSource.EventSource和DiagnosticSource的基本用法,其实它们还具有一个更"高级"的使用方式.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S…

<诊断跟踪的几种基本编程方式>介绍了四种常用的诊断日志框架.其实除了微软提供的这些日志框架,还有很多第三方日志框架可供我们选择,比如Log4Net.NLog和Serilog 等.虽然这些框架大都采用类似的设计,但是它们采用的编程模式具有很大的差异.为了对这些日志框架进行整合,微软创建了一个用来提供统一的日志编程模式的日志框架.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S801]将日志输出到控制台和调试窗口(源代码) [S802]利用ILog…

为了对各种日志框架进行整合,微软创建了一个用来提供统一的日志编程模式的日志框架.<日志的基本编程模式>以实例演示的方式介绍了日志的基本编程模式,现在我们来补充几种"进阶"用法.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S808]利用配置定义日志过滤规则(源代码) [S809]利用日志范围输出调用链(源代码) [S810]LoggerMessage的应用(源代码) [S812]基于Activity的日志范围(源代码) [S…

针对控制台的ILogger实现类型为ConsoleLogger,对应的ILoggerProvider实现类型为ConsoleLoggerProvider,这两个类型都定义在 NuGet包"Microsoft.Extensions.Logging.Console"中.ConsoleLogger要将一条日志输出到控制台上,首选要解决的是格式化的问题,具体来说是如何将日志消息的内容荷载和元数据(类别.等级和事件ID等)格式化成呈现在控制台上的文本.针对日志的格式化由ConsoleFormat…

.NET提供了两个独立的缓存框架,一个是针对本地内存的缓存,另一个是针对分布式存储的缓存.前者可以在不经过序列化的情况下直接将对象存储在应用程序进程的内存中,后者则需要将对象序列化成字节数组并存储到一个独立的"中心数据库".对于分布式缓存,.NET提供了针对Redis和SQL Server的原生支持.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1101]基于内存的本地缓存(源代码) [S1102]基于Redis的分布式缓存(源代码)…

在一个采用依赖注入框架的应用中,我们一般不太推荐利用手工创建的HttpClient对象来进行HTTP调用,使用的HttpClient对象最好利用注入的IHttpClientFactory工厂来创建.前者引起的问题,以及后者带来的好处,将通过如下这几个演示程序展现出来.IHttpClientFactory类型由"Microsoft.Extensions.Http"这个NuGet包提供,"Microsoft.NET.Sdk.Web"SDK具有该包的默认引用.如果采用&q…

我们知道ASP.NET的核心就是由中间件组成的请求处理管道,HttpClient也采用了类似的设计.HttpClient管道由一组HttpMessageHandler对象构成,这些HttpMessageHandler相当于ASPNET的中间件.如下这些示例演示帮助我们更清楚地认识HttpMessageHandler处理管道.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1208]HttpClient的默认管道结构(源代码) [S1209]定制HttpCl…

数据保护(Data Protection)框架旨在解决数据在传输与持久化存储过程中的一致性(Integrity)和机密性(confidentiality)问题,前者用于检验接收到的数据是否经过篡改,后者通过对原始的数据进行加密以避免真实的内容被人窥视.数据保护是支撑ASP.NET身份认证的一个重要的基础框架,同时也可以作为独立的框架供我们使用.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1301]数据的加解密(源代码) [S1302]Purpose字符…

借助 .NET提供的服务承载(Hosting)系统,我们可以将一个或者多个长时间运行的后台服务寄宿或者承载我们创建的应用中.任何需要在后台长时间运行的操作都可以定义成标准化的服务并利用该系统来承载,ASP.NET Core应用最终也体现为这样一个承载服务.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1401]利用承载服务收集性能指标(源代码) [S1402]依赖注入的应用(源代码) [S1403]配置选项的应用(源代码)[S1404]提供针对环境的配置…

借助 .NET提供的服务承载(Hosting)系统,我们可以将一个或者多个长时间运行的后台服务寄宿或者承载我们创建的应用中.任何需要在后台长时间运行的操作都可以定义成标准化的服务并利用该系统来承载,ASP.NET Core应用最终也体现为这样一个承载服务.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1407]利用IHostApplicationLifetime对象关闭应用(源代码) [S1408]与第三方依赖注入框架的整合(源代码) [S1409]利用…

ASP.NET Core应用本质上就是一个由中间件构成的管道,承载系统将应用承载于一个托管进程中运行起来,其核心任务就是将这个管道构建起来.从设计模式的角度来讲,"管道"是构建者(Builder)模式最典型的应用场景,所以ASP.NET Core先后采用的三种承载方式都是采用这种模式.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [S1501]基于IWebHost/IWebHostBuilder的应用承载方式(源代码) [S1502]将初…

与服务注册一样,针对配置的设置同样可以采用三种不同的编程模式.第一种是利用WebApplicationBuilder的Host属性返回的IHostBuilder对象,它可以帮助我们设置面向宿主和应用的配置.IWebHostBuilder接口上面同样提供了一系列用来对配置进行设置的方法,我们可以将这些方法应用到WebApplicationBuilder的WebHost属性返回的IWebHostBuilder对象上.不过还是那句话,既然推荐使用Mininal API,最好还是采用最新的编程方式.(本…

很多人可能对ASP.NET Core框架自身记录的诊断日志并不关心,其实这些日志对纠错排错和性能监控提供了很有用的信息.如果需要创建一个APM(Application Performance Management)系统来监控ASP.NET Core应用处理请求的性能及出现的异常,我们完全可以将HostingApplication对象记录的日志作为收集的原始数据.实际上,目前很多APM(如OpenTelemetry.NET .Elastic APM和SkyWalking APM等)针对都是利用这种…

作为ASP.NET Core请求处理管道的"龙头"的服务器负责监听和接收请求并最终完成对请求的响应.它将原始的请求上下文描述为相应的特性(Feature),并以此将HttpContext上下文创建出来,中间件针对HttpContext上下文的所有操作将借助于这些特性转移到原始的请求上下文上.学习ASP.NET Core框架最有效的方式就是按照它的原理"再造"一个框架,了解服务器的本质最好的手段就是试着自定义一个服务器.现在我们自定义一个真正的服务器.在此之前,我们再…

通过HTTP请求获取的Web资源很多都来源于存储在服务器磁盘上的静态文件.对于ASP.NET应用来说,如果将静态文件存储到约定的目录下,绝大部分文件类型都是可以通过Web的形式对外发布的."Microsoft.AspNetCore.StaticFiles" 这个NuGet包中提供了三个用来处理静态文件请求的中间件,我们可以用它们搭建一个文件服务器.(本篇提供的实例已经汇总到<ASP.NET Core 6框架揭秘-实例演示版>) [1901]以Web形式发布文件(图片)(源代…

由于ASP.NET是一个同时处理多个请求的Web应用框架,所以在处理某个请求过程中出现异常并不会导致整个应用的中止.出于安全方面的考量,为了避免敏感信息外泄,客户端在默认情况下并不会得到详细的出错信息,这无疑会在开发过程中增加查错和纠错的难度.对于生产环境来说,我们也希望最终用户能够根据具体的错误类型得到具有针对性并且友好的错误消息.ASP.NET提供的相应的中间件可以帮助我们将定制化的错误信息呈现出来.本文提供的示例演示已经同步到<ASP.NET Core 6框架揭秘-实例演示版>) 目录[…

NuGet包"Microsoft.AspNetCore.Diagnostics"中提供了几个与异常处理相关的中间件,我们可以利用它们将原生的或者定制的错误信息作为响应内容发送给客户端.<错误页面的N种呈现方式>演示了几个简单的实例使读者大致了解这些中间件的作用,现在我们来演示几个高阶用法.本文提供的示例演示已经同步到<ASP.NET Core 6框架揭秘-实例演示版>) [S2108]利用IDeveloperPageExceptionFilter定制开发者异常页…

我们利用ASP.NET开发的大部分API都是为了对外提供资源,对于不易变化的资源内容,针对某个维度对其实施缓存可以很好地提供应用的性能.<内存缓存与分布式缓存的使用>介绍的两种缓存框架(本地内存缓存和分布式缓存)为我们提供了简单易用的缓存读写编程模式,本篇介绍的则是针对针对HTTP响应内容实施缓存,ResponseCachingMiddleware中间件赋予我们的能力(本文提供的示例演示已经同步到<ASP.NET Core 6框架揭秘-实例演示版>). 目录[S2201]基于路径的…

客户端和服务器基于HTTP的消息交换就好比两个完全没有记忆能力的人在交流,每次单一的HTTP事务体现为一次"一问一答"的对话.单一的对话毫无意义,在在同一语境下针对某个主题进行的多次对话才会有结果.会话的目的就是在同一个客户端和服务器之间建立两者交谈的语境或者上下文,ASP.NET Core利用一个名为SessionMiddleware的中间件实现了会话.本篇提供了几个简单的实例来演示如何在一个ASP.NET Core应用中利用会话来存储用户的状态.(本文提供的示例演示已经同步到<…

作为<ASP.NET Core 3框架揭秘>的升级版,<ASP.NET Core 6框架揭秘>提供了很多新的章节,同时对现有的内容进行大量的修改.虽然本书旨在对ASP.NET Core框架的架构设计和实现原理进行剖析,但是其中提供的258个实例演示却可以作为入门材料,这个系列会将这些演示实例单独提取出来并进行汇总.对于想学习ASP.NET Core的同学,如果你觉得没有必要"砖的这么深",倒是可以看看.本片提供的20个简单的演示实例基本涵盖了ASP.NET Co…

由于依赖注入具有举足轻重的作用,所以<ASP.NET Core 6框架揭秘>的绝大部分章节都会涉及这一主题.本书第3章对.NET原生的依赖注入框架的设计和实现进行了系统的介绍,其中设计一些"鲜为人知"的细节,其中一部分就体现在本篇提供的这几个实例演示上. [308]构造函数的选择(成功)(源代码) [309]构造函数的选择(失败)(源代码) [310]IDisposable和IAsyncDisposable接口的差异(错误编程)(源代码) [311]IDisposable和…

作为<ASP.NET Core 3框架揭秘>的升级版,<ASP.NET Core 6框架揭秘>提供了很多新的章节,同时对现有的内容进行大量的修改.虽然本书旨在对ASP.NET Core框架的架构设计和实现原理进行剖析,但是其中提供的258个实例演示却可以作为入门材料,这个系列会将这些演示实例单独提取出来并进行汇总.对于想学习ASP.NET Core的同学,如果你觉得本书过于深入,读起来稍显吃力,可以看看.如果你对<ASP.NET Core 6框架揭秘>有兴趣,可以加入本…

ASP.NET Core可以视为一种底层框架,它为我们构建出了基于管道的请求处理模型,这个管道由一个服务器和多个中间件构成,而与路由相关的EndpointRoutingMiddleware和EndpointMiddleware是两个最为重要的中间件.MVC和gRPC开发框架就建立在路由基础上.本篇提供了四个实例用来演示如何利用路由.MVC和gRPC来开发API/APP. [113]路由的应用(源代码) [114]开发MVC API(源代码) [115]开发MVC APP(源代码) [116]开发…

也许你们可能没有接触过Dapr,但是一定对它"有所耳闻",感觉今年它一下子就火了,一时间很多人都在谈论它.我们从其命名(Dapr的全称是"分布式应用运行时Distributed Application Runtime")可以看出Dapr的定位,它并不是分布式应用的开发框架,它提供的是更底层的"运行时".我们可以使用不同的编程语言,采用不同的开发框架在这个由Dapr提供的运行时上面构建分布式应用.我们接下来就来感受一下Dapr在.NET上面的开发体…