
本书主要介绍ASP.NET Core框架最核心的部分,即由一个服务器和若干中间件构建的管道。本书共分为5篇:"第1篇 初识编程(第1章)”列举一系列极简的实例为读者提供基本的编程体验,"第2 篇 基础框架(第2~13章)”主要介绍了一系列支撑ASP.NET Core的基础框架,"第3篇 承载系统(第14~17章)”主要介绍了ASP.NET Core应用的承载流程,"第4篇 服务器概述(第18章)”列举一系列常见的服务器类型并对它们进行了比较,"第5 篇 中间件(第19~30章)”系统地介绍了一系列预定义的中间件。
前 言 写作源起 .NET Core 的发展印证了那句老话 “合久必分,分久必合”。 .NET 的诞生可以追溯到 1999 年,那年微软正式启动 .NET 项目。大约六七年前,当 .NET 似乎快要走到尽头时,.NET Core 作为一个分支被独立出来。经过了 3 个主要版本的迭代,.NET Core 俨然已经长成一棵参天大树。 随着 .NET 5 的推出,.NET Framework 和 .NET Core 又重新被整合到一起。与其说 .NET Core 重新回到了 .NET 的怀抱,还不如说 .NET Core “收编”了原来的“残余势力”,自己成为“正统”。 一统江湖的 .NET 5 的根基,在下一个版本( .NET 6)中得到了进一步巩固,今后的 .NET Core 将以每年更新一个版本的节奏稳步向前推进。 目前,还没有哪个技术平台像 .NET Core 这样提供了如此完备的技术栈,桌面、Web、云、移动、游戏、IoT 和 AI 相关开发都可以在这个平台上完成。在列出的这七大领域中,面向应用的Web 开发依然占据了市场的半壁江山,为其提供支撑的 ASP.NET Core 的重要性就毋庸置疑了。 Web 应用可以采用不同的开发模式,如 MVC、gRPC、Actor Model、GraphQL、Pub/Sub 等,它们都有对应的开发框架予以支持。虽然编程模式千差万别,开发框架也琳琅满目,但是底层都需要解决一个核心问题,那就是请求的接收、处理和响应,而这个基础功能就是在 ASP.NET Core 中实现的。从这个角度来讲,ASP.NET Core 是介于 .NET 基础框架和各种 Web 开发框架之间的中间框架。 在前 .NET 时代( .NET Core 诞生之前),计算机图书市场存在一系列介绍 ASP.NET Web Forms、ASP.NET MVC、ASP.NET Web API 的图书。但是找不到一本专门介绍 ASP.NET 自身框架的图书。作为一名拥有近 20 年工作经验的 .NET 开发者,我对此感到十分困惑。上述这些Web 开发框架都是建立在 ASP.NET 框架之上的,底层的 ASP.NET 框架才是根基所在。过去我接触过很多资深的 ASP.NET 开发人员,发现他们对 ASP.NET 框架都没有进行更深入的了解。 2014 年,出版《ASP.NET MVC 5 框架揭秘》之后,我原本打算撰写《ASP.NET 框架揭秘》。后I来.NET Core 横空出世,我的研究方向也随之转移,于是就有了在 2019 年出版的《ASP.NET Core 3 框架揭秘》。 在 .NET 5 发布之前,我准备将这本书进行相应的升级。按照微软公布的版本差异,我觉得升级到《ASP.NET 5 框架揭秘》应该不会花费太多时间和精力,但后来的事实证明我的想法太天真了。由于这本书主要介绍的是 ASP.NET 框架的内部设计和实现,版本之间涉及的很多变化并未“记录在案”,只能通过阅读源代码的方式去发掘。本着宁缺毋滥的原则,我放弃了撰写《ASP.NET 5 框架揭秘》。现在看来这是一个明智的决定,因为 ASP.NET Core 6 是稳定的长期支持版本。另外,我也有了相对充裕的时间逐个确认书中涉及的每个特性在新版本中是否发生了变化,并进行了相应的修改,删除陈旧的内容,添加新的特性。 对于升级后的《ASP.NET Core 6 框架揭秘》,一个全局的改动就是全面切换到基于 Minimal API 的编程模式上。升级后的版本添加了一系列新的章节,如“第 10 章 对象池”“第 12 章 HTTP 调用”“第 13 章 数据保护”“第 18 章 服务器”“第 24 章 HTTPS 策略”“第 25 章 重定向”“第 26 章 限流”等。由于篇幅的限制,不得不删除一些“不那么重要”的章节。 本书内容 《ASP.NET Core 6 框架揭秘》只关注 ASP.NET Core 框架最核心的部分,即由一个服务器和若干中间件构建的管道,除了“第 1 章 编程体验”,其他章节基本上都不会涉及上层的编程框架。本书共分为以下 5 篇内容。 ● 初始编程 第 1 章提供了 20 个极简的 Hello World 应用程序,带领读者感受一下 ASP.NET Core 的编程体验。这些演示实例涉及基于命令行的应用创建和 Minimal API 的编程模式,还涉及多种中间件的定义及配置选项和诊断日志的应用。第 1 章还演示了如何利用路由、MVC 和 gRPC 开发 Web 应用和 API,4 种针对 Dapr 的应用开发模型也包含在这 20 个演示实例中。 ● 基础框架 ASP.NET Core 建立在一系列基础框架之上,这些独立的框架在日常的应用开发中同样被广泛地使用。第 2 篇提供的若干章节对这些基础框架进行了系统而详细的介绍,其中包括“第 2~3 章 依赖注入”“第 4 章 文件系统”“第 5~6 章 配置选项”“第 7~9 章 诊断日志”“第 10 章 对象池”“第 11 章 缓存”“第 12 章 HTTP 调用”“第 13 章 数据保护”。 ● 承载系统 ASP.NET Core 应用作为一个后台服务寄宿于服务承载系统中,“第 14 章 服务承载”主要对该承载系统进行了详细介绍。ASP.NET Core 应用的承载是本书最核心的部分,“第 15~17 章 应用承载(上、中、下)”不仅对 ASP.NET Core 请求处理管道的构建和应用承载的内部流程进行了详细介绍,还对 Minimal API 的编程模型和底层的实现原理进行了详细介绍。 ● 服务器概述 本书所有内容都围绕着 ASP.NET Core 请求处理管道,该管道由一个服务器和若干中间件构建。第 18 章主要对服务器的系统进行了介绍,不仅会详细介绍 Kestrel 服务器的使用和实现原理,还会介绍基于 IIS 的两种部署模式和 HTTP.SYS 的使用,以及如何自定义服务器类型。 ● 中间件 服务器接收的请求会分发给中间件管道进行处理。本篇对大部分中间件的使用和实现原理进行了介绍,其中包括“第 19 章 静态文件”“第 20 章 路由”“第 21 章 异常处理”“第 22 章 响应缓存”“第 23 章 会话”“第 24 章 HTTPS 策略”“第 25 章 重定向”“第 26 章 限流”“第 27 章 认证”“第 28 章 授权”“第 29 章 跨域资源共享”“第 30 章 健康检查”。 写作特点 《ASP.NET Core 6 框架揭秘》是揭秘系列的第 6 本书。在这之前,我得到了很多热心读者的反馈,这些反馈对书中的内容基本上都持正面评价,但对写作技巧和表达方式的评价则不尽相同。 每个作者都有属于自己的写作风格,而每个读者的学习思维方式也不尽相同,两者很难出现百分之百的契合,但我还是决定在《ASP.NET Core 3 框架揭秘》的基础上对后续作品进行修改。从收到的反馈意见来看,这一改变得到了读者的认可,所以《ASP.NET Core 6 框架揭秘》沿用了这样的写作方式。 本书的写作风格可以概括为“体验先行、设计贯通、应用扩展”12 个字。大部分章节开头都会提供一些简单的演示实例,旨在让读者对 ASP.NET Core 的基本功能特性和编程模式有一个大致的了解。在此之后,我会提供背后的故事,即编程模型的设计和原理。将开头实例和架构设计融会贯通之后,读者基本上能够将学到的知识正确地应用到事件中,对应章节对此会提供一些最佳实践。秉承“对扩展开放,对改变关闭”的“开闭原则”,每个功能模块都提供了相应的扩展点,能够精准地找到并运用适合的扩展来解决真实项目开发中的问题才是终极的目标,对应章节会介绍可用的扩展点,并提供一些解决方案和演示实例。 本书综合运用“文字”“图表”“编程”这 3 种不同的“语言”来介绍每个技术主题。一图胜千言,每章都精心设计了很多图表,这些具象的图表能够帮助读者理解技术模块的总体设计、执行流程和交互方式。除了利用编程语言描述应用编程接口(API),本书还提供了 200 多个实例,这些实例具有不同的作用,有的是为了演示某个实用的编程技巧或者最佳实践,有的是为了强调一些容易忽视但很重要的技术细节,有的是为了探测和证明所述的论点。 本书在很多地方展示了一些类型的代码,但是绝大部分代码和真正的源代码是有差异的,两者的差异有以下几个原因:第一,源代码在版本更替中一直在发生改变;第二,由于篇幅的限制,删除了一些细枝末节的代码,如针对参数的验证、诊断日志的输出和异常处理等;第三,很多源代码其实都具有优化的空间。本书提供的代码片段旨在揭示设计原理和实现逻辑,不是为了向读者展示源代码。 目标读者 虽然本书关注的是 ASP.NET Core 自身框架提供的请求处理管道,而不是具体某个应用编程框架,但是本书适合大多数 .NET 技术从业人员阅读。任何好的设计都应该是简单的,唯有简单的设计才能应对后续版本更替中出现的复杂问题。ASP.NET Core 框架就是好的设计,因为自正式推出的那一刻起,该框架的总体设计基本上没有发生改变。既然设计是简单的,对大部分从业人员来说,对框架的学习也就没有什么门槛。本书采用渐进式的写作方式,对于完全没有接触过 ASP.NET Core 的开发人员也可以通过学习本书内容深入、系统地掌握这门技术。由于本书提供的大部分内容都是独一无二的,即使是资深的 .NET 开发人员,也能在书中找到很多不甚了解的盲点。
第 1 篇 初识编程 第 1 章 编程体验 ........................................................................................................................... 2 1.1 控制台程序 ........................................................................................................................ 2 1.1.1 构建开发环境 ........................................................................................................ 2 1.1.2 命令行构建 .NET 应用 ......................................................................................... 3 1.2 ASP.NET 应用 .................................................................................................................... 8 1.2.1 launchSettings.json ................................................................................................. 8 1.2.2 Minimal API ......................................................................................................... 11 1.2.3 中间件 ................................................................................................................. 13 1.2.4 配置选项 .............................................................................................................. 17 1.2.5 诊断日志 .............................................................................................................. 19 1.2.6 路由 ..................................................................................................................... 20 1.3 MVC ................................................................................................................................ 21 1.3.1 定义 Controller ..................................................................................................... 21 1.3.2 引入视图 .............................................................................................................. 22 1.4 gRPC ................................................................................................................................ 24 1.4.1 定义服务 .............................................................................................................. 24 1.4.2 实现和承载 .......................................................................................................... 26 1.4.3 调用服务 .............................................................................................................. 28 1.5 Dapr.................................................................................................................................. 29 1.5.1 构建开发环境 ...................................................................................................... 29 1.5.2 服务调用 .............................................................................................................. 30 1.5.3 状态管理 .............................................................................................................. 34 1.5.4 发布订阅 .............................................................................................................. 38 1.5.5 Actor 模型 ............................................................................................................ 40 第 2 篇 基础框架 第 2 章 依赖注入(上) ............................................................................................................. 44 2.1 控制反转 .......................................................................................................................... 44 2.1.1 流程控制的反转 .................................................................................................. 44 2.1.2 好莱坞法则 .......................................................................................................... 47 2.1.3 流程定制 .............................................................................................................. 47 2.2 IoC 模式 ........................................................................................................................... 48 2.2.1 模板方法 .............................................................................................................. 48 2.2.2 工厂方法 .............................................................................................................. 49 2.2.3 抽象工厂 .............................................................................................................. 51 2.3 依赖注入 .......................................................................................................................... 53 2.3.1 由容器提供对象 .................................................................................................. 53 2.3.2 3 种注入方式 ....................................................................................................... 55 2.3.3 Service Locator 模式 ............................................................................................ 57 2.4 一个简易版的依赖注入容器 ............................................................................................ 59 2.4.1 编程体验 .............................................................................................................. 59 2.4.2 设计与实现 .......................................................................................................... 63 2.4.3 扩展方法 .............................................................................................................. 69 第 3 章 依赖注入(下) ............................................................................................................. 73 3.1 利用容器提供服务 ........................................................................................................... 73 3.1.1 服务的注册与消费 ............................................................................................... 73 3.1.2 生命周期 .............................................................................................................. 76 3.1.3 服务注册的验证 .................................................................................................. 79 3.2 服务注册 .......................................................................................................................... 82 3.2.1 ServiceDescriptor .................................................................................................. 82 3.2.2 IServiceCollection ................................................................................................. 83 3.3 服务的消费 ...................................................................................................................... 87 3.3.1 IServiceProvider ................................................................................................... 87 3.3.2 服务实例的创建 .................................................................................................. 89 3.3.3 生命周期 .............................................................................................................. 91 3.3.4 ActivatorUtilities .................................................................................................. 96 3.4 扩展................................................................................................................................ 101 3.4.1 适配 ................................................................................................................... 101 3.4.2 IServiceProviderFactory<TContainerBuilder> ..................................................... 102 3.4.3 整合第三方依赖注入框架 ................................................................................. 102 第 4 章 文件系统 ....................................................................................................................... 107 4.1 抽象的文件系统 ............................................................................................................. 107 4.1.1 树形层次结构 .................................................................................................... 107 4.1.2 读取文件内容 .................................................................................................... 109 4.1.3 监控文件的变化 ................................................................................................ 111 4.2 文件与目录 .................................................................................................................... 112 4.2.1 IChangeToken ..................................................................................................... 113 4.2.2 IFileProvider ....................................................................................................... 114 4.2.3 两个特殊的文件系统 ......................................................................................... 116 4.3 物理文件系统 ................................................................................................................ 119 4.3.1 PhysicalFileInfo .................................................................................................. 119 4.3.2 PhysicalDirectoryInfo ......................................................................................... 120 4.3.3 PhysicalDirectoryContents .................................................................................. 120 4.3.4 NotFoundDirectoryContents ............................................................................... 121 4.3.5 PhysicalFilesWatcher .......................................................................................... 121 4.4 内嵌文件系统 ................................................................................................................ 123 4.4.1 将项目文件变成内嵌资源 ................................................................................. 123 4.4.2 读取资源文件 .................................................................................................... 124 4.4.3 EmbeddedFileProvider ........................................................................................ 125 第 5 章 配置选项(上) ........................................................................................................... 128 5.1 读取配置信息 ................................................................................................................ 128 5.1.1 编程模型三要素 ................................................................................................ 128 5.1.2 以“键-值”对的形式读取配置 ........................................................................ 129 5.1.3 读取结构化的配置 ............................................................................................ 130 5.1.4 将结构化配置直接绑定为对象 .......................................................................... 133 5.1.5 将配置定义在文件中 ......................................................................................... 133 5.1.6 根据环境动态加载配置文件 ............................................................................. 134 5.1.7 配置内容的同步 ................................................................................................ 136 5.2 配置模型 ........................................................................................................................ 137 5.2.1 数据结构及其转换 ............................................................................................. 137 5.2.2 IConfiguration .................................................................................................... 138 5.2.3 IConfigurationProvider ....................................................................................... 140 5.2.4 IConfigurationSource .......................................................................................... 142 5.2.5 IConfigurationBuilder ......................................................................................... 143 5.2.6 ConfigurationManager ........................................................................................ 143 5.3 配置绑定 ........................................................................................................................ 144 5.3.1 绑定配置项的值 ................................................................................................ 145 5.3.2 绑定复合对象 .................................................................................................... 147 5.3.3 绑定集合 ............................................................................................................ 149 5.3.4 绑定字典 ............................................................................................................ 151 5.4 配置的同步 .................................................................................................................... 152 5.4.1 配置数据流 ........................................................................................................ 152 5.4.2 ConfigurationReloadToken .................................................................................. 153 5.4.3 ConfigurationRoot .............................................................................................. 153 5.4.4 ConfigurationSection .......................................................................................... 156 5.5 多样性的配置源 ............................................................................................................. 157 5.5.1 MemoryConfigurationSource .............................................................................. 157 5.5.2 EnvironmentVariablesConfigurationSource ......................................................... 158 5.5.3 CommandLineConfigurationSource .................................................................... 160 5.5.4 FileConfigurationSource ..................................................................................... 163 5.5.5 StreamConfigurationSource ................................................................................ 173 5.5.6 ChainedConfigurationSource ............................................................................... 175 第 6 章 配置选项(下) ........................................................................................................... 177 6.1 Options 模式 ................................................................................................................... 177 6.1.1 将配置绑定为 Options 对象 ............................................................................... 177 6.1.2 提供具名的 Options ........................................................................................... 179 6.1.3 配置源的同步 .................................................................................................... 180 6.1.4 直接初始化 Options 对象 ................................................................................... 182 6.1.5 根据依赖服务的 Options 设置 ........................................................................... 184 6.1.6 验证 Options 的有效性 ...................................................................................... 186 6.2 Options 模型 ................................................................................................................... 187 6.2.1 OptionsManager<TOptions> ............................................................................... 187 6.2.2 IOptionsFactory<TOptions> ............................................................................... 189 6.2.3 IOptionsMonitorCache<TOptions> ..................................................................... 197 6.2.4 IOptionsMonitor<TOptions> ............................................................................... 198 6.3 依赖注入 ........................................................................................................................ 200 6.3.1 服务注册 ............................................................................................................ 200 6.3.2 IOptions<TOptions>与 IOptionsSnapshot<TOptions> ......................................... 206 6.3.3 集成配置系统 .................................................................................................... 208 第 7 章 诊断日志(上) ........................................................................................................... 210 7.1 各种诊断日志形式 ......................................................................................................... 210 7.1.1 调试日志 ............................................................................................................ 210 7.1.2 跟踪日志 ............................................................................................................ 211 7.1.3 事件日志 ............................................................................................................ 213 7.1.4 诊断日志 ............................................................................................................ 216 7.2 Debugger 调试日志 ........................................................................................................ 219 7.2.1 Debugger ............................................................................................................ 220 7.2.2 Debug ................................................................................................................. 221 7.3 TraceSource 跟踪日志 .................................................................................................... 222 7.3.1 跟踪日志模型三要素 ......................................................................................... 222 7.3.2 预定义 TraceListener .......................................................................................... 231 7.3.3 Trace .................................................................................................................. 235 7.4 EventSource 事件日志 .................................................................................................... 237 7.4.1 EventSource ....................................................................................................... 237 7.4.2 EventListener ...................................................................................................... 243 7.4.3 活动跟踪 ............................................................................................................ 247 7.5 DiagnosticSource 诊断日志 ............................................................................................ 251 7.5.1 标准的观察者模式 ............................................................................................ 251 7.5.2 AnonymousObserver<T> .................................................................................... 253 7.5.3 强类型的日志事件订阅 ..................................................................................... 256 7.5.4 针对活动的跟踪 ................................................................................................ 258 第 8 章 诊断日志(中) ........................................................................................................... 260 8.1 统一日志编程模式 ......................................................................................................... 260 8.1.1 日志输出 ............................................................................................................ 260 8.1.2 日志过滤 ............................................................................................................ 265 8.1.3 日志范围 ............................................................................................................ 271 8.1.4 LoggerMessage ................................................................................................... 273 8.2 日志模型详解 ................................................................................................................ 274 8.2.1 日志模型三要素 ................................................................................................ 274 8.2.2 ILogger ............................................................................................................... 275 8.2.3 ILoggerProvider .................................................................................................. 277 8.2.4 ILoggerFactory ................................................................................................... 277 8.2.5 LoggerMessage ................................................................................................... 281 8.3 日志范围 ........................................................................................................................ 283 8.3.1 调用链跟踪 ........................................................................................................ 283 8.3.2 服务范围堆栈 .................................................................................................... 294 8.3.3 Activity 的应用 .................................................................................................. 296 8.4 依赖注入 ........................................................................................................................ 297 8.4.1 核心服务 ............................................................................................................ 298 8.4.2 配置 ................................................................................................................... 300 8.4.3 日志过滤规则 .................................................................................................... 303 第 9 章 诊断日志(下) ........................................................................................................... 306 9.1 控制台 ............................................................................................................................ 306 9.1.1 ConsoleFormatter ................................................................................................ 306 9.1.2 ConsoleLogger .................................................................................................... 313 9.1.3 ConsoleLoggerProvider ....................................................................................... 315 9.1.4 服务注册 ............................................................................................................ 316 9.2 调试器 ............................................................................................................................ 321 9.2.1 DebugLogger ...................................................................................................... 322 9.2.2 DebugLoggerProvider ......................................................................................... 323 9.3 TraceSource 日志 ............................................................................................................ 323 9.3.1 TraceSourceLogger ............................................................................................. 323 9.3.2 TraceSourceLoggerProvider ................................................................................ 325 9.4 EventSource 日志 ........................................................................................................... 327 9.4.1 LoggingEventSource ........................................................................................... 327 9.4.2 EventSourceLogger............................................................................................. 328 9.4.3 EventSourceLoggerProvider ............................................................................... 332 9.4.4 日志范围 ............................................................................................................ 334 第 10 章 对象池 ......................................................................................................................... 338 10.1 利用对象池复用对象 ................................................................................................... 338 10.1.1 对象的“借”与“还” ................................................................................... 338 10.1.2 依赖注入 .......................................................................................................... 340 10.1.3 池化对象策略 .................................................................................................. 340 10.1.4 对象池的大小 .................................................................................................. 341 10.1.5 对象的释放 ...................................................................................................... 344 10.2 池化对象管理 .............................................................................................................. 345 10.2.1 IPooledObjectPolicy<T> ................................................................................... 345 10.2.2 ObjectPool<T> ................................................................................................. 346 10.2.3 ObjectPoolProvider ........................................................................................... 351 10.3 扩展应用 ...................................................................................................................... 352 10.3.1 池化集合 .......................................................................................................... 352 10.3.2 池化 StringBuilder ............................................................................................ 354 10.3.3 ArrayPool<T> ................................................................................................... 356 10.3.4 MemoryPool<T> .............................................................................................. 357 第 11 章 缓存 ............................................................................................................................. 359 11.1 将数据缓存起来 ........................................................................................................... 359 11.1.1 将数据缓存在内存中 ....................................................................................... 359 11.1.2 将数据缓存在 Redis 中 .................................................................................... 360 11.1.3 将数据缓存在 SQL Server 中 ........................................................................... 363 11.2 本地内存缓存 ............................................................................................................... 365 11.2.1 ICacheEntry ...................................................................................................... 365 11.2.2 MemoryCacheEntryOptions .............................................................................. 368 11.2.3 IMemoryCache ................................................................................................. 369 11.3 分布式缓存 .................................................................................................................. 378 11.3.1 IDistributedCache ............................................................................................. 378 11.3.2 Redis 缓存 ........................................................................................................ 379 11.3.3 SQL Server 缓存 ............................................................................................... 382 第 12 章 HTTP 调用 ................................................................................................................. 385 12.1 HttpClient 的工厂 ......................................................................................................... 385 12.1.1 手动创建 HttpClient ......................................................................................... 385 12.1.2 使用 IHttpClientFactory 工厂 ........................................................................... 387 12.1.3 直接注入 HttpClient ......................................................................................... 387 12.1.4 定制 HttpClient................................................................................................. 388 12.1.5 强类型客户端 .................................................................................................. 389 12.1.6 失败重试 .......................................................................................................... 390 12.2 HttpMessageHandler 管道 ............................................................................................. 391 12.2.1 HttpMessageHandler ......................................................................................... 391 12.2.2 DelegatingHandler ............................................................................................ 392 12.2.3 诊断日志 .......................................................................................................... 396 12.2.4 复用 HttpClientHandler .................................................................................... 398 12.3 HttpClient 的构建 ......................................................................................................... 400 12.3.1 HttpMessageHandlerBuilder ............................................................................. 400 12.3.2 HttpClientFactoryOptions ................................................................................. 401 12.3.3 IHttpMessageHandlerBuilderFilter .................................................................... 407 12.3.4 IHttpClientFactory ............................................................................................ 408 12.4 依赖注入 ...................................................................................................................... 418 12.4.1 基础服务注册 .................................................................................................. 418 12.4.2 定制 HttpClient................................................................................................. 420 12.4.3 强类型客户端 .................................................................................................. 424 第 13 章 数据保护 ..................................................................................................................... 430 13.1 加密与哈希 .................................................................................................................. 430 13.1.1 数据加密与解密............................................................................................... 430 13.1.2 设置加密内容的有效期 ................................................................................... 433 13.1.3 撤销密钥 .......................................................................................................... 434 13.1.4 “瞬时”加解密............................................................................................... 435 13.1.5 密码哈希 .......................................................................................................... 437 13.2 加密模型 ...................................................................................................................... 438 13.2.1 IAuthenticatedEncryptor ................................................................................... 438 13.2.2 IKey ................................................................................................................. 439 13.2.3 IKeyRing .......................................................................................................... 440 13.2.4 IKeyRingProvider ............................................................................................. 442 13.2.5 IDataProtector ................................................................................................... 443 13.3 密钥管理 ...................................................................................................................... 452 13.3.1 KeyManagementOptions ................................................................................... 452 13.3.2 Key ................................................................................................................... 457 13.3.3 IKeyManager .................................................................................................... 459 13.3.4 KeyRingProvider .............................................................................................. 465 13.4 依赖注入 ...................................................................................................................... 472 13.4.1 注册基础服务 .................................................................................................. 472 13.4.2 密钥管理配置 .................................................................................................. 477 13.4.3 扩展配置 .......................................................................................................... 478 附录 A ........................................................................................................................................... 482 第 3 篇 承载系统 第 14 章 服务承载 ..................................................................................................................... 488 14.1 服务承载 ...................................................................................................................... 488 14.1.1 性能指标收集服务 ........................................................................................... 488 14.1.2 依赖注入 .......................................................................................................... 490 14.1.3 配置选项 .......................................................................................................... 493 14.1.4 承载环境 .......................................................................................................... 496 14.1.5 日志 ................................................................................................................. 498 14.2 服务承载模型 .............................................................................................................. 500 14.2.1 IHostedService .................................................................................................. 500 14.2.2 IHost ................................................................................................................ 501 14.2.3 IHostBuilder ..................................................................................................... 506 14.3 服务承载流程 .............................................................................................................. 511 14.3.1 服务宿主 .......................................................................................................... 512 14.3.2 服务承载设置 .................................................................................................. 516 14.3.3 创建宿主 .......................................................................................................... 521 14.3.4 静态类型 Host .................................................................................................. 527 第 15 章 应用承载(上) ......................................................................................................... 531 15.1 管道式的请求处理 ....................................................................................................... 531 15.1.1 承载方式的变迁 .............................................................................................. 531 15.1.2 中间件.............................................................................................................. 536 15.1.3 定义强类型中间件 ........................................................................................... 539 15.1.4 按照约定定义中间件 ....................................................................................... 540 15.2 依赖注入 ...................................................................................................................... 542 15.2.1 服务注册 .......................................................................................................... 542 15.2.2 服务注入 .......................................................................................................... 544 15.2.3 生命周期 .......................................................................................................... 546 15.3 配置 .............................................................................................................................. 551 15.3.1 初始化配置 ...................................................................................................... 551 15.3.2 以“键-值”对形式读取和修改配置 ............................................................... 552 15.3.3 注册配置源 ...................................................................................................... 553 15.4 承载环境 ...................................................................................................................... 554 15.4.1 IWebHostEnvironment ...................................................................................... 554 15.4.2 通过配置定制承载环境 ................................................................................... 556 15.4.3 设置监听地址 .................................................................................................. 559 15.4.4 针对环境的编程............................................................................................... 560 第 16 章 应用承载(中) ......................................................................................................... 564 16.1 中间件委托链 ............................................................................................................... 564 16.1.1 HttpContext ...................................................................................................... 564 16.1.2 中间件 .............................................................................................................. 565 16.1.3 中间件管道的构建 ........................................................................................... 566 16.2 服务器 .......................................................................................................................... 567 16.2.1 IServer .............................................................................................................. 568 16.2.2 针对服务器的适配 ........................................................................................... 568 16.2.3 HttpListenerServer ............................................................................................ 570 16.3 承载服务 ...................................................................................................................... 573 16.3.1 WebHostedService ............................................................................................ 573 16.3.2 WebHostBuilder ................................................................................................ 573 16.3.3 应用构建 .......................................................................................................... 575 第 17 章 应用承载(下) ......................................................................................................... 577 17.1 共享上下文对象 ........................................................................................................... 577 17.1.1 HttpContext ...................................................................................................... 577 17.1.2 服务器适配 ...................................................................................................... 580 17.1.3 获取上下文对象 .............................................................................................. 583 17.1.4 上下文对象的创建与释放 ............................................................................... 584 17.1.5 RequestServices ................................................................................................ 585 17.2 IServer + IHttpApplication ............................................................................................ 587 17.2.1 IServer .............................................................................................................. 588 17.2.2 HostingApplication ........................................................................................... 588 17.2.3 诊断日志 .......................................................................................................... 591 17.3 中间件委托链 .............................................................................................................. 596 17.3.1 IApplicationBuilder .......................................................................................... 596 17.3.2 弱类型中间件 .................................................................................................. 599 17.3.3 强类型中间件 .................................................................................................. 602 17.3.4 注册中间件 ...................................................................................................... 604 17.4 应用的承载 .................................................................................................................. 604 17.4.1 GenericWebHostServiceOptions ........................................................................ 604 17.4.2 GenericWebHostService .................................................................................... 607 17.4.3 GenericWebHostBuilder .................................................................................... 609 17.4.4 ConfigureWebHostDefaults ............................................................................... 617 17.5 Minimal API ................................................................................................................. 619 17.5.1 WebApplication ................................................................................................ 620 17.5.2 WebApplication 的创建 .................................................................................... 622 17.5.3 工厂方法 .......................................................................................................... 631 第 4 篇 服务器概述 第 18 章 服务器 ......................................................................................................................... 634 18.1 自定义服务器 .............................................................................................................. 634 18.1.1 IServer .............................................................................................................. 634 18.1.2 请求和响应特性 .............................................................................................. 637 18.1.3 StreamBodyFeature ........................................................................................... 638 18.1.4 HttpListenerServer ............................................................................................ 638 18.2 KestrelServer ................................................................................................................ 642 18.2.1 注册终节点 ...................................................................................................... 642 18.2.2 限制约束 .......................................................................................................... 652 18.2.3 其他设置 .......................................................................................................... 655 18.2.4 设计与实现 ...................................................................................................... 655 18.3 HTTP.SYS .................................................................................................................... 668 18.3.1 HTTP.SYS 简介 ................................................................................................ 668 18.3.2 UseHttpSys ....................................................................................................... 669 18.3.3 HttpSysOptions ................................................................................................. 669 18.4 IIS ................................................................................................................................. 672 18.4.1 ASP.NET Core Module ..................................................................................... 672 18.4.2 In-Process 部署模式 ......................................................................................... 672 18.4.3 Out-of-Process 部署模式 .................................................................................. 675 18.4.4 <aspnetcore>配置 ............................................................................................. 678 第 5 篇 中间件 第 19 章 静态文件 ..................................................................................................................... 682 19.1 搭建文件服务器 ........................................................................................................... 682 19.1.1 发布物理文件 .................................................................................................. 682 19.1.2 呈现目录结构 .................................................................................................. 684 19.1.3 显示默认页面 .................................................................................................. 685 19.1.4 映射媒体类型 .................................................................................................. 688 19.2 处理文件请求 ............................................................................................................... 690 19.2.1 条件请求 .......................................................................................................... 690 19.2.2 区间请求 .......................................................................................................... 694 19.2.3 StaticFileMiddleware ........................................................................................ 696 19.3 处理目录请求 ............................................................................................................... 700 19.3.1 DirectoryBrowserMiddleware ........................................................................... 700 19.3.2 DefaultFilesMiddleware .................................................................................... 704 第 20 章 路由 ............................................................................................................................. 708 20.1 路由映射 ...................................................................................................................... 708 20.1.1 注册终节点 ...................................................................................................... 708 20.1.2 设置内联约束 .................................................................................................. 711 20.1.3 可缺省路由参数............................................................................................... 712 20.1.4 特殊的路由参数............................................................................................... 713 20.1.5 主机名绑定 ...................................................................................................... 715 20.1.6 更加自由的定义方式 ....................................................................................... 716 20.2 路由分发 ...................................................................................................................... 717 20.2.1 路由模式 .......................................................................................................... 717 20.2.2 路由终节点 ...................................................................................................... 722 20.2.3 中间件.............................................................................................................. 730 20.2.4 处理器适配 ...................................................................................................... 737 20.2.5 Minimal API ..................................................................................................... 746 20.3 路由约束 ...................................................................................................................... 748 20.3.1 预定义的 IRouteConstraint ............................................................................... 749 20.3.2 IInlineConstraintResolver .................................................................................. 750 20.3.3 自定义约束 ...................................................................................................... 750 第 21 章 异常处理 ..................................................................................................................... 753 21.1 呈现错误信息 .............................................................................................................. 753 21.1.1 开发者异常页面 .............................................................................................. 753 21.1.2 定制异常页面 .................................................................................................. 756 21.1.3 针对响应状态码定制错误页面 ........................................................................ 757 21.2 开发者异常页面 ........................................................................................................... 759 21.2.1 IDeveloperPageExceptionFilter ......................................................................... 759 21.2.2 显示编译异常信息 ........................................................................................... 760 21.2.3 DeveloperExceptionPageMiddleware ................................................................ 764 21.3 异常处理器 .................................................................................................................. 766 21.3.1 ExceptionHandlerMiddleware ........................................................................... 766 21.3.2 IExceptionHandlerPathFeature 特性 ................................................................. 768 21.3.3 清除缓存 .......................................................................................................... 771 21.3.4 404 响应 ........................................................................................................... 772 21.4 响应状态码页面 ........................................................................................................... 774 21.4.1 StatusCodePagesMiddleware............................................................................. 774 21.4.2 阻止处理异常 .................................................................................................. 775 21.4.3 注册中间件 ...................................................................................................... 777 第 22 章 响应缓存 ..................................................................................................................... 783 22.1 缓存响应内容 .............................................................................................................. 783 22.1.1 基于路径的响应缓存 ....................................................................................... 783 22.1.2 引入其他缓存维度 ........................................................................................... 785 22.1.3 缓存屏蔽 .......................................................................................................... 790 22.2 HTTP-Cache ................................................................................................................. 791 22.2.1 私有缓存和共享缓存 ....................................................................................... 792 22.2.2 响应的提取 ...................................................................................................... 792 22.2.3 新鲜度检验 ...................................................................................................... 793 22.2.4 显式缓存控制 .................................................................................................. 794 22.3 中间件 .......................................................................................................................... 795 22.3.1 缓存上下文对象............................................................................................... 795 22.3.2 缓存策略 .......................................................................................................... 796 22.3.3 缓存键 .............................................................................................................. 797 22.3.4 缓存的读/写 ..................................................................................................... 798 22.3.5 ResponseCachingMiddleware ............................................................................ 799 22.3.6 注册中间件 ...................................................................................................... 801 第 23 章 会话 ............................................................................................................................. 803 23.1 利用会话保留“语境” ............................................................................................... 803 23.1.1 设置和提取会话状态 ....................................................................................... 803 23.1.2 查看存储的会话状态 ....................................................................................... 805 23.1.3 查看 Cookie ...................................................................................................... 807 23.2 会话状态的读/写 .......................................................................................................... 807 23.2.1 ISession ............................................................................................................ 808 23.2.2 DistributedSession ............................................................................................ 809 23.2.3 ISessionStore .................................................................................................... 810 23.3 会话中间件 .................................................................................................................. 811 23.3.1 SessionOptions ................................................................................................. 811 23.3.2 ISessionFeature ................................................................................................. 812 23.3.3 SessionMiddleware ........................................................................................... 812 第 24 章 HTTPS 策略 ............................................................................................................... 815 24.1 HTTPS 终节点的切换 .................................................................................................. 815 24.1.1 构建 HTTPS 站点 ............................................................................................ 815 24.1.2 HTTPS 重定向 ................................................................................................. 818 24.1.3 浏览器自动重定向 ........................................................................................... 819 24.1.4 HSTS 选项配置 ................................................................................................ 821 24.2 HTTPS 重定向 ............................................................................................................. 823 24.2.1 HttpsRedirectionOptions ................................................................................... 823 24.2.2 HttpsRedirectionMiddleware 中间件 ................................................................ 824 24.2.3 中间件注册 ...................................................................................................... 826 24.3 HSTS ............................................................................................................................ 827 24.3.1 HstsOptions ...................................................................................................... 827 24.3.2 HstsMiddleware 中间件 .................................................................................... 828 24.3.3 中间件注册 ...................................................................................................... 829 第 25 章 重定向 ......................................................................................................................... 830 25.1 基于规则的重定向 ....................................................................................................... 830 25.1.1 客户端重定向 .................................................................................................. 830 25.1.2 服务端重定向 .................................................................................................. 831 25.1.3 IIS 重写规则 .................................................................................................... 832 25.1.4 Apache 重写规则 ............................................................................................ 834 25.1.5 HTTPS 重定向 ................................................................................................. 836 25.2 重定向中间件 .............................................................................................................. 838 25.2.1 重定向规则 ...................................................................................................... 838 25.2.2 RewriteMiddleware ........................................................................................... 839 25.3 预定义规则 .................................................................................................................. 841 25.3.1 “万能”规则 .................................................................................................. 841 25.3.2 客户端重定向 .................................................................................................. 842 25.3.3 服务端重定向 .................................................................................................. 843 25.3.4 WWW 重定向 .................................................................................................. 843 25.3.5 HTTPS 重定向 ................................................................................................. 845 25.3.6 IIS 重写规则 .................................................................................................... 846 25.3.7 Apache 重写规则 ............................................................................................. 848 第 26 章 限流............................................................................................................................. 850 26.1 控制并发量 .................................................................................................................. 850 26.1.1 设置并发和等待请求阈值 ............................................................................... 850 26.1.2 初识基于队列的处理策略 ............................................................................... 853 26.1.3 初识基于栈的处理策略 ................................................................................... 855 26.2 并发限制中间件 ........................................................................................................... 856 26.2.1 等待队列策略 .................................................................................................. 856 26.2.2 ConcurrencyLimiterMiddleware ........................................................................ 856 26.2.3 处理拒绝请求 .................................................................................................. 858 26.3 等待队列策略 ............................................................................................................... 859 26.3.1 基于队列的处理策略 ....................................................................................... 859 26.3.2 基于栈的处理策略 ........................................................................................... 861 第 27 章 认证 ............................................................................................................................. 867 27.1 认证、登录与注销 ....................................................................................................... 867 27.1.1 认证票据 .......................................................................................................... 867 27.1.2 基于 Cookie 的认证 ......................................................................................... 868 27.1.3 强制认证 .......................................................................................................... 871 27.1.4 登录与注销 ...................................................................................................... 871 27.2 身份与用户 .................................................................................................................. 872 27.2.1 IIdentity ............................................................................................................ 872 27.2.2 IPrincipal .......................................................................................................... 877 27.3 认证模型 ...................................................................................................................... 880 27.3.1 认证票据详细介绍 ........................................................................................... 880 27.3.2 认证处理器 ...................................................................................................... 883 27.3.3 认证服务 .......................................................................................................... 889 27.3.4 服务注册 .......................................................................................................... 893 27.3.5 AuthenticationMiddleware ................................................................................ 896 27.4 Cookie 认证方案 .......................................................................................................... 898 27.4.1 AuthenticationHandler<TOptions> .................................................................... 898 27.4.2 CookieAuthenticationHandler ........................................................................... 903 27.4.3 注册 CookieAuthenticationHandler ................................................................... 912 第 28 章 授权 ............................................................................................................................. 915 28.1 基于“角色”的授权 ................................................................................................... 915 28.1.1 基于“要求”的授权 ....................................................................................... 915 28.1.2 预定义授权策略............................................................................................... 919 28.1.3 基于终节点的自动化授权 ............................................................................... 921 28.2 基于“要求”的授权 ................................................................................................... 922 28.2.1 IAuthorizationHandler ...................................................................................... 922 28.2.2 预定义授权处理器 ........................................................................................... 924 28.2.3 授权检验 .......................................................................................................... 928 28.3 基于“策略”的授权 ................................................................................................... 933 28.3.1 授权策略的构建 .............................................................................................. 934 28.3.2 授权策略的注册 .............................................................................................. 935 28.3.3 授权检验 .......................................................................................................... 936 28.4 授权与路由 .................................................................................................................. 937 28.4.1 IAuthorizeData ................................................................................................. 937 28.4.2 IAllowAnonymous ............................................................................................ 939 28.4.3 IPolicyEvaluator ............................................................................................... 940 28.4.4 IAuthorizationMiddlewareResultHandler .......................................................... 943 28.4.5 AuthorizationMiddleware .................................................................................. 944 第 29 章 跨域资源共享 ............................................................................................................. 947 29.1 处理跨域资源 .............................................................................................................. 947 29.1.1 跨域调用 API ................................................................................................... 947 29.1.2 提供者显式授权 .............................................................................................. 950 29.1.3 基于策略的资源授权 ....................................................................................... 951 29.1.4 将 CORS 策略应用到路由上 ........................................................................... 952 29.2 CORS 规范 ................................................................................................................... 953 29.2.1 同源策略 .......................................................................................................... 953 29.2.2 针对资源的授权 .............................................................................................. 954 29.2.3 获取授权的方式 .............................................................................................. 955 29.2.4 用户凭证 .......................................................................................................... 958 29.3 CORS 中间件 ............................................................................................................... 958 29.3.1 CORS 策略 ...................................................................................................... 958 29.3.2 CORS 与路由 ................................................................................................... 961 29.3.3 CORS 授权 ...................................................................................................... 962 29.3.4 CorsMiddleware ............................................................................................... 964 第 30 章 健康检查 ..................................................................................................................... 968 30.1 检查应用的健康状况 ................................................................................................... 968 30.1.1 确定当前应用是否可用 ................................................................................... 968 30.1.2 定制健康检查逻辑 ........................................................................................... 969 30.1.3 改变响应状态码............................................................................................... 970 30.1.4 细粒度的健康检查 ........................................................................................... 972 30.1.5 定制响应内容 .................................................................................................. 973 30.1.6 过滤 IHealthCheck 对象 ................................................................................... 975 30.2 设计与实现 .................................................................................................................. 975 30.2.1 IHealthCheck .................................................................................................... 976 30.2.2 HealthCheckService .......................................................................................... 981 30.2.3 HealthCheckMiddleware ................................................................................... 984 30.3 发布健康报告 ............................................................................................................... 989 30.3.1 定期发布健康报告 ........................................................................................... 989 30.3.2 IHealthCheckPublisher ...................................................................................... 990 30.3.3 HealthCheckPublisherHostedService ................................................................. 991