ASP.NET Core 中的 Request Feature

ASP.NET Core 中的 Request Feature

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/request-features?view=aspnetcore-6.0

在应用程序对象和中间件中所用来处理请求的 HttpContext API 有一个被称为 feature 接口 的底层抽象。每个 feature 提供器提供一个通过 HttpContext 暴露出来的小粒度功能子集。这样在不需要重新整个实现 HttpContext 的情况下处理入站请求，而这些接口可以被服务器或者中间件添加、修改、封装、替换，或者甚至被删除掉。当测试的时候，它们还可以被用来 mock 功能。

Feature 集合

HttpContext 的 Features 属性提供了针对当前请求访问这些 feature 接口的入口。由于该特性集是可变的，甚至是在请求处理过程中，中间件可以用来修改该特性集，并添加其它的特性。有些高级的 feature 只能通过特性集的接口来访问。

集合的类型是 IFeatureCollection，它的实现类型是 FeatureCollection。通过定义可以看到，该集合实际上是 一个字典集合，字典的 key 为类型 Type，在这里并没有统一的 IFeature 接口。

Feature 接口

在 Microsoft.AspNetCore.Http.Features 中，ASP.NET Core 定义了一系列的常用 HTTP 特性接口，它们被各种中间件和服务器所共享，用于它们所支持的特性。服务器和中间件也可以提供它们自己的接口来支持附加的功能。

大多数的特性接口提供可选的亮点功能，它们所关联的 HttpContext API 则提供当没有提供特性时的默认功能。下面所列出的一些特性接口被标记为必须的，因为它们提供核心的请求和响应功能，它们必须被实现以支持对请求的处理。

下面的接口来自 Microsoft.AspNetCore.Http.Features

1. IHttpRequestFeature: 定义 HTTP 请求结构，包括协议、路径、查询参数、请求头以及请求体。该特性是处理请求所必须的。

2. IHttpResponseFeature: 定义 HTTP 响应结构，包括状态码、响应头以及响应体。该特性是处理请求所必须的。

3. IHttpResponseBodyFeature: 定义通过各种方式输出响应体，使用 Stream 或者 PipeWriter 或者文件。该特性是处理请求所必须的。它替换了 IHttpResponseFeature.Body 和 IHttpSendFileFeature

4. IHttpAuthenticationFeature: 持有当前请求相关的 ClaimsPrincipal

5. IFormFeature: 用于解析和缓存入站的 HTTP 请求和提交的 multipart 表单。

6. IHttpBodyControlFeature: 用来控制对于请求或者响应是否允许同步 IO 操作。

7. IHttpActivityFeature: 用来为 diagnostic 监听器添加 Activity 信息。注意它出现在 .NET 6 中。

8. IHttpConnectionFeature: 定义网络连接的 id 属性，本地与远程地址和端口。

9. IHttpMaxRequestBodySizeFeature: 控制对于当前请求来说，最大可支持的请求体大小。

10. IHttpRequestBodyDetectionFeature: 识别当前请求是否含有请求体。从 .NET 5 开始支持。

11. IHttpRequestIdentifierFeature: 添加可以用来唯一标识请求的属性。

12. IHttpRequestLifetimeFeature: 定义支持中断网络连接，以及检测当前请求是否已经被提前终止。例如由于客户端断开连接。

13. IHttpRequestTrailersFeature: 提供访问请求的 trailer 头，如果存在的话。例如 HTTP/1.1 中的块化请求体，或者 HTTP/2 中的 Trailer 请求头。

14. IHttpResetFeature: 用来对于支持它们的协议，比如 HTTP/2 或者 HTTP/3 发送重置消息。

15. IHttpResponseTrailersFeature: 如果支持的话，为应用程序启用响应 trailer 头支持。

16. IHttpUpgradeFeature: 定义对于 HTTP Upgrade 的支持。如果服务器支持切换协议的话，它支持客户端指定其希望使用的协议。

17. IHttpWebSocketFeature: 定义支持 Web socket 的 API

18. IHttpsCompressionFeature: 控制在 HTTPS 连接上响应是否被压缩。

19. IItemsFeature: 为请求应用程序状态存储 Items 集合

20. IQueryFeature: 解析和缓存查询串

21. IRequestBodyPipeFeature: 将请求体表示为 PipeReader 形式

22. IRequestCookiesFeature: 解析和缓存请求中的 Cookie 请求头中的值

23. IResponseCookiesFeature: 控制如何应用到响应头的 Set-Cookie 来控制响应 Cookie

24. IServerVariablesFeature: 该特性提供访问服务器变量的功能，例如通过 IIS 服务器提供的变量。

25. IServiceProvidersFeature: 提供访问使用作用域服务的 IServiceProvider。与依赖注入相关

26. ISessionFeature: 对于支持的用户会话，定义了 ISessionFactory 和 ISession 抽象。ISessionFeature 是通过 SessionMiddleware 中间件 所实现的 ( 见：ASP.NET Core 中的会话 )

27. ITlsConnectionFeature: 定义提取客户端证书的 API

28. ITlsTokenBindingFeature: 定义操作 TLS 令牌绑定参数的 API

29. ITrackingConsentFeature: 用于查询、授予和撤销有关存储与网站活动和功能相关的用户信息的用户同意。

参考资料

• Kestrel Features
• IIS Features
• [对比 ASP.NET Core 中的 HttpContext.Features 与 HttpContext.Items](对比 ASP.NET Core 中的 HttpContext.Features 与 HttpContext.Items)